IKuznetsov: /* Демо конфигурация */

2025-10-06T20:22:19Z

Демо конфигурация

← Предыдущая версия		Версия от 20:22, 6 октября 2025
Строка 354:		Строка 354:

	Мы также настраиваем [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/transformprocessor процессор <code>transform</code>] на автоматическое добавление информации о кластере '''Kubernetes''' в качестве атрибутов ресурсов для всех сигналов телеметрии.		Мы также настраиваем [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/transformprocessor процессор <code>transform</code>] на автоматическое добавление информации о кластере '''Kubernetes''' в качестве атрибутов ресурсов для всех сигналов телеметрии.

			=== Экспортеры ===
			В разделе <code>exporters</code> мы указываем [https://github.com/open-telemetry/opentelemetry-collector/tree/v0.136.0/exporter/otlphttpexporter экспортер <code>otlphttp</code>] по умолчанию и настраиваем его с помощью '''URL-адреса''' нашего '''API''' Ключ-АСТРОМ и требуемого токена аутентификации.

			Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code> и <code>Authorization</code>.

			* <code>DT_ENDPOINT</code> содержит базовый '''URL-адрес''' конечной точки '''API''' Ключ-АСТРОМ (например, <code><nowiki>https://{your-environment-id}.live.astromkey.com/api/v2/otlp</nowiki></code>)
			* <code>DT_API_TOKEN</code> содержит токен API

			=== Сервисные контейнеры ===
			В разделе <code>service</code> мы собираем объекты приёмника, процессора и экспортёра в контейнеры для трассировок, метрик и логов. Эти контейнеры позволяют нам отправлять сигналы '''OpenTelemetry''' через экземпляр '''Collector''' и автоматически дополнять их дополнительной информацией, специфичной для '''Kubernetes'''.

IKuznetsov: Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для обогаще...»

2025-10-06T20:19:58Z

Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для обогаще...»

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

В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для обогащения телеметрических данных '''OTLP''' дополнительными метаданными '''Kubernetes'''. Это включает, например, сведения о поде, развертывании и кластере, что позволяет Ключ-АСТРОМ корректно сопоставлять предоставленные телеметрические данные с соответствующими сущностями в Ключ-АСТРОМ.

Ключ-АСТРОМ рекомендует использовать АктивныйШлюз для улучшения мониторинга состояния и производительности кластера '''Kubernetes'''. Развертывание АктивныйШлюз позволяет приложению Ключ-АСТРОМ '''Kubernetes''' визуализировать данные '''Kubernetes''' и '''OpenTelemetry''' и сопоставлять их с соответствующими сущностями '''Kubernetes'''.

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

* <code>необязательно</code> Развернутый АктивныйШлюз для мониторинга '''API''' '''Kubernetes'''
* Один из следующих дистрибутивов '''Collector''' с процессорами [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/k8sattributesprocessor Kubernetes Attributes] и [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/transformprocessor Transform] :
** [[Collector Ключ-АСТРОМ|'''Collector''' Ключ-АСТРОМ]]
** [[Collector Ключ-АСТРОМ|OpenTelemetry Contrib]]
** Пользовательская версия [[Collector Ключ-АСТРОМ|Builder]]
* '''Collector''' развернут в режиме [[Развертывание Collector|агента]]
* [[Экспорт с помощью OTLP|URL-адрес API]] вашей среды Ключ-АСТРОМ
* [[Экспорт с помощью OTLP|API-токен]] с соответствующей областью доступа
* '''Kubernetes''' настроен на требуемый контроль доступа на основе ролей

Информацию о настройке '''Collector''' с использованием указанной ниже конфигурации см. в разделах [[Развертывание Collector|Развертывание коллектора]] и [[Настройка Collector|Конфигурация коллектора]].

== Демо конфигурация ==
<u>Учетная запись службы</u>

Помимо конфигурации '''Collector''', обязательно обновите конфигурацию '''Kubernetes''', чтобы она соответствовала имени учетной записи службы, используемому в '''файле RBAC''' (см. записи для [https://github.com/open-telemetry/opentelemetry-helm-charts/blob/opentelemetry-collector-0.100.0/charts/opentelemetry-collector/values.yaml#L184-L191 Helm], [https://github.com/open-telemetry/opentelemetry-operator/blob/v0.136.0/docs/api.md#opentelemetrycollectorspec Operator]).
{| class="wikitable"
|extensions:

health_check:

endpoint: ${env:MY_POD_IP}:13133

receivers:

otlp:

protocols:

grpc:

endpoint: ${env:MY_POD_IP}:4317

http:

endpoint: ${env:MY_POD_IP}:4318

processors:

k8sattributes:

extract:

metadata:

- k8s.pod.name

- k8s.pod.uid

- k8s.pod.ip

- k8s.deployment.name

- k8s.replicaset.name

- k8s.statefulset.name

- k8s.daemonset.name

- k8s.job.name

- k8s.cronjob.name

- k8s.namespace.name

- k8s.node.name

- k8s.cluster.uid

- k8s.container.name

annotations:

- from: pod

key_regex: metadata.astromkey.com/(.*)

tag_name: $$1

- from: pod

key: metadata.astromkey.com

tag_name: metadata.astromkey.com

pod_association:

- sources:

- from: resource_attribute

name: k8s.pod.name

- from: resource_attribute

name: k8s.namespace.name

- sources:

- from: resource_attribute

name: k8s.pod.ip

- sources:

- from: resource_attribute

name: k8s.pod.uid

- sources:

- from: connection

transform:

error_mode: ignore

trace_statements: &astromkey_transformations

# Set attributes taken from k8s metadata.

- context: resource

statements:

- set(attributes["k8s.workload.kind"], "job") where IsString(attributes["k8s.job.name"])

- set(attributes["k8s.workload.name"], attributes["k8s.job.name"]) where IsString(attributes["k8s.job.name"])

- set(attributes["k8s.workload.kind"], "cronjob") where IsString(attributes["k8s.cronjob.name"])

- set(attributes["k8s.workload.name"], attributes["k8s.cronjob.name"]) where IsString(attributes["k8s.cronjob.name"])

- set(attributes["k8s.workload.kind"], "daemonset") where IsString(attributes["k8s.daemonset.name"])

- set(attributes["k8s.workload.name"], attributes["k8s.daemonset.name"]) where IsString(attributes["k8s.daemonset.name"])

- set(attributes["k8s.workload.kind"], "statefulset") where IsString(attributes["k8s.statefulset.name"])

- set(attributes["k8s.workload.name"], attributes["k8s.statefulset.name"]) where IsString(attributes["k8s.statefulset.name"])

- set(attributes["k8s.workload.kind"], "replicaset") where IsString(attributes["k8s.replicaset.name"])

- set(attributes["k8s.workload.name"], attributes["k8s.replicaset.name"]) where IsString(attributes["k8s.replicaset.name"])

- set(attributes["k8s.workload.kind"], "deployment") where IsString(attributes["k8s.deployment.name"])

- set(attributes["k8s.workload.name"], attributes["k8s.deployment.name"]) where IsString(attributes["k8s.deployment.name"])

# remove the delete statements if you want to preserve these attributes

- delete_key(attributes, "k8s.deployment.name")

- delete_key(attributes, "k8s.replicaset.name")

- delete_key(attributes, "k8s.statefulset.name")

- delete_key(attributes, "k8s.daemonset.name")

- delete_key(attributes, "k8s.cronjob.name")

- delete_key(attributes, "k8s.job.name")

- context: resource

statements:

- merge_maps(attributes, ParseJSON(attributes["metadata.astromkey.com"]), "upsert") where IsMatch(attributes["metadata.astromkey.com"], "^\\{")

- delete_key(attributes, "metadata.astromkey.com")

metric_statements: *astromkey_transformations

log_statements: *astromkey_transformations

exporters:

otlphttp:

endpoint: ${env:DT_ENDPOINT}

headers:

Authorization: "Api-Token ${env:DT_API_TOKEN}"

service:

extensions:

- health_check

pipelines:

traces:

receivers: [otlp]

processors: [k8sattributes, transform]

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: [k8sattributes, transform]

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: [k8sattributes, transform]

exporters: [otlphttp]
|}

== Конфигурация Kubernetes ==
Настройте следующий файл <code>rbac.yaml</code> с вашим экземпляром '''Kubernetes''', чтобы разрешить сборщику использовать '''API''' '''Kubernetes''' с типом аутентификации учетной записи службы.
{| class="wikitable"
|apiVersion: v1

kind: ServiceAccount

metadata:

labels:

app: collector

name: collector

---

apiVersion: rbac.authorization.k8s.io/v1

kind: ClusterRole

metadata:

name: collector

labels:

app: collector

rules:

- apiGroups:

- <nowiki>''</nowiki>

resources:

- 'pods'

- 'namespaces'

verbs:

- 'get'

- 'watch'

- 'list'

- apiGroups:

- 'apps'

resources:

- 'replicasets'

verbs:

- 'get'

- 'list'

- 'watch'

- apiGroups:

- 'extensions'

resources:

- 'replicasets'

verbs:

- 'get'

- 'list'

- 'watch'

---

apiVersion: rbac.authorization.k8s.io/v1

kind: ClusterRoleBinding

metadata:

name: collector

labels:

app: collector

roleRef:

apiGroup: rbac.authorization.k8s.io

kind: ClusterRole

name: collector

subjects:

- kind: ServiceAccount

name: collector

namespace: default
|}

== Компоненты ==
Для нашей конфигурации мы настроили следующие компоненты.

=== Приемники ===
В разделе <code>receivers</code> мы указываем стандартный приемник <code>otlp</code>, как активный компонент приемника для нашего экземпляра '''Collector'''.

Это сделано в основном для демонстрационных целей. Вы можете указать здесь любой другой допустимый получатель (например, <code>zipkin</code>).

=== Процессоры ===
В разделе <code>processors</code> мы указываем [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/k8sattributesprocessor процессор <code>k8sattributes</code>] со следующими параметрами:

* <code>extract</code>— Указывает, какую информацию следует извлечь.
* <code>pod_association</code>— Указывает, как информация о модуле связана с атрибутами.

Обратите внимание, что атрибут <code>k8s.container.name</code> будет извлечён только в том случае, если модуль, от которого был получен входящий сигнал, содержит только один контейнер, или если принятый сигнал содержит атрибут ресурса <code>k8s.container.id</code>. В противном случае процессор <code>k8sattributes</code> не сможет правильно связать нужный контейнер.

Ключ-АСТРОМ '''Operator''' дополняет данные '''OpenTelemetry''' из модулей '''Kubernetes''' аннотациями <code>metadata.astromkey.com</code>. При наличии этих аннотаций процессор <code>k8sattributes</code> их извлекает.

Мы также настраиваем [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/transformprocessor процессор <code>transform</code>] на автоматическое добавление информации о кластере '''Kubernetes''' в качестве атрибутов ресурсов для всех сигналов телеметрии.

Обогащение из Kubernetes - История изменений

IKuznetsov: /* Демо конфигурация */

IKuznetsov: Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для обогаще...»