IKuznetsov: Новая страница: «Чтобы ваше расширение могло собирать метрики и передавать их в Ключ-АСТРОМ, необходимо о...»

2025-09-22T16:23:56Z

Новая страница: «Чтобы ваше расширение могло собирать метрики и передавать их в Ключ-АСТРОМ, необходимо о...»

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

Чтобы ваше расширение могло собирать метрики и передавать их в Ключ-АСТРОМ, необходимо определить '''источник данных'''. В этом руководстве мы используем '''источник данных WMI'''. Это должен быть раздел <code>wmi</code>, вызываемый в вашем расширении.

Цель раздела <code>wmi</code> — определить запросы '''WMI''', которые извлекают ваши метрики, частоту их выполнения и способы сопоставления их результатов с метриками и измерениями, которые Ключ-АСТРОМ может обрабатывать. Группы и подгруппы используются для организации данных и определения общих свойств, таких как измерения и частота выполнения.

Для нашего расширения мы используем три '''WMI'''-запроса. Мы добавим их в нашу базу данных <code>extension.yaml</code> и используем их результаты в качестве метрик Ключ-АСТРОМ:

Извлечение данных об использовании '''ЦП''', использовании '''ЦП''' пользователем и простое '''ЦП''' для каждого из процессоров хоста (с разделением по идентификатору '''ЦП'''):
{| class="wikitable"
|SELECT Name, PercentProcessorTime, PercentIdleTime, PercentUserTime FROM Win32_PerfFormattedData_PerfOS_Processor WHERE Name LIKE '_Total'
|}
Извлечение общего количества отправленных и полученных байтов в секунду для каждого сетевого адаптера, работающего на хосте:
{| class="wikitable"
|SELECT Name, BytesTotalPersec, BytesReceivedPersec, BytesSentPersec FROM Win32_PerfFormattedData_Tcpip_NetworkAdapter
|}
Извлечь общее количество отправленных и полученных байтов в секунду для каждого сетевого интерфейса, работающего на хосте:
{| class="wikitable"
|SELECT Name, BytesTotalPersec, BytesReceivedPersec, BytesSentPersec FROM Win32_PerfFormattedData_Tcpip_NetworkInterface
|}

== Советы ==

=== Лучшие практики использования метрик ===
Добавляйте к ключам метрик префикс имени расширения, чтобы избежать конфликтов с другими метриками в Ключ-АСТРОМ. В этом примере мы добавляем к каждому ключу метрики префикс <code>custom.demo.host-observability</code>.

=== Измерение хоста ===
Вы можете идентифицировать хост, на котором запущено расширение, с помощью <code>this:device.host</code> переданного в качестве значения измерения.

=== Статические размеры ===
Вы можете добавлять измерения, которые являются фиксированными строками, используя префикс <code>const:</code>.

== Определите свой источник данных ==
Добавьте <code>wmi</code> в раздел <code>extension.yaml</code>, используя шаблон ниже.

# Создайте две группы с именами <code>Host</code> и <code>Network</code>, которые будут запускаться каждую минуту. Обе группы должны иметь параметр, идентифицирующий хост, на котором запущено расширение.
# Создайте подгруппу для каждого запроса '''WMI''', указанного выше, и сопоставьте полученные столбцы с метриками и измерениями.
# Добавьте измерение <code>network.type</code>, которое принимает значение <code>Adapter</code> или <code>Interface</code>, в зависимости от запроса '''WMI'''.
# Упакуйте новую версию вашего расширения и загрузите ее.
# Настройте его для мониторинга вашего хоста '''Windows'''. Это можно сделать во время активации расширения в Ключ-АСТРОМ.
# Подождите минуту, а затем проверьте сбор показателей.

Дополнительную информацию о синтаксисе источника данных WMI см. в [[Справка о источнике данных WMI|Справочнике по источникам данных WMI]].
{| class="wikitable"
|wmi:

- group: Host

interval:

minutes: 1

dimensions:

- key: host

value: this:device.host

subgroups:

- subgroup: CPU

query: SELECT Name, PercentProcessorTime, PercentIdleTime, PercentUserTime FROM Win32_PerfFormattedData_PerfOS_Processor WHERE Name LIKE '_Total'

metrics:

- key: custom.demo.host-observability.host.cpu.time.processor

value: column:PercentProcessorTime

- key: custom.demo.host-observability.host.cpu.time.idle

value: column:PercentIdleTime

- key: custom.demo.host-observability.host.cpu.time.user

value: column:PercentUserTime

dimensions:

- key: host.cpu.id

value: column:Name

- group: Network

interval:

minutes: 1

dimensions:

- key: host

value: this:device.host

subgroups:

- subgroup: Adapters

query: SELECT Name, BytesTotalPersec, BytesReceivedPersec, BytesSentPersec FROM Win32_PerfFormattedData_Tcpip_NetworkAdapter

metrics:

- key: custom.demo.host-observability.network.bytes.persec

value: column:BytesTotalPersec

- key: custom.demo.host-observability.network.bytes.received.persec

value: column:BytesReceivedPersec

- key: custom.demo.host-observability.network.bytes.sent.persec

value: column:BytesSentPersec

dimensions:

- key: network.type

value: const:Adapter

- key: network.name

value: column:Name

- subgroup: Interfaces

query: SELECT Name, BytesTotalPersec, BytesReceivedPersec, BytesSentPersec FROM Win32_PerfFormattedData_Tcpip_NetworkInterface

metrics:

- key: custom.demo.host-observability.network.bytes.persec

value: column:BytesTotalPersec

- key: custom.demo.host-observability.network.bytes.received.persec

value: column:BytesReceivedPersec

- key: custom.demo.host-observability.network.bytes.sent.persec

value: column:BytesSentPersec

dimensions:

- key: network.type

value: const:Interface

- key: network.name

value: column:Name
|}

== Результаты ==
Ваши шесть показателей должны отображаться в '''браузере метрик'''. Чтобы найти их, отфильтруйте по тексту <code>custom.demo</code>.

[[Файл:Image1235.png|граница]]

Пособие WMI — источник данных - История изменений

IKuznetsov: Новая страница: «Чтобы ваше расширение могло собирать метрики и передавать их в Ключ-АСТРОМ, необходимо о...»