graphite_param

Директива `graphite_param` определяет параметр для метрик, отправляемых на сервер Graphite, позволяя настраивать собираемую статистику.

Синтаксисgraphite_param key value;
По умолчаниюnone
Контекстhttp, server, location, if in location
Аргументы4

Описание

Директива graphite_param используется для настройки дополнительных параметров для метрик, собираемых модулем NGINX Graphite. Она позволяет пользователям указывать различные типы метрик, которые должны отправляться на сервер Graphite и использоваться для мониторинга производительности и аналитики. Директива доступна в нескольких контекстах, таких как http, server, location, а также внутри директивы if внутри location. Такая гибкость даёт возможность тонко контролировать, какие метрики отправляются, исходя из конкретных потребностей приложения или блока server.

Параметры, которые можно задать в директиве graphite_param, включают различные показатели, касающиеся производительности сервера, такие как времена отклика, количество подключений или настраиваемые метрики, определяемые пользователем с помощью определённого синтаксиса. Настройка этих параметров позволяет администраторам гарантировать, что будет захвачен и передан только наиболее релевантный набор данных, что повышает эффективность мониторинга и потенциально снижает нагрузку на сервер.

На практике пользователь может настроить несколько директив graphite_param для сбора разных метрик в разных location или блоках server. Это позволяет собирать метрики, адаптированные под потребности отдельных маршрутов приложения или сервисов, размещённых на одном экземпляре NGINX, что даёт лучшее представление о производительности и поведении каждого сервиса.

Пример конфига

http {
    graphite_config server=127.0.0.1;
    server {
        location /api/ {
            graphite_param response_time avg;
            graphite_param request_count sum;
        }
    }
}

Убедитесь, что указанные параметры поддерживаются сервером Graphite.

Использование неправильных типов метрик может привести к ошибкам при отправке данных в Graphite.

Контекст, в котором используется graphite_param, может влиять на то, какие параметры можно определить.

← Ко всем директивам