IKuznetsov: Новая страница: «Проверить каталог обогащенияРасширение метаданных — дополнительная функция, которая у...»

2025-12-03T18:05:11Z

Новая страница: «Проверить каталог обогащенияРасширение метаданных — дополнительная функция, которая у...»

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

Проверить каталог обогащенияРасширение метаданных — дополнительная функция, которая улучшает сигналы мониторинга путем добавления дополнительных метаданных.

== Чему вы научитесь ==
В этом руководстве объясняется, как настроить и включить обогащение метаданных в Ключ-АСТРОМ '''Operator'''. Следуя этому руководству, вы сможете:

* Проверить правильность применения обогащенных метаданных для различных вариантов использования.
* Связать логи и метрики с конкретными сущностями, такими как поды, процессы и т. д.

== Предустановка ==

* Ключ-АСТРОМ '''Operator''' установлен и запущен в вашем кластере '''Kubernetes'''.
* К вашему кластеру применен действительный '''DynaKube'''.

== Включение расширения метаданных ==
Чтобы включить расширение метаданных, измените '''YAML-файл DynaKube''':
{| class="wikitable"
|apiVersion: astromkey.com/v1beta5

kind: DynaKube

metadata:

name: <dk-name>

namespace: <dk-namespace>

spec:

apiUrl: <dk-apiUrl>

metadataEnrichment:

enabled: true
|}
При использовании дополнительных функций, таких как АктивныйШлюз или ЕдиныйАгент, ваша конфигурация может включать:
{| class="wikitable"
|apiVersion: astromkey.com/v1beta5

kind: DynaKube

metadata:

name: <dk-name>

namespace: <dk-namespace>

spec:

apiUrl: <dk-apiUrl>

metadataEnrichment:

enabled: true

oneAgent:

cloudNativeFullStack: (or other mode)

...

activeGate:

capabilities:

- routing

...
|}

== Использование селектора пространства имен ==
<code>Необязательно</code>

Чтобы ограничить расширение метаданных определенными пространствами имен, добавьте поле <code>namespaceSelector</code> в свою конфигурацию:
{| class="wikitable"
|metadataEnrichment:

enabled: true

namespaceSelector:

matchLabels:

team: finance
|}
Эта конфигурация применяет расширение метаданных только к пространствам имен, помеченным как <code>team=finance</code>.

== Проверка директории расширения ==
Убедитесь, что директория расширения в внедренных подах отражает настроенные вами атрибуты метаданных.

Файлы расширения хранятся в следующей директории: <code>/var/lib/astromkey/enrichment</code>

В этой директории хранятся файлы расширения <code>dt_metadata.json</code>и<code>dt_metadata.properties</code>

Файлы выглядят так:
{| class="wikitable"
!dt_metadata.properties
|-
|dt.entity.kubernetes_cluster=<kubernetes-cluster-id>

dt.kubernetes.cluster.id=<cluster-id>

dt.kubernetes.workload.kind=<workload-kind>

dt.kubernetes.workload.name=<workload-name>

k8s.cluster.name=<cluster-name>

k8s.cluster.uid=<cluster-uid>

k8s.container.name=<container-name>

k8s.namespace.name=<namespace-name>

k8s.node.name=<node-name>

k8s.pod.name=<pod-name>

k8s.pod.uid=<pod-uid>

k8s.workload.kind=<workload-kind>

k8s.workload.name=<workload-name>
|}
{| class="wikitable"
!dt_metadata.json
|-
|{

"dt.entity.kubernetes_cluster": "<kubernetes-cluster-id>",

"dt.kubernetes.cluster.id": "<cluster-id>",

"dt.kubernetes.workload.kind": "<workload-kind>",

"dt.kubernetes.workload.name": "<workload-name>",

"k8s.cluster.name": "<cluster-name>",

"k8s.cluster.uid": "<cluster-uid>",

"k8s.container.name": "<container-name>",

"k8s.namespace.name": "<namespace-name>",

"k8s.node.name": "<node-name>",

"k8s.pod.name": "<pod-name>",

"k8s.pod.uid": "<pod-uid>",

"k8s.workload.kind": "<workload-kind>",

"k8s.workload.name": "<workload-name>"

}
|}
Обратите внимание: файлы расширения будут использоваться для различных расширений автоматически, если включен ЕдиныйАгент. Если ЕдиныйАгент не включен, файлы расширения и их содержимое необходимо использовать вручную.

Настройка директории расширений - История изменений

IKuznetsov: Новая страница: «Проверить каталог обогащенияРасширение метаданных — дополнительная функция, которая у...»