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

2026-04-29T21:35:25Z

← Предыдущая		Версия 21:35, 29 апреля 2026
Строка 57:		Строка 57:
	\|-		\|-
	\|<code>dt.security_context</code>		\|<code>dt.security_context</code>
	\|Контекст безопасности используется для настройки прав доступа к отслеживаемым объектам ~~в Grail~~ и требует настройки. См. раздел '''Настраиваемые атрибуты''' (выше).		\|Контекст безопасности используется для настройки прав доступа к отслеживаемым объектам и требует настройки. См. раздел '''Настраиваемые атрибуты''' (выше).
	\|-		\|-
	\|<code>dt.cost.product</code>		\|<code>dt.cost.product</code>

IKuznetsov: Новая страница: «== Атрибуты ресурсов на уровне хоста == Все артефакты мониторинга, которые покидают данны...»

2025-09-04T16:44:23Z

Новая страница: «== Атрибуты ресурсов на уровне хоста == Все артефакты мониторинга, которые покидают данны...»

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

== Атрибуты ресурсов на уровне хоста ==
Все артефакты мониторинга, которые покидают данный хост, то есть имеют хост в качестве своего ресурса, обогащаются атрибутами ресурса на уровне хоста.

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

Вы также можете использовать некоторые атрибуты для создания политик управления доступом к данным. См. раздел [[Глобальный справочник полей]] и найдите поля, отмеченные тегом '''Разрешение.'''

Если у вас есть доступ к хосту с установленным ЕдинымАгентом, вы можете просмотреть <code>dt_host_metadata.json</code> и <code>dt_host_metadata.properties</code>, чтобы увидеть область обогащения атрибутов ресурсов, предоставляемую ЕдинымАгентом. Подробнее см. в разделе [[Расширение данных|Обогащение полученных данных измерениями, специфичными для Ключ-АСТРОМ]].

=== Пользовательские атрибуты уровня хоста ===
Вы можете создавать собственные атрибуты, настраивая теги «ключ-значение» и свойства через [[ЕдиныйАгент настройка через интерфейс командной строки|oneagentctl]] или через [[Удаленное управление конфигурацией ЕдиногоАгента и АктивногоШлюза|удалённое управление конфигурацией ЕдиныхАгентов и АктивныхШлюзов]]. Пользовательские теги и свойства, определённые таким образом, отображаются как простые атрибуты ресурсов первого уровня.

Ключевые теги без значений игнорируются.

Теги, назначенные с помощью '''автоматизированных правил''', '''переменных среды''', '''топологии и API Smartscape''', не включены.

Поскольку ключи зависят от вашей конфигурации, они не охватываются семантическим словарем.

Название тегов не могут содержать префиксы <code>dt.</code>, за исключением следующих тегов, которые зависят от вашей конфигурации:

* <code>dt.security_context</code>— атрибут для управления доступом к данным с помощью политик. См. раздел [[Предоставить доступ сущностям с контекстом безопасности|Предоставление доступа сущностям с контекстом безопасности]].
* <code>dt.cost.costcenter</code>- атрибут для назначения использования центру затрат. См. раздел [[Распределение затрат]].
* <code>dt.cost.product</code>— атрибут для назначения использования идентификатору продукта или приложения. См. раздел [[Распределение затрат]].

{| class="wikitable"
|Атрибуты из пользовательских свойств и тегов не переопределяют встроенные расширения, если у них такое же название. При создании пользовательских свойств и тегов проверьте [[глобальный справочник полей]], чтобы убедиться, что ваше название ещё не используется.
|}

==== Обработка конфликтов имен при объединении пользовательских свойств и тегов ====
Атрибуты ресурсов уровня хоста можно импортировать из пользовательских свойств и тегов хоста. Файлы <code>hostcustomproperties.conf</code> и <code>hostautotag.conf</code> являются источниками этих атрибутов. Если они следуют шаблону <code>key=value</code>, в обоих файлах могут существовать одни и те же ключи, но с разными значениями. При объединении содержимое из <code>hostautotag.conf</code> имеет приоритет над содержимым из <code>hostcustomproperties.conf</code>, поскольку теги имеют приоритет в случае конфликта имён.
{| class="wikitable"
|Если при объединении атрибутов ресурсов на разных уровнях возникает конфликт имен, приоритет имеет самый низкий уровень.
|}

=== Общие атрибуты уровня хоста ===
Все атрибуты ресурсов на уровне хоста следуют [[Семантический словарь|семантическому словарю]], если не указано иное.
{| class="wikitable"
!Атрибут
!Описание
|-
|Пользовательские теги хоста
|См. '''Пользовательские атрибуты''' (выше)
|-
|<code>dt.host_group.id</code>
|Обратите внимание на разницу между <code>dt.entity.host_group</code> и <code>dt.host_group.id</code>:

* <code>dt.host_group.id</code> - название группы хостов. Это понятный человеку идентификатор группы хостов, например <code>MyHostGroup</code>.
* <code>dt.entity.host_group</code> - идентификатор сущности группы хостов в модели Ключ-АСТРОМ. Идентификатор сущности не совпадает с понятным человеку идентификатором группы хостов. Он создаётся автоматически и имеет, например, формат <code>HOST_GROUP-008786529C8EE446</code>.

Более подробную информацию см. в разделе [[Организация среды с помощью групп хостов]].
|-
|<code>dt.entity.host</code>
|Идентификатор сущности типа <code>HOST</code>.
|-
|<code>dt.entity.host_group</code>
|Идентификатор сущности типа <code>HOST_GROUP</code>.
|-
|<code>dt.security_context</code>
|Контекст безопасности используется для настройки прав доступа к отслеживаемым объектам в Grail и требует настройки. См. раздел '''Настраиваемые атрибуты''' (выше).
|-
|<code>dt.cost.product</code>
|Этот атрибут используется для назначения идентификатора продукта или приложения и требует настройки. См. раздел '''Настраиваемые атрибуты''' (выше).
|-
|<code>host.name</code>
|Название хоста определяется в зависимости от источника данных, например, ЕдиныйАгент, Расширения или OpenTelemetry. Название хоста можно изменить в соответствии с правилами именования.

Обратите внимание, что это не идентификатор сущности типа <code>HOST</code> (<code>dt.entity.host</code>).
|}

==== AWS ====
{| class="wikitable"
!Атрибут
!Описание
|-
|<code>dt.entity.ec2_instance</code>
|Идентификатор сущности типа <code>EC2_INSTANCE</code>.
|-
|<code>dt.entity.aws_availability_zone</code>
|Идентификатор сущности типа <code>AWS_AVAILABILITY_ZONE</code>.
|-
|<code>aws.availability_zone</code>
|Конкретная зона доступности в заданном регионе AWS. Например, <code>us‑east‑1a</code>.
|-
|<code>aws.region</code>
|Определенное географическое местоположение облака AWS. Например, <code>us‑east‑1</code>.
|-
|<code>aws.resource.id</code>
|Уникальный идентификатор ресурса.
|}

==== Azure ====
{| class="wikitable"
!Атрибут
!Описание
|-
|<code>dt.entity.azure_vm</code>
|Идентификатор сущности типа <code>AZURE_VM</code>, извлеченный из <code>instanceId</code> поля метаданных экземпляра Azure.
|-
|<code>dt.entity.azure_region</code>
|Идентификатор сущности типа <code>AZURE_REGION</code>.
|-
|<code>azure.location</code>
|Определенное географическое местоположение ресурса облака Azure, извлеченное из <code>location</code> поля метаданных экземпляра Azure.
|-
|<code>azure.vmid</code>
|Уникальный 128-битный идентификатор виртуальной машины Azure.
|}

==== Google Cloud ====
{| class="wikitable"
!Атрибут
!Описание
|-
|<code>gcp.instance.id</code>
|Постоянный идентификатор, уникальный в пределах вашего проекта Google Cloud.
|-
|<code>gcp.project.id</code>
|Идентификатор проекта GCP, связанного с этим ресурсом.
|-
|<code>dt.entity.gcp_zone</code>
|Идентификатор сущности типа <code>GCP_ZONE</code>.
|-
|<code>gcp.zone</code>
|Зона — это подмножество региона. Каждый регион состоит из трёх или более зон. Например, <code>europe-west3-c</code>.
|-
|<code>gcp.region</code>
|Регион — это определённое географическое местоположение, где вы можете размещать свои ресурсы. Например, <code>europe-west3</code>.
|}

==== OpenStack ====
{| class="wikitable"
!Атрибут
!Описание
|-
|<code>openstack.availability_zone</code>
|Конкретная зона доступности в заданном регионе OpenStack. Например, <code>us-east-1a</code>.
|-
|<code>openstack.instance_uuid</code>
|UUID экземпляра OpenStack.
|}

==== Kubernetes ====
{| class="wikitable"
!Атрибут
!Описание
|-
|<code>k8s.cluster.uid</code>
|Поскольку название кластера Kubernetes не всегда доступно, Ключ-АСТРОМ идентифицирует кластер по UID пространства имён kube-system. Доступно только в развёртываниях Ключ-АСТРОМ Operator.
|-
|<code>k8s.node.name</code>
|Название узла Kubernetes. Доступно только в развертываниях Ключ-АСТРОМ Operator.
|}

==== BOSH ====
{| class="wikitable"
!Атрибут
!Описание
|-
|<code>bosh.instance_id</code>
|Уникальный идентификатор, присваиваемый каждому развернутому экземпляру BOSH.
|-
|<code>bosh.availability_zone</code>
|Конкретное географическое местоположение BOSH. Например, <code>us-east-1a</code>.
|-
|<code>bosh.name</code>
|Уникальный идентификатор развертывания или экземпляра.
|}

=== Нормализация атрибутов ресурсов ===
Для обеспечения согласованного и надёжного сбора метрик ко всем соответствующим внутренним ключам и значениям метрик применяется нормализация атрибутов ресурсов. Этот процесс помогает предотвратить потерю метрик из-за недопустимых или неправильно сформированных измерений.

==== Ключевые правила измерения ====
{| class="wikitable"
!Описание правила
!Подробности
|-
|Недопустимые символы
|Недопустимый символ или серия недопустимых символов заменяется одним символом подчёркивания <code>_</code>. Например, <code>zaó$%ć</code> заменяется на <code>za_</code>.
|-
|Пустые ключи
|Измерения без допустимых символов пропускаются.
|-
|Ограничение длины ключа
|<code>ЕдиныйАгент версии 1.317+</code> Макс. 350 символов (ранее макс. 100 символов)
|}

==== Правила значений измерений ====
{| class="wikitable"
!Описание правила
!Подробности
|-
|Разрешенные символы
|Все неуправляющие символы (ASCII и Unicode)
|-
|Управляющие символы
|Не допускается. Управляющий символ (то есть символ, используемый в качестве инструкции и не отображаемый; например, символ переноса строки, табуляции) или серия таких символов заменяется одним символом подчёркивания <code>_</code>.
|-
|Ограничение длины значения
|<code>ЕдиныйАгент версии 1.313+</code> Макс. 2048 символов (ранее макс. 255 символов)
|-
|Указанные значения
|Если значение начинается и заканчивается на <code>"</code>, оно экранируется.
|}

==== Пределы размеров ====
Для соответствия текущей спецификации используется определенная иерархия измерений и определенные пределы, позволяющие предотвратить предупреждения и падения показателей, вызванные превышением этих пределов.

По умолчанию глобальный предел измерения равен <code>100</code>, а определяемый пользователем предел измерения составляет '''40%''' от глобального предела.

Атрибуты ресурсов - История изменений

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

IKuznetsov: Новая страница: «== Атрибуты ресурсов на уровне хоста == Все артефакты мониторинга, которые покидают данны...»