nav-img
Evolution

Мониторинг в API Gateway

API Gateway собирает метрики шлюза и отправляет их в сервис Мониторинг, где можно самостоятельно настраивать необходимые дашборды и виджеты. Подробное описание и инструкции по настройке смотрите в руководстве пользователя по Мониторингу.

Просмотр графиков в сервисе Мониторинг

Чтобы перейти на дашборд API Gateway в сервисе Мониторинг:

  1. Нажмите Главное меню и выберите Мониторинг.

  2. Внизу страницы в списке Сервисные дашборды выберите API Gateway.

В дашборде API Gateway доступны следующие графики:

  • Общее среднее время выполнения запросов, мс — сумма среднего времени выполнения запросов к API-шлюзу и среднего времени выполнения запросов к бэкенду.

  • Среднее время выполнения запросов к API-шлюзу, мс — время, которое затратил шлюз на обработку запросов от клиента.

  • Среднее время выполнения запросов к бэкенду, мс — время, которое затратил бэкенд на обработку запросов от клиента.

  • Средний размер ответа, байт — размер ответа от бэкенда в байтах.

  • Средний размер запроса, байт — размер запроса от клиента в байтах.

  • Количество запросов к бэкенду в минуту — запросы от клиента к бэкенду в минуту.

  • Количество запросов в минуту с кодом ответа 2хх — запросы от клиента к бэкенду, на которые бэкенд ответил кодом 2хх.

  • Количество запросов в минуту с кодом ответа 3хх — запросы от клиента к бэкенду, на которые бэкенд ответил кодом 3хх.

  • Количество запросов в минуту с кодом ответа 4хх — запросы от клиента к бэкенду, на которые бэкенд ответил кодом 4хх.

  • Количество запросов в минуту с кодом ответа 5хх — запросы от клиента к бэкенду, на которые бэкенд ответил кодом 5хх.

Просмотр графиков в API Gateway

Графики доступны для просмотра в сервисе API Gateway.

Чтобы отслеживать общую статистику запросов к вашим сервисам через API-шлюз, выберите шлюз и перейдите на вкладку Мониторинг.

Вы можете выбрать период сбора данных и интервал обновления графиков. По умолчанию графики отображают данные за последние два часа и обновляются каждые 30 секунд.

Метрики и лейблы

Метрики и лейблы можно использовать в API-запросах в формате Prometheus text-based exposition или в Grafana.

Метрики

Метрика — показатель, который количественно или качественно характеризует деятельность, событие или процесс. Например о количестве действий, сущностей или используемых ресурах. Каждой метрике присвоены лейблы.

В API Gateway используются общие лейблы для всех метрик и дополнительные лейблы для каждого вида метрик.

Метрики сервиса API Gateway и дополнительные лейблы для каждой метрики приведены в таблице:

Метрика

Описание

Дополнительные лейблы

apigw_http_status

Количество запросов, обработанных сервисом API Gateway с кодом ответа, указанным в лейбле code.

code — код ответа, возвращаемый правилом при обращении к сервису API Gateway.

Пример значений: 200, 201, 202, 204, 301, 302, 304, 307, 400, 401, 403, 404, 405, 422, 499, 500, 503.

apigw_http_latency_bucket

Категория (bucket) задержки обработки HTTP-запроса в миллисекундах.

type — тип задержки: apigw — задержка запроса на стороне API Gateway, upstream — задержка на стороне бэкенда клиента, request — общая задержка.

apigw_http_latency_sum

Суммарная задержка обработки HTTP-запроса в миллисекундах.

type — тип задержки: apigw — задержка запроса на стороне API Gateway, upstream — задержка на стороне бэкенда клиента, request — общая задержка.

apigw_http_latency_count

Количество попаданий в категорию (bucket) для задержки обработки HTTP-запроса.

type — тип задержки: apigw — количество попаданий для задержки на стороне API Gateway, upstream — количество попаданий для задержки на стороне бэкенда клиента, request — общее количество попаданий.

apigw_bandwith

Пропускная способность в байтах для API Gateway. Тип пропускной способности определяется лейблом type.

type: apigw — пропускная способность на стороне API Gateway, ingress — пропускная способность для входящего клиентского трафика, egress — пропускная способность для исходящего клиентского трафика.

Лейблы

Лейбл — метка, которая присваивается каждой метрике и отражает, к какому проекту, продукту, шлюзу или другой сущности принадлежит показатель. Например, благодаря лейблам можно вывести информацию об отдельном шлюзе или правиле.

Общие лейблы сервиса API Gateway приведены в таблице:

Лейбл

Описание

apigw_id

Идентификатор (UUID) шлюза

apigw_name

Название шлюза

route_name

Название правила

project_id

Идентификатор (UUID) проекта

product_instance_id

Идентификатор (UUID) продукта

availability_zone

Порядковый номер зоны доступности (az), которая обработала запрос

Пример построения графика с помощью метрик и лейблов

С помощью метрик вы можете строить графики в Grafana.

Используйте приведенный ниже пример кода, чтобы построить график 95-го перцентиля задержки обработки HTTP-запроса.

histogram_quantile(0.95, sum(rate(apigw_http_latency_bucket{type=~"request",service=~"$service",consumer=~"$consumer",node=~"$node",api_gw_name=~"$api_gw",route_name=~"$route",availability_zone=~"$az"}[1m])) by (le))