С Ключ-Астром вы можете получить возможность наблюдать за Kong Gateway и его управляемыми API. Узнайте, как отслеживать свой Kong Gateway и собирать метрики с помощью расширения Kong Prometheus.
Предварительные требования
- Ваша версия Kong Gate поддерживается Ключ-Астром.
- OneAgent или Ключ-Астром Operator установлены и доступны для мониторинга вашего Kong Gateway.
Необходимая установка зависит от вашего приложения:
| Если ваше приложение работает | См. инструкцию для |
|---|---|
| на виртуальной машине или на «голом железе» | ЕдиныйАгент |
| как рабочая нагрузка в Kubernetes или OpenShift | Ключ-Астром Operator |
Трассировки
Чтобы начать трассировку приложений Kong, см. Инструментирование NGINX вручную.
Метрики
Ключ-Астром может собирать метрики с помощью плагина Kong Prometheus. Таким образом, предполагается следующая конфигурация:
| Настройки | Детали |
|---|---|
| Конечная точка служб Kong | /services
|
| Конечная точка Kong Routes | /routes
|
| Конечная точка плагинов Kong | /plugins
|
| Конечная точка метрик Prometheus | /metrics
|
| Порт HTTP прокси-сервера Kong | 8000
|
| Порт HTTPS прокси-сервера Kong | 8443
|
| HTTP-порт администратора Kong | 8001
|
| Порт HTTPS администратора Kong | 8444
|
Обязательно адаптируйте инструкции по установке к вашей фактической конфигурации.
Включить плагин Prometheus на Kong
Чтобы включить плагин Prometheus в Kong, отправьте следующий запрос POST на конечную точку /plugins:
curl -X POST http://{HOST}:8001/plugins --data "name=prometheus"
Замените {HOST} вашим фактическим значением.
Чтобы проверить доступные метрики Kong, запросите конечную точку /metrics:
curl -i http://localhost:8001/metrics
Собирайте метрики Prometheus
Плагин Prometheus — самый удобный способ сбора метрик Kong. Плагин находится в постоянном развитии, поэтому появляются все новые и новые показатели.
В настоящее время Ключ-Астром предлагает три подхода к сбору метрик Prometheus в зависимости от среды.
Kubernetes
В Kubernetes Ключ-Астром поддерживает парсинг любой конечной точки HTTP(s), предлагая метрики в формате OpenMetrics (например, экспортеры Prometheus). С помощью аннотаций, специфичных для Ключ-Астром, вы можете указать, какие модули или сервисы следует очищать.
Узнайте, как собирать метрики Prometheus в Kubernetes.
Использование расширения
Ключ-Астром предоставляет масштабируемые средства для получения метрик Prometheus напрямую из источника без использования Kubernetes. Это работает полностью автоматически и работает лучше всего, если ЕдиныйАгент установлен на компьютере, где создаются метрики Prometheus, но это также можно сделать полностью без агента, когда ЕдиныйАгент не может быть установлен на устройстве.
- Узнайте, как собирать метрики Prometheus без Kubernetes с помощью источника данных Extensions 2.0 Prometheus.
- Ознакомьтесь с нашими руководствами по Extensions 2.0.
Кроме того, следите за нашим центром Software Intelligence, где мы часто публикуем новые расширения.
Amazon Managed
Amazon предоставляет управляемый сервис для Prometheus, а Ключ-Астром предоставляет средства для сбора метрик непосредственно из него, если вам это нужно. Однако, как правило, было бы более рентабельно использовать один из других методов, описанных здесь, и избежать дополнительных затрат на сервис Amazon.
Узнайте, как собирать метрики Prometheus из Amazon Managed Service для Prometheus.
Kong метрики
| Ключ метрики | Описание | Тип |
|---|---|---|
kong_bandwidth
|
Общая пропускная способность в байтах, потребляемая на услугу/маршрут в Kong | counter |
kong_datastore_reachable
|
Хранилище данных доступно из Kong; 0 недоступен | gauge |
kong_http_status
|
Коды состояния HTTP для каждой службы/маршрута в Kong | counter |
kong_latency
|
Задержка, добавленная Kong, общее время запроса и задержка восходящего потока для каждой службы/маршрута в Kong | histogram |
|
gauge
counter counter | |
kong_memory_lua_shared_dict_bytes
|
Выделенные плиты в байтах в shared_dict | gauge |
kong_memory_lua_shared_dict_total_bytes
|
Общая емкость в байтах shared_dict | gauge |
kong_memory_workers_lua_vms_bytes
|
Выделенные байты в рабочей Lua VM | gauge |
kong_nginx_http_current_connections
|
Количество HTTP-соединений | gauge |
kong_nginx_metric_errors_total
|
Количество ошибок nginx-lua-prometheus | counter |
kong_nginx_timers
|
Количество таймеров NGINX | gauge |