Настройка директории расширений
Проверить каталог обогащенияРасширение метаданных — дополнительная функция, которая улучшает сигналы мониторинга путем добавления дополнительных метаданных.
Чему вы научитесь
В этом руководстве объясняется, как настроить и включить обогащение метаданных в Ключ-АСТРОМ 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>" } |
Обратите внимание: файлы расширения будут использоваться для различных расширений автоматически, если включен ЕдиныйАгент. Если ЕдиныйАгент не включен, файлы расширения и их содержимое необходимо использовать вручную.