Справка о источнике данных Prometheus - История изменений

IKuznetsov в 21:38, 29 апреля 2026

2026-04-29T21:38:18Z

← Предыдущая версия		Версия от 21:38, 29 апреля 2026
Строка 220:		Строка 220:
	\|-		\|-
	\|[https://prometheus.io/docs/concepts/metric_types/#histogram Histogram]		\|[https://prometheus.io/docs/concepts/metric_types/#histogram Histogram]
	\|Примечание: '''Процентиль временного ряда''' доступен только клиентам '''DPS''' с тарифной картой '''Metrics powered ~~by Grail~~'''. Функция вычисляет запрошенный процентиль значения выражения в каждом сегменте, поэтому он естественным образом используется с гистограммами.		\|Примечание: '''Процентиль временного ряда''' доступен только клиентам '''DPS''' с тарифной картой '''Metrics powered'''. Функция вычисляет запрошенный процентиль значения выражения в каждом сегменте, поэтому он естественным образом используется с гистограммами.

	* Считайте часть как <code><metric-key>_count</code>		* Считайте часть как <code><metric-key>_count</code>

IKuznetsov: /* Локальное расширение */

2025-06-23T23:59:21Z

Локальное расширение

← Предыдущая версия		Версия от 23:59, 23 июня 2025
Строка 514:		Строка 514:
	Для локального расширения областью действия является хост, группа хостов или зона управления, для которых вы будете выполнять расширение. Вы также можете выбрать мониторинг всей среды (опционально, ограниченный тегами).		Для локального расширения областью действия является хост, группа хостов или зона управления, для которых вы будете выполнять расширение. Вы также можете выбрать мониторинг всей среды (опционально, ограниченный тегами).

	* При определении хоста в качестве области действия используйте следующий формат: <code>"scope": "<HOST_ID>",</code> Замените <code><HOST_ID></code> идентификатором сущности хоста, как в этом примере: <code>"scope": "HOST-A1B2345678C9D001",</code>		* При определении хоста в качестве области действия используйте следующий формат: <code>"scope": "<HOST_ID>",</code> <br />Замените <code><HOST_ID></code> идентификатором сущности хоста, как в этом примере: <code>"scope": "HOST-A1B2345678C9D001",</code>
	* При определении группы хостов в качестве области действия используйте следующий формат: <code>"scope": "HOST_GROUP-<HOST_GROUP_ID>",</code> Замените <code><HOST_GROUP_ID></code> идентификатором сущности группы хостов, как в этом примере: <code>"scope": "HOST_GROUP-AB123C4D567E890",</code> Идентификатор группы хостов можно найти на странице настроек группы хостов URL. Например: <code><nowiki>https://{your-environment-id}.live.astromkey.com/#settings/hostgroupconfiguration;id=HOST_GROUP-AB123C4D567E890;hostGroupName=my-host-group</nowiki></code>		* При определении группы хостов в качестве области действия используйте следующий формат: <code>"scope": "HOST_GROUP-<HOST_GROUP_ID>",</code> <br />Замените <code><HOST_GROUP_ID></code> идентификатором сущности группы хостов, как в этом примере: <code>"scope": "HOST_GROUP-AB123C4D567E890",</code> <br />Идентификатор группы хостов можно найти на странице настроек группы хостов URL. Например: <code><nowiki>https://{your-environment-id}.live.astromkey.com/#settings/hostgroupconfiguration;id=HOST_GROUP-AB123C4D567E890;hostGroupName=my-host-group</nowiki></code>
	* При определении зоны управления в качестве области действия используйте следующий формат: <code>"scope": "management_zone-<MANAGEMENT-ZONE>",</code> Замените <code><MANAGEMENT-ZONE></code> на имя зоны управления, как в этом примере: <code>"scope": "management_zone-sampleManagementZone",</code> Зону управления можно найти на странице настроек зон управления.		* При определении зоны управления в качестве области действия используйте следующий формат: <code>"scope": "management_zone-<MANAGEMENT-ZONE>",</code> <br />Замените <code><MANAGEMENT-ZONE></code> на имя зоны управления, как в этом примере: <code>"scope": "management_zone-sampleManagementZone",</code> <br />Зону управления можно найти на странице настроек зон управления.
	* При определении среды в качестве области действия используйте следующий формат: <code>"scope": "environment",</code> Вы также можете добавить теги для фильтрации хостов, на которых будет работать эта конфигурация: <br /><code>"activationTags": [</code> <br /><code> "dt.owner:lama"</code> <br /><code>]</code>		* При определении среды в качестве области действия используйте следующий формат: <code>"scope": "environment",</code> <br />Вы также можете добавить теги для фильтрации хостов, на которых будет работать эта конфигурация: <br /><code>"activationTags": [</code> <br /><code> "dt.owner:lama"</code> <br /><code>]</code>

	Если вы активируете локальное расширение '''Prometheus''' и определяете конечную точку сервера '''Prometheus''', работающего на том же хосте, метрики, собранные с этого сервера, могут поступать из разных конечных точек, а не только из конечной точки на этом хосте, но все метрики будут обогащены контекстом хоста, установленным ЕдинымАгентом.		Если вы активируете локальное расширение '''Prometheus''' и определяете конечную точку сервера '''Prometheus''', работающего на том же хосте, метрики, собранные с этого сервера, могут поступать из разных конечных точек, а не только из конечной точки на этом хосте, но все метрики будут обогащены контекстом хоста, установленным ЕдинымАгентом.

IKuznetsov: /* Атрибут type */

2025-06-23T23:58:11Z

Атрибут type

Внесённые изменения

IKuznetsov: Новая страница: «Это общее описание файла '''YAML''' расширения на основе источника данных '''Prometheus''' и способо...»

2025-06-23T21:01:30Z

Новая страница: «Это общее описание файла '''YAML''' расширения на основе источника данных '''Prometheus''' и способо...»

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

Это общее описание файла '''YAML''' расширения на основе источника данных '''Prometheus''' и способов объявления метрик и измерений, которые вы хотели бы собирать с помощью вашего расширения.

== Область действия данных ==
Создайте список конечных точек '''Prometheus''', на которые вы хотели бы ссылаться в своем расширении, а также значений метрик и измерений.

В нашем примере мы создаем простое расширение, собирающее метрики '''Rabbit MQ'''.
{| class="wikitable"
|name: com.dynatrace.extension.prometheus-rabbitmq

version: 1.0.0

minDynatraceVersion: '1.236'

author:

name: Dynatrace

dashboards:

- path: 'dashboards/dashboard_exporter.json'

alerts:

- path: 'alerts/alert_socket_usage.json'

<nowiki>#</nowiki> Extension based on official rabbitmq prometheus exporter available metrics

<nowiki>#</nowiki> list of metrics visible here <nowiki>https://github.com/rabbitmq/rabbitmq-server/blob/master/deps/rabbitmq_prometheus/metrics.md</nowiki>

prometheus:

- group: rabbitmq metrics

interval:

minutes: 1

featureSet: all

dimensions:

- key: rabbitmq

value: const:rabbitmq

subgroups:

# global counters

- subgroup: rabbitmq global counter

dimensions:

- key: global_counters

value: const:global_counters

metrics:

- key: com.dynatrace.extension.prometheus-rabbitmq.global.global_messages_acknowledged_total

value: metric:rabbitmq_global_messages_acknowledged_total

type: count

featureSet: global

- key: com.dynatrace.extension.prometheus-rabbitmq.global.global_messages_confirmed_total

value: metric:rabbitmq_global_messages_confirmed_total

type: count

featureSet: global

- key: com.dynatrace.extension.prometheus-rabbitmq.global.global_messages_delivered_consume_auto_ack_total

value: metric:rabbitmq_global_messages_delivered_consume_auto_ack_total

type: count

featureSet: global
|}
Определение области мониторинга '''Prometheus''' начинается с узла YAML <code>prometheus</code>. Все настройки в узле относятся к объявленному типу источника данных (в данном случае '''Prometheus''').

== Размеры ==
Для каждого уровня (группы, подгруппы) можно определить до '''25''' измерений (что дает в общей сложности '''50''' измерений на метрику).

=== Размерный ключ ===
Строка ключа измерения должна соответствовать '''протоколу приема метрик'''.

=== Значение размера ===
Для определения измерений ваших показателей можно использовать следующие методы:

'''Обычный текст.''' Префикс <code>const:</code> или просто добавьте нужный текст
{| class="wikitable"
|dimensions:

- key: extension.owner

value: const:Joe.Doe@somedomain.com
|}
Или
{| class="wikitable"
|dimensions:

- key: extension.owner

value: const:Joe.Doe@somedomain.com
|}
'''[https://prometheus.io/docs/practices/naming/#metric-and-label-naming Prometheus label]'''
{| class="wikitable"
|dimensions:

- key: customdimension.job

value: label:job

filter: const:$eq(prometheus)
|}
Все метки, представленные '''Prometheus''', создаются как измерения автоматически. Вам нужно явно определить измерение на основе меток только в том случае, если вы хотите:

* применить фильтрацию к значениям,
* определить пользовательский ключ измерения.

=== Фильтр извлеченных метрических строк ===
При извлечении строк показателей можно добавить логику фильтрации, которая приведет к отображению только тех строк, для которых значение измерения соответствует критериям фильтрации.

Определите фильтр на основе условия следующим образом:

* '''Начинается с''' – используйте определитель <code>const:$prefix</code>. Пример: <code>filter: const:$prefix(xyz)</code>
* '''Заканчивается на''' – используйте определитель <code>const:$suffix</code>. Пример: <code>filter: const:$suffix(xyz)</code>
* '''Содержит''' – используйте квалификатор <code>const:$contains</code>. Пример: <code>filter: const:$contains(xyz)</code>
* '''Равно''' – используйте квалификатор <code>const:$eq</code>. Пример: <code>filter: const:$eq(xyz)</code> Для выражений, упомянутых выше, вы также можете использовать определители:
** <code>const:$and</code>– для соединения двух или более выражений с помощью оператора '''AND'''. Пример: <code>filter: const:$and(<expr1>,<expr2>)</code>
** <code>const:$or</code>– для соединения двух или более выражений с помощью оператора '''OR'''. Пример: <code>filter: const:$or(<expr1>,<expr2>)</code>
** <code>const:$not</code>– для '''отрицания''' выражения. Пример: <code>filter: const:$not(<expr>)</code>

Вы можете создавать сложные фильтры, объединяя два или более фильтров, разделенных запятыми, с помощью логических выражений:
{| class="wikitable"
|dimensions:

- key: technology

value: other

- key: job

value: label:job

filter: const:$or($eq(),$not($or($eq(prometheus),$eq(rabbitmq-server),$eq(redis_exporter),$eq(node_exporter)))
|}

== Метрики ==
Для каждого уровня (группа, подгруппа) можно определить до '''100''' метрик. Однако следует отметить, что существует жесткое ограничение в '''1000''' метрик на расширение, применяемое во время выполнения. Это ограничение ниже, чем объединенные ограничения разрешенных групп и подгрупп.

Например:
{| class="wikitable"
|prometheus:

- group: rabbitmq metrics

interval: 1m

featureSet: all

dimensions:

- key: instance

value: $reference(metric:rabbitmq_identity_info, ref:rabbitmq_node)

subgroups:

# global counters

- subgroup: rabbitmq global counter

metrics:

- key: com.dynatrace.extension.prometheus-rabbitmq.global.global_messages_acknowledged_total

value: metric:rabbitmq_global_messages_acknowledged_total

type: count

featureSet: global

- key: com.dynatrace.extension.prometheus-rabbitmq.global.global_messages_confirmed_total

value: metric:rabbitmq_global_messages_confirmed_total

type: count

featureSet: global
|}

=== Метрический ключ ===
Строка ключа метрики должна соответствовать '''протоколу приема метрик'''.

Для Ключ-АСТРОМ версий 1.215 и 1.217 метрический узел требует параметр <code>id</code> вместо <code>key</code>. Начиная с Ключ-АСТРОМ версии 1.219, мы рекомендуем использовать параметр <code>key</code>, так как <code>id</code> будет устаревшим.

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

=== Значение метрики ===
Ключ метрики '''Prometheus''', из которого вы хотите извлечь значение метрики, с префиксом <code>metric:</code>.

=== Атрибут <code>type</code> ===
Фреймворк Ключ-АСТРОМ Расширения 2.0 поддерживает все оригинальные форматы полезной нагрузки метрик '''Prometheus'''. Чтобы указать тип метрики, используйте атрибут <code>type</code>.
{| class="wikitable"
!'''Prometheus exposed type'''
!Astromkey ingest
|-
|[https://prometheus.io/docs/concepts/metric_types/#counter Count]
|<code>count</code>
|-
|
|
|-
|
|
|}