Spring Boot Actuator: метрики сервера Jersey

Когда модуль Micrometer micrometer-jersey2 находится на пути к классам, автоконфигурация позволяет обрабатывать запросы, обрабатываемые реализацией Jersey JAX-RS. Если для параметра management.metrics.web.server.request.autotime.enabled задано значение true, этот инструментарий выполняется для всех запросов. В качестве альтернативы, если установлено значение false, вы можете включить инструментарий, добавив @Timed к методу обработки запросов:

@Component
@Path("/api/people")
@Timed // 1
public class Endpoint {
    @GET
    @Timed(extraTags = { "region", "us-east-1" }) // 2
    @Timed(value = "all.people", longTask = true) // 3
    public List listPeople() { ... }
}

1 - Для класса ресурса, чтобы включить тайминги для каждого обработчика запросов в ресурсе.

2 - На метод, чтобы включить для отдельной конечной точки. В этом нет необходимости, если он есть в классе, но его можно использовать для дальнейшей настройки таймера для этой конкретной конечной точки.

3 - Для метода с longTask = true, чтобы включить таймер длинной задачи для метода. Таймеры с длинными задачами требуют отдельного имени метрики и могут быть сложены с помощью короткого таймера задач.

По умолчанию метрики создаются с именем http.server.requests. Имя можно настроить, установив свойство management.metrics.web.server.request.metric-name.

По умолчанию метрики сервера Jersey помечены следующей информацией:

Тег	Описание
exception	Простое имя класса любого исключения, которое было сгенерировано при обработке запроса.
method	Метод запроса (например, GET или POST)
outcome	Результат запроса на основе кода состояния ответа. 1xx - INFORMATIONAL, 2xx - SUCCESS, 3xx - REDIRECTION, 4xx CLIENT_ERROR и 5xx - SERVER_ERROR.
status	HTTP-код статуса ответа (например, 200 или 500)
uri	Если возможно, шаблон URI запроса до замены переменной (например, /api/person/{id})

Чтобы настроить теги, предоставьте @Bean, который реализует JerseyTagsProvider.

---

Читайте также:

• Spring Boot Actuator: метрики
• Spring Boot Actuator: поддерживаемые метрики
• Spring Boot Actuator: мониторинг и управление по HTTP