Отправка метрик StatsD в Ключ-АСТРОМ

StatsD — это отраслевой стандарт для передачи произвольной статистики и других метрик независимым от поставщика способом по протоколу UDP. Мы рекомендуем использовать Ключ-АСТРОМ ЕдиныйАгент для приема метрик, поскольку ЕдиныйАгент поставляется с StatsD daemon по умолчанию. Это означает, что любое приложение или библиотека, поддерживающие StatsD, могут отправлять метрики в Ключ-АСТРОМ. Вам нужно только установить ЕдиныйАгент и убедиться, что ваш клиент StatsD использует правильный порт (18125 по умолчанию).

Поддерживается только ЕдиныйАгент Daemon StatsD доступен только на ЕдиномАгенте, установленном на виртуальной машине или хосте, который вы хотите отслеживать. ЕдиныйАгент, развернутый в Kubernetes, например, с использованием Ключ-АСТРОМ Operator, не поддерживается. Для сред Kubernetes мы рекомендуем удаленный мониторинг StatsD с использованием АктивногоШлюза.

Однако, если вам не удается установить ЕдиныйАгент на хост с метриками StatsD, вы можете использовать АктивныйШлюз в качестве удаленного прослушивателя.

Выберите способ загрузки данных в StatsD

ЕдиныйАгент	АктивныйШлюз	OpenTelemetry Collector
Используйте ЕдиныйАгент для прямой установки на хост с StatsD. Для получения более подробной информации перейдите в раздел приемник ЕдиногоАгента (ниже).	Если ЕдиномуАгенту не удается установить на хост, используйте АктивныйШлюз в качестве удаленного прослушивателя для сбора метрик StatsD. Для получения более подробной информации перейдите в раздел Удаленный StatsD (ниже).	Для распределенных сред или при использовании Kubernetes OpenTelemetry Collector предоставляет решение для загрузки метрик StatsD в Ключ-АСТРОМ. Подробнее см. раздел Загрузка данных из StatsD (ниже).

Включение Ключ-АСТРОМ StatsD

Приемник Ключ-АСТРОМ StatsD входит в состав ЕдиногоАгента версии 1.201 и выше. Вам нужно включить сбор метрик Ключ-АСТРОМ StatsD только на уровне среды, хоста или группы хостов. Обратите внимание, что конфигурации на уровне хоста и группы хостов переопределяют конфигурацию среды.

Включение на уровне среды

Для включения приема метрик Ключ-АСТРОМ StatsD на уровне среды

1. Перейдите в Настройки и выберите Предпочтения > Контроллер выполнения расширений.
2. Включите параметр Контроллер выполнения расширений.
3. Включите параметр Enable Astromkey StatsD.

Включение на уровне группы хостов

Для включения приема метрик Ключ-АСТРОМ StatsD на уровне группы хостов.

1. Перейдите в Настройки и выберите Обзор мониторинга > Хосты.
2. Выберите имя группы хостов для выбранного хоста.
3. На странице настроек группы хостов выберите Контроллер выполнения расширений.
4. Включите параметр Enable Astromkey StatsD.

Включение для одного хоста

Чтобы включить сбор метрик Ключ-АСТРОМ StatsD только для выбранных хостов

1. Перейдите в раздел Хосты.
2. Найдите и выберите свой хост, чтобы отобразить страницу обзора хоста.
3. В правом верхнем углу страницы обзора хоста выберите Дополнительно ( … ) > Настройки.
4. В настройках хоста выберите Контроллер выполнения расширений.
5. Включите параметр Контроллер выполнения расширений.
6. Включите параметр Enable Astromkey StatsD.

Включение удаленного StatsD

АктивныйШлюз версия 1.227+

Если вы не можете использовать ЕдиныйАгент для приема метрик StatsD, вы можете использовать среду АктивногоШлюза в качестве точки приема данных Ключ-АСТРОМ StatsD. Ваш АктивныйШлюз должен иметь возможность подключаться к вашему клиенту StatsD по протоколу UDP.

В АктивномШлюзе по умолчанию отключена функция приема метрик Ключ-АСТРОМ StatsD.

Для включения приема метрик Ключ-АСТРОМ StatsD

1. Отредактируйте файл extensionsuser.conf в следующей директории.

• Linux : /var/lib/astromkey/remotepluginmodule/agent/conf/extensionsuser.conf
• Windows : C:\ProgramData\astromkey\remotepluginmodule\agent\conf\extensionsuser.conf

2. Установите параметр statsdenabled на true:

statsdenabled=true

3. Перезапустите службу контроллера выполнения расширений.

В Linux выполните следующие команды:

• для систем с SystemV:

statsdenabled=true

• для систем с systemd:

systemctl stop extensionsmodule systemctl start extensionsmodule

В Windows воспользуйтесь диспетчером задач и перезапустите службу astromkey Extensions Controller или выполните следующие команды:

net stop "astromkey Extensions Controller" net start "astromkey Extensions Controller"

Обратите внимание, что порт по умолчанию для удаленного StatsD отличается от порта для приемника ЕдиногоАгента Ключ-АСТРОМ StatsD (18126). См. раздел Удаленный StatsD (ниже).

Этот файл не изменяется во время обновлений АктивногоШлюза.

Убедитесь, что ваш АктивныйШлюз может подключиться к вашему клиенту StatsD. Например, вам следует настроить DNS-имя для вашего АктивногоШлюза и убедиться, что оно работает после назначения нового IP-адреса от DHCP.

Коммуникационный порт

Приемник ЕдиногоАгента

Порт прослушивания UDP Ключ-АСТРОМ StatsD для приемника ЕдиногоАгента по умолчанию — 18125. При необходимости вы можете использовать команду oneagentctl для проверки или изменения порта приема метрик. Изменение порта требует перезапуска ЕдиногоАгента. Добавьте --restart-service к команде для автоматического перезапуска ЕдиногоАгента.

Проверка входного порта

Используйте параметр --get-extensions-statsd-port для отображения текущего порта прослушивания UDP в Ключ-АСТРОМ Statsd (по умолчанию = 18125).

• Linux : ./oneagentctl --get-extensions-statsd-port
• Windows : .\oneagentctl.exe --get-extensions-statsd-port

Укажите пользовательский порт для приема данных.

Используйте параметр --set-extensions-statsd-port=<arg> для установки пользовательского UDP-порта для прослушивания Ключ-АСТРОМ Statsd.

• Linux : ./oneagentctl --set-extensions-statsd-port=18125 --restart-service
• Windows : .\oneagentctl.exe --set-extensions-statsd-port=18125 --restart-service

Удаленный StatsD

Порт прослушивания UDP по умолчанию для удаленного приемника Ключ-АСТРОМ StatsD — 18126.

Чтобы изменить порт 18126 приемника по умолчанию, измените параметр StatsdPort в файле АктивногоШлюза extensionsuser.conf:

• Linux /var/lib/astromkey/remotepluginmodule/agent/conf/extensionsuser.conf
• Windows C:\ProgramData\astromkey\remotepluginmodule\agent\conf\extensionsuser.conf

StatsdPort=18126

Информация о топологии

При использовании Ключ-АСТРОМ StatsD с ЕдинымАгентом идентификатор хоста и контекст имени хоста автоматически добавляются в качестве измерений к каждой метрике. Для получения дополнительной информации см. раздел Загрузка метрик. Обратите внимание, что мы уже работаем над дополнительными функциями автоматического обогащения метрик. При удаленной загрузке дополнительное обогащение не добавляется. Если вы хотите добавить контекст к своим метрикам, вам необходимо добавить выбранные вами измерения к метрикам StatsD.

Безопасность

Приемник Ключ-АСТРОМ StatsD ЕдиныйАгент принимает входные данные только с адресов localhost. Это означает, что использовать интерфейс могут только процессы, работающие на том же хосте, что и ЕдиныйАгент. Это гарантирует, что никакие неавторизованные программы не будут отправлять данные в вашу среду Ключ-АСТРОМ.

Формат метрик StatsD

Ключ-АСТРОМ StatsD принимает следующие метрики в собственном формате StatsD :

• count

<metric name>:<value>|c

• gauge

<metric name>:<value>|g

• time

<metric name>:<value>|ms

• histogram

<metric name>:<value>|h

• set Версия OneAgent 1.303+

<metric name>:<value>|s

• distribution

<metric name>:<value>|d

Ключ-АСТРОМ StatsD расширяет исходный протокол, позволяя также отправлять измерения. Используйте следующий формат:

<metric name>:<value>|g|#<Dimension1>:<value>,<Dimension2>:<value>

Ограничения и производительность источников данных

Ограничения основаны на тесте, который развертывает машину Linux в облаке AWS. Цель этого теста — определить, какую нагрузку StatsD может выдержать инфраструктурная платформа.

Технические характеристики оборудования

ЕдиныйАгент и АктивныйШлюз установлены на виртуальной машине под управлением Linux в экземпляре Amazon EC2 типа c5.large 

• ЦП: x2
• Оперативная память: 4 ГБ
• Хранилище: EBS
• Пропускная способность сети: до 10 Гбит/с

	Всего записей	Пакеты	Строк в пакете	Связи	Метрики
StatsD на ЕдиномАгенте	290,000	11 600	25	1	1
StatsD на АктивномШлюзе	345,000	13,800	25	1	1