Перейти к основному содержимому

Telegraf

Последнее изменение:

Telegraf — система мониторинга, которая позволяет настроить сбор, хранение и обработку метрик.

Перед началом работы настройте Telegraf.

Настроить Telegraf

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

  1. Добавьте сервисного пользователя.
  2. Настройте агент для получения метрик.

1. Добавить сервисного пользователя

Добавьте сервисного пользователя с разрешением в области доступа Проекты и ролью:

Добавлять пользователей может Владелец аккаунта или пользователи с ролью iam.admin.

2. Настроить агент для получения метрик

  1. Откройте CLI.

  2. Создайте файл конфигурации telegraf.conf:

    nano /etc/telegraf/telegraf.conf

  3. Заполните файл конфигурации telegraf.conf:

    [agent]
      interval = "1m"
      flush_interval = "1m"

    [[inputs.prometheus]]
      urls = ["<base_url>/projects/<project_id>/namespaces/<namespace>/prometheus/metrics"]
      username = "<user_id>"
      password = "<password>"

    [[outputs.file]]
      files = ["stdout"]
      data_format = "prometheus"

    Укажите:

    • <base_url> — URL для обращения к API сервиса Метрики. Список URL можно посмотреть в инструкции Список URL;
    • <project_id> — ID проекта. Можно скопировать в панели управления: в верхнем меню нажмите Продукты и выберите любой продукт → откройте меню проектов → в строке нужного проекта нажмите ;
    • <namespace> — имя выбранного пространства имен, например compute;
    • <user_id> — ID пользователя, которого вы добавили на этапе 1;
    • <password> — пароль пользователя, которого вы добавили на этапе 1.

  4. Опционально: вы можете настроить сбор метрик из нескольких пулов или проектов. Чтобы добавить новый пул или проект, в разделе inputs.prometheus в параметре urls перечислите все источники через запятую.

  5. Опционально: добавьте отправку метрик во внешние системы хранения или обработки, например в VictoriaMetrics. Для этого дополните раздел outputs в файле конфигурации telegraf.conf с помощью плагина Prometheus Output Plugin.

  6. Выйдите из текстового редактора nano с сохранением изменений: нажмите Ctrl+Х, а затем Y+Enter.

  7. Запустите Telegraf:

    docker run \
      --name telegraf \
      --rm \
      -v ${PWD}/telegraf.conf:/etc/telegraf/telegraf.conf:ro \
      telegraf:latest \
      --config /etc/telegraf/telegraf.conf

    Собранные метрики будут выводиться в stdout. Пример вывода:

    # HELP network_meta_info_value Telegraf collected metric
    2026-03-03T12:46:30.359832865Z # TYPE network_meta_info_value untyped
    2026-03-03T12:46:30.359838580Z network_meta_info_value{server_uuid="...", ...} 1
    2026-03-03T12:46:30.359844441Z # HELP network_receive_bits_rate_value Telegraf collected metric
    2026-03-03T12:46:30.359847896Z # TYPE network_receive_bits_rate_value untyped
    2026-03-03T12:46:30.359851348Z network_receive_bits_rate_value{server_uuid="...", ...} 0