IKuznetsov: Новая страница: «`cloudNativeFullStack` `applicationMonitoring` `metadataEnrichment` В рамках мониторинга кластера ''...»

2025-11-24T17:45:32Z

Новая страница: «<code>cloudNativeFullStack</code> <code>applicationMonitoring</code> <code>metadataEnrichment</code> В рамках мониторинга кластера ''...»

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

<code>cloudNativeFullStack</code>

<code>applicationMonitoring</code>

<code>metadataEnrichment</code>

В рамках мониторинга кластера '''Kubernetes''' с использованием облачного полного стека или мониторинга приложений и применения обогащения метаданных вы можете захотеть ограничиться определенными пространствами имен и модулями.

{| class="wikitable"
|По умолчанию Ключ-АСТРОМ Operator внедряется во все пространства имен, за исключением:

* Пространства имен с префиксом <code>kube-</code> или <code>openshift-</code>.
* Пространство имен, в котором был установлен Ключ-АСТРОМ Operator.

Мы настоятельно рекомендуем использовать поля <code>namespaceSelector</code> (см. ниже), чтобы сохранять полный контроль над тем, что вводится.
|}

== Мониторинг определенных пространств имен ==
Чтобы настроить Ключ-АСТРОМ Operator для внедрения ЕдиногоАгента только в определенные пространства имен или применения обогащения метаданных, задайте параметр <code>namespaceSelector</code> в пользовательском ресурсе '''DynaKube'''.
{| class="wikitable"
|Описанные здесь аннотации и <code>namespaceSelector</code> влияют только на внедрение, выполняемое веб-перехватчиком Ключ-АСТРОМ Operator. Они не влияют на возможности мониторинга Kubernetes API через АктивныйШлюз или на мониторинг на уровне хоста через ЕдиныйАгент.
|}
Для получения дополнительной информации см. [[Параметры DynaKube для Ключ-АСТРОМ Operator]] (поля <code>.spec.metadataEnrichment</code>, <code>.spec.oneAgent.cloudNativeFullStack</code> и <code>.spec.oneAgent.applicationMonitoring</code>).

1. Обозначьте свои пространства имен.
{| class="wikitable"
!Kubernetes
!OpenShift
|-
|kubectl label namespace <my_namespace> dt-monitoring=true
|oc label namespace <my_namespace> dt-monitoring=true
|}
2. Измените DynaKube, добавив <code>namespaceSelector</code>, чтобы указать метку для мониторинга.
{| class="wikitable"
!Обогащение метаданных
!Облачный полнофункциональный мониторинг
!Мониторинг приложений
|-
|spec:

metadataEnrichment:

namespaceSelector:

matchLabels:

dt-monitoring: "true"
|spec:

oneAgent:

cloudNativeFullStack:

namespaceSelector:

matchLabels:

dt-monitoring: "true"
|spec:

oneAgent:

applicationMonitoring:

namespaceSelector:

matchLabels:

dt-monitoring: "true"
|}
Более подробную информацию о настройке меток для выборочного мониторинга см. в разделе [https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#resources-that-support-set-based-requirements Метки и селекторы].

Чтобы добавить исключения для определенных модулей в выбранных пространствах имен, вы можете '''аннотировать соответствующие модули''' (ниже).

== Исключение определенных пространств имен ==
Чтобы исключить определенные пространства имен из мониторинга, измените пользовательский ресурс '''DynaKube''' следующим образом.

* <code>key</code> определяет ключ метки. Начиная с '''Kubernetes''' версии 1.22, к пространствам имен добавляется метка по умолчанию <code>kubernetes.io/metadata.name</code>.
* <code>values</code> определить значение метки.

<u>Пример с меткой Kubernetes по умолчанию</u>

Если вы запустите <code>kubectl describe namespace astromkey</code>, вы увидите:
{| class="wikitable"
|metadata:

name: astromkey

labels:

kubernetes.io/metadata.name=astromkey
|}
Допустимым примером селектора для исключения <code>astromkey</code> будет:
{| class="wikitable"
|...

namespaceSelector:

matchExpressions:

- key: kubernetes.io/metadata.name

operator: NotIn

values:

- astromkey
|}
Веб-перехватчик внедрит каждое пространство имен, которое соответствует всем <code>namespaceselector</code>.

Более подробную информацию см. в разделе [https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#resources-that-support-set-based-requirements Ресурсы, поддерживающие требования на основе наборов].

== Исключение определенных модуле в отслеживаемых пространствах имен ==
Чтобы исключить определенные модули из отслеживаемых пространств имен, аннотируйте модули соответствующим образом.
{| class="wikitable"
|...

metadata:

annotations:

...

oneagent.astromkey.com/inject: "false"
|}
В число доступных аннотаций для детального управления входят:

* <code>astromkey.com/inject</code>: отключает все внедрения при установке значения <code>false</code>. Однако установка значения <code>true</code> не даст никакого эффекта; аннотацию можно использовать только для исключения модулей из внедрений.
* <code>metadata-enrichment.astromkey.com/inject</code>: Предотвращает добавление файла обогащения метрики, когда <code>false</code>.
* <code>oneagent.astromkey.com/inject</code>: Отключает модификации ЕдиногоАгента, если установлено значение <code>false</code>.

== Исключение определенных контейнеров из контролируемых контейнеров ==
<code>Ключ-АСТРОМ Operator версии 1.0.0+</code>

Чтобы исключить определенные образы контейнеров в отслеживаемых пространствах имен, соответствующим образом аннотируйте модули или '''DynaKube''' (это может быть полезно, например, для исключения контейнеров '''side''' '''car''').
{| class="wikitable"
|...

metadata:

annotations:

...

container.inject.astromkey.com/<container-name>: "false"
|}
Эту аннотацию можно применять на уровне '''DynaKube''' (влияя на все модули) или на уровне отдельного модуля (влияя только на указанный модуль).

== Мониторинг только определенных модулей ==
<code>Ключ-АСТРОМ Operator версии 0.8.0+</code>

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

1. Отключите функцию автоматического внедрения для развертывания '''DynaKube''' в вашем кластере.
{| class="wikitable"
|apiVersion: astromkey.com/v1beta5

kind: DynaKube

metadata:

name: dynakube

namespace: astromkey

annotations:

feature.astromkey.com/automatic-injection: "false"

spec:

oneAgent:

cloudNativeFullStack:

namespaceSelector:

matchLabels:

dt-monitoring: "true"

...
|}
2. Используйте селекторы меток или ручные аннотации для пространств имен, которые вы хотите выборочно отслеживать.
{| class="wikitable"
|kubectl label namespace <my_namespace> dt-monitoring=true
|}
3. Отметьте модули, которые вы собираетесь отслеживать.

* Работает с аннотациями <code>oneagent.astromkey.com/inject</code> и <code>metadata-enrichment.astromkey.com/inject</code>.

{| class="wikitable"
|...

metadata:

annotations:

...

oneagent.astromkey.com/inject: "true"
|}

Настройка мониторинга пространств имен и модулей - История изменений

IKuznetsov: Новая страница: «cloudNativeFullStack applicationMonitoring metadataEnrichment В рамках мониторинга кластера ''...»

IKuznetsov: Новая страница: «`cloudNativeFullStack` `applicationMonitoring` `metadataEnrichment` В рамках мониторинга кластера ''...»