graphite_default_data

Директива `graphite_default_data` определяет метрики по умолчанию, которые будут собираться и отправляться на сервер Graphite для заданного контекста location или server.

Синтаксисgraphite_default_data data_template [data_params];
По умолчаниюnone
Контекстhttp, server
Аргументы1-2

Описание

Директива graphite_default_data позволяет задавать шаблоны и параметры метрик по умолчанию, которые будет использовать NGINX Graphite module при отправке данных на сервер Graphite. Эта директива может принимать один или два аргумента. Первый аргумент обычно задаёт строку-шаблон данных, определяющую, как должны именоваться собираемые метрики. Например, шаблон может быть nginx.$server.$location, что приведёт к динамической генерации имён метрик на основе контекстов NGINX server и location. Второй, необязательный аргумент позволяет добавлять дополнительные параметры к имени метрики, обеспечивая более тонкую детализацию отчётов по метрикам, например разные параметры запроса или информацию, специфичную для контекста.

Если эта директива включена в контекст http или server, она влияет на все запросы, обрабатываемые в этом контексте. Данные агрегируются, и метрики отправляются на указанный сервер Graphite с заданными интервалами. Такая гибкость делает её идеальной для окружений с несколькими блоками server или location, где могут быть актуальны разные метрики. Правильное управление параметрами данных по умолчанию обеспечивает точную и исчерпывающую отчётность по метрикам, позволяя пользователям эффективно отслеживать производительность и состояние.

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

http {
    graphite_default_data nginx.default;  
    server {
        location /api/ {
            graphite_default_data api.metrics;  
        }
    }
}

Директиву нельзя задавать в контексте location; её нужно использовать внутри блоков http или server.

Убедитесь, что шаблон данных, определённый в graphite_default_data, соответствует структуре, ожидаемой сервером Graphite.

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