IKuznetsov: Новая страница: «'''StatsD''' — это отраслевой стандарт для передачи произвольной статистики и других метрик...»

2025-12-18T22:15:37Z

Новая страница: «'''StatsD''' — это отраслевой стандарт для передачи произвольной статистики и других метрик...»

Новая страница

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

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

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

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

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

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

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

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

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

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

=== Включение удаленного StatsD ===
<code>АктивныйШлюз версия 1.227+</code>

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

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

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

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

* '''Linux''' : <code>/var/lib/astromkey/remotepluginmodule/agent/conf/extensionsuser.conf</code>
* '''Windows''' : <code>C:\ProgramData\astromkey\remotepluginmodule\agent\conf\extensionsuser.conf</code>

2. Установите параметр <code>statsdenabled</code> на <code>true</code>:
{| class="wikitable"
|statsdenabled=true
|}
3. Перезапустите службу контроллера выполнения расширений.

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

* для систем с '''SystemV''':

{| class="wikitable"
|statsdenabled=true
|}

* для систем с '''systemd''':

{| class="wikitable"
|systemctl stop extensionsmodule

systemctl start extensionsmodule
|}
В Windows воспользуйтесь диспетчером задач и перезапустите службу <code>astromkey Extensions Controller</code> или выполните следующие команды:
{| class="wikitable"
|net stop "astromkey Extensions Controller"

net start "astromkey Extensions Controller"
|}
Обратите внимание, что порт по умолчанию для удаленного '''StatsD''' отличается от порта для приемника ЕдиногоАгента Ключ-АСТРОМ StatsD (<code>18126</code>). См. раздел '''Удаленный StatsD''' (ниже).

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

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

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

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

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

* '''Linux''' : <code>./oneagentctl --get-extensions-statsd-port</code>
* '''Windows''' : <code>.\oneagentctl.exe --get-extensions-statsd-port</code>

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

* '''Linux''' : <code>./oneagentctl --set-extensions-statsd-port=18125 --restart-service</code>
* '''Windows''' : <code>.\oneagentctl.exe --set-extensions-statsd-port=18125 --restart-service</code>

=== Удаленный StatsD ===
Порт прослушивания '''UDP''' по умолчанию для удаленного приемника Ключ-АСТРОМ '''StatsD''' — <code>18126</code>.

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

* '''Linux''' <code>/var/lib/astromkey/remotepluginmodule/agent/conf/extensionsuser.conf</code>
* '''Windows''' <code>C:\ProgramData\astromkey\remotepluginmodule\agent\conf\extensionsuser.conf</code>

{| class="wikitable"
|StatsdPort=18126
|}

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

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

== Формат метрик StatsD ==
Ключ-АСТРОМ '''StatsD''' принимает следующие метрики в [https://github.com/statsd/statsd/blob/master/docs/metric_types.md собственном формате '''StatsD'''] :

* <code>count</code>

{| class="wikitable"
|<nowiki><metric name>:<value>|c</nowiki>
|}

* <code>gauge</code>

{| class="wikitable"
|<nowiki><metric name>:<value>|g</nowiki>
|}

* <code>time</code>

{| class="wikitable"
|<nowiki><metric name>:<value>|ms</nowiki>
|}

* <code>histogram</code>

{| class="wikitable"
|<nowiki><metric name>:<value>|h</nowiki>
|}

* <code>set</code> Версия OneAgent 1.303+

{| class="wikitable"
|<nowiki><metric name>:<value>|s</nowiki>
|}

* <code>distribution</code>

{| class="wikitable"
|<nowiki><metric name>:<value>|d</nowiki>
|}
Ключ-АСТРОМ '''StatsD''' расширяет исходный протокол, позволяя также отправлять измерения. Используйте следующий формат:
{| class="wikitable"
|<nowiki><metric name>:<value>|g|#<Dimension1>:<value>,<Dimension2>:<value></nowiki>
|}

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

=== Технические характеристики оборудования ===
ЕдиныйАгент и АктивныйШлюз установлены на виртуальной машине под управлением '''Linux''' в экземпляре '''Amazon EC2''' типа [https://aws.amazon.com/ec2/instance-types/c5/ c5.large]

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

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

Отправка метрик StatsD в Ключ-АСТРОМ - История изменений

IKuznetsov: Новая страница: «'''StatsD''' — это отраслевой стандарт для передачи произвольной статистики и других метрик...»