Атрибуты ресурсов
Атрибуты ресурсов на уровне хоста
Все артефакты мониторинга, которые покидают данный хост, то есть имеют хост в качестве своего ресурса, обогащаются атрибутами ресурса на уровне хоста.
Атрибуты ресурсов на уровне хоста — это атрибуты ресурсов отслеживаемых хостов. Все события, генерируемые компонентами ЕдиногоАгента, работающими на данном хосте, и измерения, получаемые от них, дополняются этими атрибутами. Затем их можно использовать в запросах для структурирования и фильтрации данных мониторинга.
Вы также можете использовать некоторые атрибуты для создания политик управления доступом к данным. См. раздел Глобальный справочник полей и найдите поля, отмеченные тегом Разрешение.
Если у вас есть доступ к хосту с установленным ЕдинымАгентом, вы можете просмотреть dt_host_metadata.json и dt_host_metadata.properties, чтобы увидеть область обогащения атрибутов ресурсов, предоставляемую ЕдинымАгентом. Подробнее см. в разделе Обогащение полученных данных измерениями, специфичными для Ключ-АСТРОМ.
Пользовательские атрибуты уровня хоста
Вы можете создавать собственные атрибуты, настраивая теги «ключ-значение» и свойства через oneagentctl или через удалённое управление конфигурацией ЕдиныхАгентов и АктивныхШлюзов. Пользовательские теги и свойства, определённые таким образом, отображаются как простые атрибуты ресурсов первого уровня.
Ключевые теги без значений игнорируются.
Теги, назначенные с помощью автоматизированных правил, переменных среды, топологии и API Smartscape, не включены.
Поскольку ключи зависят от вашей конфигурации, они не охватываются семантическим словарем.
Название тегов не могут содержать префиксы dt., за исключением следующих тегов, которые зависят от вашей конфигурации:
dt.security_context— атрибут для управления доступом к данным с помощью политик. См. раздел Предоставление доступа сущностям с контекстом безопасности.dt.cost.costcenter- атрибут для назначения использования центру затрат. См. раздел Распределение затрат.dt.cost.product— атрибут для назначения использования идентификатору продукта или приложения. См. раздел Распределение затрат.
| Атрибуты из пользовательских свойств и тегов не переопределяют встроенные расширения, если у них такое же название. При создании пользовательских свойств и тегов проверьте глобальный справочник полей, чтобы убедиться, что ваше название ещё не используется. |
Обработка конфликтов имен при объединении пользовательских свойств и тегов
Атрибуты ресурсов уровня хоста можно импортировать из пользовательских свойств и тегов хоста. Файлы hostcustomproperties.conf и hostautotag.conf являются источниками этих атрибутов. Если они следуют шаблону key=value, в обоих файлах могут существовать одни и те же ключи, но с разными значениями. При объединении содержимое из hostautotag.conf имеет приоритет над содержимым из hostcustomproperties.conf, поскольку теги имеют приоритет в случае конфликта имён.
| Если при объединении атрибутов ресурсов на разных уровнях возникает конфликт имен, приоритет имеет самый низкий уровень. |
Общие атрибуты уровня хоста
Все атрибуты ресурсов на уровне хоста следуют семантическому словарю, если не указано иное.
| Атрибут | Описание |
|---|---|
| Пользовательские теги хоста | См. Пользовательские атрибуты (выше) |
dt.host_group.id
|
Обратите внимание на разницу между dt.entity.host_group и dt.host_group.id:
Более подробную информацию см. в разделе Организация среды с помощью групп хостов. |
dt.entity.host
|
Идентификатор сущности типа HOST.
|
dt.entity.host_group
|
Идентификатор сущности типа HOST_GROUP.
|
dt.security_context
|
Контекст безопасности используется для настройки прав доступа к отслеживаемым объектам в Grail и требует настройки. См. раздел Настраиваемые атрибуты (выше). |
dt.cost.product
|
Этот атрибут используется для назначения идентификатора продукта или приложения и требует настройки. См. раздел Настраиваемые атрибуты (выше). |
host.name
|
Название хоста определяется в зависимости от источника данных, например, ЕдиныйАгент, Расширения или OpenTelemetry. Название хоста можно изменить в соответствии с правилами именования.
Обратите внимание, что это не идентификатор сущности типа |
AWS
| Атрибут | Описание |
|---|---|
dt.entity.ec2_instance
|
Идентификатор сущности типа EC2_INSTANCE.
|
dt.entity.aws_availability_zone
|
Идентификатор сущности типа AWS_AVAILABILITY_ZONE.
|
aws.availability_zone
|
Конкретная зона доступности в заданном регионе AWS. Например, us‑east‑1a.
|
aws.region
|
Определенное географическое местоположение облака AWS. Например, us‑east‑1.
|
aws.resource.id
|
Уникальный идентификатор ресурса. |
Azure
| Атрибут | Описание |
|---|---|
dt.entity.azure_vm
|
Идентификатор сущности типа AZURE_VM, извлеченный из instanceId поля метаданных экземпляра Azure.
|
dt.entity.azure_region
|
Идентификатор сущности типа AZURE_REGION.
|
azure.location
|
Определенное географическое местоположение ресурса облака Azure, извлеченное из location поля метаданных экземпляра Azure.
|
azure.vmid
|
Уникальный 128-битный идентификатор виртуальной машины Azure. |
Google Cloud
| Атрибут | Описание |
|---|---|
gcp.instance.id
|
Постоянный идентификатор, уникальный в пределах вашего проекта Google Cloud. |
gcp.project.id
|
Идентификатор проекта GCP, связанного с этим ресурсом. |
dt.entity.gcp_zone
|
Идентификатор сущности типа GCP_ZONE.
|
gcp.zone
|
Зона — это подмножество региона. Каждый регион состоит из трёх или более зон. Например, europe-west3-c.
|
gcp.region
|
Регион — это определённое географическое местоположение, где вы можете размещать свои ресурсы. Например, europe-west3.
|
OpenStack
| Атрибут | Описание |
|---|---|
openstack.availability_zone
|
Конкретная зона доступности в заданном регионе OpenStack. Например, us-east-1a.
|
openstack.instance_uuid
|
UUID экземпляра OpenStack. |
Kubernetes
| Атрибут | Описание |
|---|---|
k8s.cluster.uid
|
Поскольку название кластера Kubernetes не всегда доступно, Ключ-АСТРОМ идентифицирует кластер по UID пространства имён kube-system. Доступно только в развёртываниях Ключ-АСТРОМ Operator. |
k8s.node.name
|
Название узла Kubernetes. Доступно только в развертываниях Ключ-АСТРОМ Operator. |
BOSH
| Атрибут | Описание |
|---|---|
bosh.instance_id
|
Уникальный идентификатор, присваиваемый каждому развернутому экземпляру BOSH. |
bosh.availability_zone
|
Конкретное географическое местоположение BOSH. Например, us-east-1a.
|
bosh.name
|
Уникальный идентификатор развертывания или экземпляра. |
Нормализация атрибутов ресурсов
Для обеспечения согласованного и надёжного сбора метрик ко всем соответствующим внутренним ключам и значениям метрик применяется нормализация атрибутов ресурсов. Этот процесс помогает предотвратить потерю метрик из-за недопустимых или неправильно сформированных измерений.
Ключевые правила измерения
| Описание правила | Подробности |
|---|---|
| Недопустимые символы | Недопустимый символ или серия недопустимых символов заменяется одним символом подчёркивания _. Например, zaó$%ć заменяется на za_.
|
| Пустые ключи | Измерения без допустимых символов пропускаются. |
| Ограничение длины ключа | ЕдиныйАгент версии 1.317+ Макс. 350 символов (ранее макс. 100 символов)
|
Правила значений измерений
| Описание правила | Подробности |
|---|---|
| Разрешенные символы | Все неуправляющие символы (ASCII и Unicode) |
| Управляющие символы | Не допускается. Управляющий символ (то есть символ, используемый в качестве инструкции и не отображаемый; например, символ переноса строки, табуляции) или серия таких символов заменяется одним символом подчёркивания _.
|
| Ограничение длины значения | ЕдиныйАгент версии 1.313+ Макс. 2048 символов (ранее макс. 255 символов)
|
| Указанные значения | Если значение начинается и заканчивается на ", оно экранируется.
|
Пределы размеров
Для соответствия текущей спецификации используется определенная иерархия измерений и определенные пределы, позволяющие предотвратить предупреждения и падения показателей, вызванные превышением этих пределов.
По умолчанию глобальный предел измерения равен 100, а определяемый пользователем предел измерения составляет 40% от глобального предела.
