Настройка директории расширений: различия между версиями

Материал из Документация Ключ-АСТРОМ
(Новая страница: «Проверить каталог обогащенияРасширение метаданных — дополнительная функция, которая у...»)
 
(нет различий)

Текущая версия на 18:05, 3 декабря 2025

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

Чему вы научитесь

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

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

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

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

Включение расширения метаданных

Чтобы включить расширение метаданных, измените YAML-файл DynaKube:

apiVersion: astromkey.com/v1beta5

kind: DynaKube

metadata:

  name: <dk-name>

  namespace: <dk-namespace>

spec:

  apiUrl: <dk-apiUrl>

  metadataEnrichment:

    enabled: true

При использовании дополнительных функций, таких как АктивныйШлюз или ЕдиныйАгент, ваша конфигурация может включать:

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

      ...

Использование селектора пространства имен

Необязательно

Чтобы ограничить расширение метаданных определенными пространствами имен, добавьте поле namespaceSelector в свою конфигурацию:

metadataEnrichment:

  enabled: true

  namespaceSelector:

    matchLabels:

      team: finance

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

Проверка директории расширения

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

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

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

Файлы выглядят так:

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>

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>"

}

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