<dependency>
    <groupId>io.gitee.goslee</groupId>
    <artifactId>spring-boot-starter-simple-prometheus</artifactId>
    <version>1.0.1</version>
</dependency>

<dependency>
    <groupId>net.jodah</groupId>
    <artifactId>expiringmap</artifactId>
    <version>0.5.8</version>
    <optional>true</optional>
</dependency>

```yaml
# Мониторинг
sprometheus:
  default: "dingdung"
  dingdung:
    # Включение или отключение аномальных уведомлений
    enabled: true
    # Путь к пакетам трейса, которые должны быть включены
    includedTracePackage:
      - "com.gosling"
      - "com.mysql"
      - "java.sql.SQLException"
      - "java.net"
    # Уведомления в группе Дингдунг
    business:
      # Группа уведомлений для бизнеса 1 Дингдунг
      - url: "https://oapi.dingtalk.com/robot/send?access_token=3c36"
        code: ",200000,200001,200002,200003,"
        secret: "SEC9a6b2202a0b92847fd7098630d20b4"
    developer:
      # Группа уведомлений для разработчиков Дингдунг
      - url: "https://oapi.dingtalk.com/robot/send?access_token=3c36"
        code: ",500,"
        secret: "SEC9a6b2202a0b92847fd7098630d20b4"
```- Конфигурационные инструкции
```yaml
# Мониторинг
sprometheus:
  default: "feishu"
  feishu:
    # Включить уведомления об исключениях
    enabled: true
    # Необходимые пути для трассировки
    includedTracePackage:
      - "com.gosling"
      - "com.mysql"
      - "java.sql.SQLException"
      - "java.net"
    # Уведомления в группу Feishu
    business:
      # Группа бизнес-уведомлений Feishu
      - url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
        code: ",200000,200001,200002,200003,"
    developer:
      # Группа разработчиков Feishu
      - url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
        code: ",500,"
```- Конфигурационные инструкции
```yaml
# Мониторинг
sprometheus:
  default: "dingdung"
  dingdung:
    # Включение или отключение аномальных уведомлений
    enabled: true
    # Путь к пакетам трейса, которые должны быть включены
    includedTracePackage:
      - "com.gosling"
      - "com.mysql"
      - "java.sql.SQLException"
      - "java.net"
    # Уведомления в группе Дингдунг
    business:
      # Группа уведомлений для бизнеса 1 Дингдунг
      - url: "https://oapi.dingtalk.com/robot/send?access_token=3c36"
        code: ",200000,200001,200002,200003,"
        secret: "SEC9a6b2202a0b92847fd7098630d20b4"
    developer:
      # Группа уведомлений для разработчиков Дингдунг
      - url: "https://oapi.dingtalk.com/robot/send?access_token=3c36"
        code: ",500,"
        secret: "SEC9a6b2202a0b92847fd7098630d20b4"
```- Конфигурационные инструкции
```yaml
# Мониторинг
sprometheus:
  default: "feishu"
  feishu:
    # Включить уведомления об исключениях
    enabled: true
    # Необходимые пути для трассировки
    includedTracePackage:
      - "com.gosling"
      - "com.mysql"
      - "java.sql.SQLException"
      - "java.net"
    # Уведомления в группу Feishu
    business:
      # Группа бизнес-уведомлений Feishu
      - url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
        code: ",200000,200001,200002,200003,"
    developer:
      # Группа разработчиков Feishu
      - url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
        code: ",500,"
```- Конфигурационные инструкции
```yaml
# Мониторинг
sprometheus:
  default: "dingdung"
  dingdung:
    # Включение или отключение аномальных уведомлений
    enabled: true
    # Путь к пакетам трейса, которые должны быть включены
    includedTracePackage:
      - "com.gosling"
      - "com.mysql"
      - "java.sql.SQLException"
      - "java.net"
    # Уведомления в группе Дингдунг
    business:
      # Группа уведомлений для бизнеса 1 Дингдунг
      - url: "https://oapi.dingtalk.com/robot/send?access_token=3c36"
        code: ",200000,200001,200002,200003,"
        secret: "SEC9a6b2202a0b92847fd7098630d20b4"
    developer:
      # Группа уведомлений для разработчиков Дингдунг
      - url: "https://oapi.dingtalk.com/robot/send?access_token=3c36"
        code: ",500,"
        secret: "SEC9a6b2202a0b92847fd7098630d20b4"
```- Конфигурационные инструкции| Название                     | Тип параметра    | Описание                          | Обязательное |
|------------------------|---------|-----------------------------|------|
| default                | string  | Указание конфигурации по умолчанию для отправки                 | Да    |
| enabled                | boolean | Включение уведомлений об ошибках                    | Да    |
| included_trace_package | string  | Путь к пакету trace, который нужно включить               | Да    |
| url                    | string  | URL для бизнес-сообщений и сообщений разработчиков (webhook для Feishu или других) | Да    |
| code                   | string  | Бизнес-код                         | Да    |
| secret                 | string  | Секретный ключ подписи для DingTalk                         | Нет-обязательно для DingTalk    |

### 🍺Использование на уровне кода (несколько способов)

#### Способ 1:

```java
// Вставьте этот код в месте ошибки
SPrometheusUtil.insert("Тест ошибки", SPrometheusTitleEnum.OTHER);

// Вставьте этот код в месте ошибки
SPrometheusUtil.insert("Тест ошибки", SPrometheusTitleEnum.OTHER, JSONObject.toJSONString(req));

// Вставьте этот код в месте ошибки
Exp exp = new Exp();
exp.setMsg("test...уже получил событие");
exp.setUri("/admin/test1");
exp.setSendChannel(SendChannel.FEISHU);
exp.setAtAll(SConstants.YES);
exp.setReqData(JSONObject.toJSONString(req));
exp.setTitleEnum(SPrometheusTitleEnum.OTHER);
SPrometheusUtil.insert(exp);
```#### Способ 4:
```java
Exp exp = new Exp();
//...
exp.setMsg(originMsg);
// Если вы хотите сохранить исходный формат вашего сообщения без изменений
// Например, если вам нужно отправить таблицу Feishu, сообщение, написанное для документа Feishu или любой другой формат, который вы хотите сохранить, вы можете использовать этот способ
SPrometheusUtil.insertOrg(exp);
```> Описание класса Exp
```java
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Exp {
    @Msg(msg = "Классификация мониторинга")
    private SPrometheusTitleEnum titleEnum = SPrometheusTitleEnum.OTHER;
    @Msg(msg = "Адрес интерфейса")
    private String uri;
    @Msg(msg = "Сообщение об ошибке")
    private String msg = SConstants.DEFAULT_MSG;
    @Msg(msg = "Параметры запроса")
    private String reqData;
    @Msg(msg = "Уведомление всем @all")
    private Integer atAll = SConstants.NO;
    @Msg(msg = "Медиа для отправки 1:Feishu (по умолчанию) 2:DingTalk 3:Email")
    private String sendChannel = SendChannel.FEISHU;
}

throw new SPrometheusException(SPrometheusTitleEnum.OTHER, "Пользовательская информация отсутствует");

@SPrometheus(title = SPrometheusTitleEnum.OTHER, uri = "admin/test1", scene = Scene.BUSINESS)
public void test(String id) {
    if (StrUtil.isBlank(id)) {
        System.out.println("Основной ключ ID отсутствует");
        throw new NullPointerException("Основной ключ ID отсутствует");
    }
}

@PostMapping("/test/test")
@Operation(summary = "APP[Система управления рисками обратная связь инициирования платежа]")
public void prepayment(@Valid @RequestBody LoanOrderQueryVO vo) {
    if (1 == 1) {
        throw new PrometheusException("NullPointerException");
    }
}

Если вы хотите получить более полное уведомление, вы можете выбрать  
При глобальном перехвате исключений, аналогично отсутствию параметров запроса или некорректному методу запроса, исключения не попадают в аспектный мониторинг, поэтому требуется ручное настройка мониторинга ошибок (в будущем это будет автоматизировано)
```java
@ExceptionHandler(value = MissingServletRequestParameterException.class)
public BaseResult<?> missingServletRequestParameterExceptionHandler(HttpServletRequest request, MissingServletRequestParameterException ex) {
    log.error("Обработка глобальных ошибок: ошибка передачи параметров", ex);
    String message = String.format("Отсутствие параметров запроса: %s", ex.getParameterName());
    Exp exp = new Exp();
    exp.setUri(request.getRequestURI());
    exp.setMsg(message);
    exp.setReqData(getParams(request));
    exp.setTitleEnum(PrometheusTitleEnum.OTHER);
    PrometheusUtil.insert(repayReq);
    return BaseResult.error(message);
}
```### 🍐Структура фреймворка

![img.png](src/main/resources/static/img_1.png)

### 📖Планируемые задачи (TODO pmo)
- Улучшение уведомлений по электронной почте
- Улучшение уведомлений в DingTalk (завершено)
- Улучшение уведомлений в QQ
- Улучшение уведомлений в WeChat
- Улучшение мониторинга NACOS
- Улучшение уведомлений для конкретных пользователей

### ⭐Star simple-prometheus⭐

### ⚠Предоставление обратной связи по ошибкам или предложениям
1. Отправка issues на gitee

2. Сканируйте QR-код ниже, чтобы подписаться на официальный аккаунт, отправьте сообщение, и я немедленно отвечу
![img.png](src/main/resources/static/img.png)

Спасибо за вашу ценный звездочку O(∩_∩)O~~