#Варианты инструментирования

Пользовательский ресурс Instrumentation предоставляет различные параметры конфигурации для управления автоматическим инструментированием ваших приложений. Эти параметры позволяют настроить поведение инструментирования, указать требования к ресурсам и задать настройки, специфичные для конкретных языков программирования.

#Базовая конфигурация инструментирования

Пользовательский ресурс Instrumentation (CR) определяет, как собираются телеметрические данные из ваших приложений. Он предоставляет настройки для конечной точки экспортера, распространения контекста, выборки и инструментирования, специфичного для языка.

apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: my-instrumentation
spec:
  env:
    - name: OTEL_EXPORTER_OTLP_TIMEOUT
      value: "20"
  exporter:
    endpoint: 'http://otel-collector.otel-collector.svc:4317'
  propagators:
    - tracecontext
    - baggage
    - b3multi
  sampler:
    type: parentbased_traceidratio
    argument: "0.25"
  python:
    env:
      - name: OTEL_EXPORTER_OTLP_ENDPOINT
        value: 'http://otel-collector.otel-collector.svc:4318'
  dotnet:
    env:
      - name: OTEL_EXPORTER_OTLP_ENDPOINT
        value: 'http://otel-collector.otel-collector.svc:4318'
  go:
    env:
      - name: OTEL_EXPORTER_OTLP_ENDPOINT
        value: 'http://otel-collector.otel-collector.svc:4318'

#Параметры CR Instrumentation

В следующей таблице описаны параметры, которые можно настроить в пользовательском ресурсе Instrumentation.

#Протоколы автоинструментирования по умолчанию

Каждый язык автоинструментирования использует протокол по умолчанию для экспорта телеметрии в Collector. В таблице перечислены протоколы по умолчанию.

#Инъекция на основе аннотаций

Чтобы включить автоинструментирование для вашего приложения, добавьте соответствующую аннотацию к вашему поду или namespace:

apiVersion: v1
kind: Pod
metadata:
  name: myapp
  annotations:
    instrumentation.opentelemetry.io/inject-java: "true"
spec:
  containers:
  - name: app
    image: myapp:latest

#Инъекция, специфичная для языка

Формат аннотации: instrumentation.opentelemetry.io/inject-<language>, где <language> может быть:

• apache-httpd — для Apache HTTP Server
• dotnet — для приложений .NET
• go — для приложений Go
• java — для приложений Java
• nodejs — для приложений Node.js
• python — для приложений Python

#Инъекция переменных SDK

Вы можете использовать аннотацию instrumentation.opentelemetry.io/inject-sdk, чтобы указать OpenTelemetry Operator внедрить переменные окружения SDK в ваш под.

#Поддерживаемые значения для аннотаций инъекции

#Инструментирование на уровне namespace

Вы можете применить инструментирование ко всем подам в namespace, добавив аннотацию к самому namespace:

apiVersion: v1
kind: Namespace
metadata:
  name: production
  annotations:
    instrumentation.opentelemetry.io/inject-java: "true"

#Конфигурация ресурсов

Вы можете указать запросы и лимиты ресурсов для init-контейнера инструментирования:

spec:
  resource:
    limits:
      cpu: 500m
      memory: 128Mi
    requests:
      cpu: 100m
      memory: 64Mi

#Внедрение переменных окружения

CR Instrumentation позволяет внедрять дополнительные переменные окружения в инструментируемые контейнеры:

spec:
  env:
    - name: OTEL_TRACES_EXPORTER
      value: otlp
    - name: OTEL_METRICS_EXPORTER
      value: otlp
    - name: OTEL_LOGS_EXPORTER
      value: otlp

Эти переменные окружения автоматически добавляются в контейнер приложения при внедрении инструментирования.

#Выборочное инструментирование

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

metadata:
  annotations:
    instrumentation.opentelemetry.io/inject-java: "true"
    instrumentation.opentelemetry.io/container-names: "app,sidecar"

Эта аннотация гарантирует, что инструментирование применяется только к указанным контейнерам, оставляя остальные без изменений.

#Ссылка на Instrumentation

Чтобы сослаться на конкретный CR Instrumentation, вы можете использовать полный формат ссылки в аннотации:

metadata:
  annotations:
    instrumentation.opentelemetry.io/inject-java: "namespace/instrumentation-name"

Это позволяет использовать разные конфигурации инструментирования для различных приложений в одном namespace.