IKuznetsov: Новая страница: «== Режимы развертывания == '''Collector''' может быть [https://opentelemetry.io/docs/collector/quick-start/ развернут], к...»

2025-10-01T16:31:06Z

Новая страница: «== Режимы развертывания == '''Collector''' может быть [https://opentelemetry.io/docs/collector/quick-start/ развернут], к...»

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

== Режимы развертывания ==
'''Collector''' может быть [https://opentelemetry.io/docs/collector/quick-start/ развернут], как автономный агент или шлюз.

Для наглядности на графиках ниже показаны режимы в настройке '''Kubernetes''', но эти же режимы можно использовать и за пределами '''Kubernetes'''.

=== Развертывание в виде агента ===
В качестве агента, '''Collector''' разворачивается либо вместе с приложением, либо на том же хосте, что и приложение. Он может получать телеметрические данные и дополнять их, например, тегами или информацией об инфраструктуре.

[[Файл:Image4070.png|граница]]

=== Развертывание в виде шлюза ===
В качестве шлюза один или несколько экземпляров '''Collector''' могут быть развернуты как отдельные сервисы. Этот '''Collector''' может быть развернут дополнительно, например, для кластера, региона или центра обработки данных. Балансировщик нагрузки может помочь масштабировать независимо работающие экземпляры '''Collector'''.

[[Файл:Image4071.png|граница]]

Также можно комбинировать эти режимы развертывания и объединять экземпляры '''Collector''' в цепочку. Учитывайте это при развертывании '''Collector''' в крупных средах.

== Варианты развертывания ==
Ключ-АСТРОМ '''Collector''' можно развернуть на следующих платформах:

* Kubernetes
* Docker
* Windows, macOS, and Linux
* Linux installer packages

=== Kubernetes ===
Для '''Kubernetes''' Ключ-АСТРОМ '''Collector''' можно развернуть следующими способами:

* OpenTelemetry Kubernetes Operator
* Helm
* Raw manifest

==== Подробности доступа к Ключ-АСТРОМ ====
Перед развертыванием '''Collector''' вам необходимо настроить необходимые секреты '''Kubernetes''' для данных доступа Ключ-АСТРОМ.

Используйте <code>kubectl</code> для создания секретов '''Kuberenetes''' для данных экспорта Ключ-АСТРОМ. Замените плейсхолдеры (обозначенные фигурными скобками) фактическими значениями '''URL-адреса экспорта''' и '''токена API'''.
{| class="wikitable"
|kubectl create secret generic astromkey-otelcol-dt-api-credentials --from-literal=DT_ENDPOINT={ENDPOINT_URL_HERE} --from-literal=DT_API_TOKEN={API_TOKEN_HERE}
|}

==== Варианты развертывания Kubernetes ====
В следующих примерах конфигураций используется ограничение ресурсов в '''512 мегабайт'''. Возможно, вам потребуется скорректировать значение <code>resources.limits.memory</code> в соответствии с вашим конкретным вариантом использования.

===== OpenTelemetry Operator =====

====== Предустановка ======
Если вы ещё не установили '''OpenTelemetry Operator''', сначала убедитесь, что установлен [https://cert-manager.io/docs/installation/ cert-manager]. После этого вы можете развернуть '''Operator''' с помощью следующей команды <code>kubectl</code>:
{| class="wikitable"
|kubectl apply -f <nowiki>https://github.com/open-telemetry/opentelemetry-operator/releases/download/v0.135.0/opentelemetry-operator.yaml</nowiki>
|}
После установки разверните Ключ-АСТРОМ '''Collector''' в режиме '''шлюза''' или '''агента,''' используя один из следующих примеров конфигурации. Сохраните его как <code>crd-astromkey-collector.yaml</code> и разверните с помощью <code>kubectl apply</code>.

Определение пользовательского ресурса

CRD-файл Operator Kubernetes можно найти на [https://github.com/open-telemetry/opentelemetry-operator/blob/v0.135.0/docs/api.md#opentelemetrycollector-1 GitHub].

'''Развертывание в качестве шлюза (Deployment)'''
{| class="wikitable"
|apiVersion: opentelemetry.io/v1beta1

kind: OpenTelemetryCollector

metadata:

name: astromkey-otel

spec:

envFrom:

- secretRef:

name: astromkey-otelcol-dt-api-credentials

env:

- name: MY_POD_IP

valueFrom:

fieldRef:

fieldPath: status.podIP

mode: "deployment"

image: "ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0"

resources:

limits:

memory: 512Mi

config:

receivers:

otlp:

protocols:

grpc:

endpoint: ${env:MY_POD_IP}:4317

http:

endpoint: ${env:MY_POD_IP}:4318

exporters:

otlphttp:

endpoint: "${env:DT_ENDPOINT}"

headers:

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

service:

pipelines:

traces:

receivers: [otlp]

processors: []

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: []

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: []

exporters: [otlphttp]
|}
'''Развертывание в качестве агента (DaemonSet)'''
{| class="wikitable"
|apiVersion: opentelemetry.io/v1beta1

kind: OpenTelemetryCollector

metadata:

name: astromkey-otel

spec:

envFrom:

- secretRef:

name: astromkey-otelcol-dt-api-credentials

env:

- name: MY_POD_IP

valueFrom:

fieldRef:

fieldPath: status.podIP

mode: "daemonset"

image: "ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0"

resources:

limits:

memory: 512Mi

config:

receivers:

otlp:

protocols:

grpc:

endpoint: ${env:MY_POD_IP}:4317

http:

endpoint: ${env:MY_POD_IP}:4318

exporters:

otlphttp:

endpoint: "${env:DT_ENDPOINT}"

headers:

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

service:

pipelines:

traces:

receivers: [otlp]

processors: []

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: []

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: []

exporters: [otlphttp]
|}

===== Helm =====
Выберите один из распространенных режимов развертывания Ключ-АСТРОМ '''Collector'''.

Представленные ниже диаграммы '''Helm''' используются для настройки <code>alternateConfig</code> '''Collector'''. При использовании этой записи конфигурация диаграммы '''Helm''' по умолчанию, а также возможно присутствующий объект <code>config</code>, будут проигнорированы.

'''Развертывание в качестве шлюза (Deployment)'''

Сохраните следующую конфигурацию YAML в <code>values-deployment.yaml</code>
{| class="wikitable"
|mode: deployment

image:

repository: ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector

tag: 0.37.0

command:

name: astromkey-otel-collector

extraEnvs:

- name: DT_API_TOKEN

valueFrom:

secretKeyRef:

name: astromkey-otelcol-dt-api-credentials

key: DT_API_TOKEN

- name: DT_ENDPOINT

valueFrom:

secretKeyRef:

name: astromkey-otelcol-dt-api-credentials

key: DT_ENDPOINT

resources:

limits:

memory: 512Mi

alternateConfig:

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

filelog: null

exporters:

otlphttp:

endpoint: "${env:DT_ENDPOINT}"

headers:

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

service:

extensions: [health_check]

pipelines:

traces:

receivers: [otlp]

processors: []

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: []

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: []

exporters: [otlphttp]
|}
Выполните следующие команды для настройки и установки чартов '''Helm'''.
{| class="wikitable"
|helm repo add open-telemetry <nowiki>https://open-telemetry.github.io/opentelemetry-helm-charts</nowiki>

helm repo update

helm upgrade -i astromkey-collector open-telemetry/opentelemetry-collector -f values-deployment.yaml
|}
'''Развертывание в качестве агента (DaemonSet)'''

Сохраните следующую конфигурацию YAML в <code>values-daemonset.yaml</code>
{| class="wikitable"
|mode: daemonset

image:

repository: ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector

tag: 0.37.0

command:

name: astromkey-otel-collector

extraEnvs:

- name: DT_API_TOKEN

valueFrom:

secretKeyRef:

name: astromkey-otelcol-dt-api-credentials

key: DT_API_TOKEN

- name: DT_ENDPOINT

valueFrom:

secretKeyRef:

name: astromkey-otelcol-dt-api-credentials

key: DT_ENDPOINT

resources:

limits:

memory: 512Mi

alternateConfig:

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

exporters:

otlphttp:

endpoint: "${env:DT_ENDPOINT}"

headers:

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

service:

extensions: [health_check]

pipelines:

traces:

receivers: [otlp]

processors: []

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: []

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: []

exporters: [otlphttp]
|}
Выполните следующие команды для настройки и установки чартов '''Helm'''.
{| class="wikitable"
|helm repo add open-telemetry <nowiki>https://open-telemetry.github.io/opentelemetry-helm-charts</nowiki>

helm repo update

helm upgrade -i astromkey-collector open-telemetry/opentelemetry-collector -f values-daemonset.yaml
|}

===== Raw manifest =====

====== Service ======
Используйте следующую конфигурацию <code>kubectl apply</code> для настройки определений служб и настройки правильных портов.
{| class="wikitable"
|apiVersion: v1

kind: Service

metadata:

name: astromkey-otel-collector

spec:

internalTrafficPolicy: Cluster

ipFamilies:

- IPv4

ipFamilyPolicy: SingleStack

ports:

- name: jaeger-compact

port: 6831

protocol: UDP

targetPort: 6831

- name: jaeger-grpc

port: 14250

protocol: TCP

targetPort: 14250

- name: jaeger-thrift

port: 14268

protocol: TCP

targetPort: 14268

- appProtocol: grpc

name: otlp

port: 4317

protocol: TCP

targetPort: 4317

- name: otlp-http

port: 4318

protocol: TCP

targetPort: 4318

- name: zipkin

port: 9411

protocol: TCP

targetPort: 9411

selector:

app.kubernetes.io/instance: astromkey-otel-collector

app.kubernetes.io/name: astromkey-otel-collector

sessionAffinity: None

type: ClusterIP
|}

====== ConfigMap ======
Создайте '''ConfigMap''', применив следующую конфигурацию <code>kubectl apply</code> для настройки конфигурации '''Collector'''.
{| class="wikitable"
|apiVersion: v1

kind: ConfigMap

metadata:

name: astromkey-otel-collector-config

data:

otel-collector-config: |

receivers:

otlp:

protocols:

grpc:

endpoint: ${env:MY_POD_IP}:4317

http:

endpoint: ${env:MY_POD_IP}:4318

exporters:

otlphttp:

endpoint: "${env:DT_ENDPOINT}"

headers:

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

service:

pipelines:

traces:

receivers: [otlp]

processors: []

exporters: [otlphttp]

metrics:

receivers: [otlp]

processors: []

exporters: [otlphttp]

logs:

receivers: [otlp]

processors: []

exporters: [otlphttp]
|}

====== Manifest ======
Примените следующую конфигурацию манифеста <code>kubectl apply</code> для создания развертывания Ключ-АСТРОМ '''Collector''' в режиме '''шлюза'''.
{| class="wikitable"
|apiVersion: apps/v1

kind: Deployment

metadata:

name: astromkey-otel-collector

spec:

selector:

matchLabels:

app.kubernetes.io/name: astromkey-otel-collector

replicas: 1

template:

metadata:

labels:

app.kubernetes.io/instance: astromkey-otel-collector

app.kubernetes.io/name: astromkey-otel-collector

spec:

#You may have to configure RBAC to grant proper permissions for enriching data

#serviceAccountName: astromkey-otel-collector

containers:

- name: astromkey-otel-collector

args: ["--config", "/conf/otel-collector-config.yaml"]

env:

- name: MY_POD_IP

valueFrom:

fieldRef:

apiVersion: v1

fieldPath: status.podIP

- name: DT_ENDPOINT

valueFrom:

secretKeyRef:

name: astromkey-otelcol-dt-api-credentials

key: DT_ENDPOINT

- name: DT_API_TOKEN

valueFrom:

secretKeyRef:

name: astromkey-otelcol-dt-api-credentials

key: DT_API_TOKEN

image: ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0

resources:

limits:

memory: 512Mi

ports:

- containerPort: 8888 # Default endpoint for querying metrics of prometheus exporter.

volumeMounts:

- name: astromkey-otel-collector-config

mountPath: /conf

volumes:

- configMap:

name: astromkey-otel-collector-config

items:

- key: otel-collector-config

path: otel-collector-config.yaml

name: astromkey-otel-collector-config
|}

=== Docker ===
Выполните следующую команду, чтобы загрузить образ Ключ-АСРОМ '''Collector''':
{| class="wikitable"
|docker pull ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0
|}
Затем убедитесь, что файл конфигурации '''Collector''' существует в текущей рабочей директории, и запустите образ '''Collector''' с помощью следующей команды:
{| class="wikitable"
|docker run -v $(pwd)/otel-collector-config.yaml:/etc/otelcol/otel-collector-config.yaml ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0 --config=/etc/otelcol/otel-collector-config.yaml
|}
Параметр <code>-v</code> сопоставляет локальный файл конфигурации с заданным путем контейнера, который впоследствии передается параметру <code>--config</code>.

Обязательно сопоставьте все необходимые сетевые порты с [https://docs.docker.com/reference/cli/docker/container/run/#publish параметром <code>-p</code>]. Например, если вы принимаете запросы '''OTLP''' '''gRPC''' на порту по умолчанию, необходимо указать порт '''4317'''. Для '''OTLP''' по '''HTTP''' укажите порт '''4318'''.

==== Docker Compose ====
Используйте следующую конфигурацию в файле '''Compose''' для развертывания и запуска образа '''Collector''':
{| class="wikitable"
|version: "3"

services:

collector:

image: ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0

command: ["--config=/etc/otelcol/otel-collector-config.yaml"]

volumes:

- ./otel-collector-config.yaml:/etc/otelcol/otel-collector-config.yaml

ports:

- "4317:4317" # OTLP gRPC

- "4318:4318" # OTLP HTTP
|}
В примере выше <code>ports</code> настроены для '''gRPC''' и '''HTTP'''. Измените список портов в соответствии с вашим конкретным вариантом использования.

=== Windows, macOS и Linux ===
Чтобы установить исполняемый файл '''Collector''' вручную

# Загрузите [https://github.com/Dynatrace/dynatrace-otel-collector/releases/v0.37.0 astromkey-otel-collector] для вашей операционной системы с '''GitHub'''.
# Распакуйте архивный файл.
# Настройте нужную конфигурацию и сохраните ее в <code>otel-collector-config.yaml</code>.
# Запустите исполняемый файл <code>astromkey-otel-collector</code> и передайте путь к файлу конфигурации с помощью параметра <code>--config</code>.

{| class="wikitable"
|./astromkey-otel-collector --config=$(pwd)/otel-collector-config.yaml
|}

=== Пакеты установщиков Linux ===
astromkey также предоставляет установочные пакеты '''DEB''' и '''RPM''' для систем '''Linux''' на архитектурах '''x86-64''' и '''ARM64'''.
{| class="wikitable"
|Требуемая система инициализации

Для пакетов установки требуется, чтобы '''Systemd''' была активной системой инициализации.
|}
Чтобы развернуть Collector с помощью установочного пакета, загрузите [https://github.com/Dynatrace/dynatrace-otel-collector/releases/v0.37.0 astromkey-otel-collector] для вашей операционной системы с '''GitHub''' и установите его, используя права '''root''' и следующие команды.

Замените следующие два заполнителя в командах их фактическим содержимым:

* <code><VERSION></code> с тегом версии загрузки
* <code><ARCH></code> с тегом архитектуры системы (то есть, <code>x86_64</code>или <code>arm64</code>) загрузки

==== Debian (.deb) ====
{| class="wikitable"
|apt-get update

dpkg -i astromkey-otel-collector_<VERSION>_Linux_<ARCH>.deb
|}

==== Red Hat (.rpm) ====
{| class="wikitable"
|yum update

rpm -ivh astromkey-otel-collector_<VERSION>_Linux_<ARCH>.rpm
|}

==== Конфигурация сервиса ====
При первом запуске служба может не запуститься, если файл конфигурации ещё не установлен. По умолчанию сборщик пытается найти файл в папке <code>/etc/astromkey-otel-collector/config.yaml</code>.

После изменения конфигурации обязательно перезапустите службу, используя следующую команду и привилегии '''root''':
{| class="wikitable"
|systemctl restart astromkey-otel-collector
|}

==== Статус обслуживания ====
Чтобы просмотреть текущий статус службы '''Collector''', выполните следующую команду с правами '''root''':
{| class="wikitable"
|systemctl status astromkey-otel-collector
|}
Чтобы проверить вывод службы '''Collector''', выполните следующую команду с правами '''root''':
{| class="wikitable"
|journalctl -u astromkey-otel-collector
|}

== Реестры образов контейнеров ==
Образы контейнеров для дистрибутива Ключ-АСТРОМ '''OpenTelemetry Collector''' доступны в

* [https://github.com/Dynatrace/dynatrace-otel-collector/pkgs/container/dynatrace-otel-collector%2Fdynatrace-otel-collector Реестр контейнеров GitHub (GHCR)]
** <code>ghcr.io/astromkey/astromkey-otel-collector/astromkey-otel-collector:0.37.0</code>
* [https://gallery.ecr.aws/dynatrace/dynatrace-otel-collector Реестр контейнеров Amazon Elastic (Amazon ECR)]
** <code>public.ecr.aws/astromkey/astromkey-otel-collector:0.37.0</code>
* [https://hub.docker.com/r/dynatrace/dynatrace-otel-collector Реестр контейнеров Docker Hub]
** <code>astromkey/astromkey-otel-collector:0.37.0</code>

Развертывание Collector - История изменений

IKuznetsov: Новая страница: «== Режимы развертывания == '''Collector''' может быть [https://opentelemetry.io/docs/collector/quick-start/ развернут],﻿ к...»

IKuznetsov: Новая страница: «== Режимы развертывания == '''Collector''' может быть [https://opentelemetry.io/docs/collector/quick-start/ развернут], к...»