#Параметры Instrumentation

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

#Базовая конфигурация Instrumentation

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

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. В следующей таблице перечислены протоколы по умолчанию.

#Внедрение на основе аннотаций

Чтобы включить автоинструментирование для вашего приложения, добавьте соответствующую аннотацию к вашему pod или 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 в ваш pod.

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

#Instrumentation на уровне namespace

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

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

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

Вы можете указать requests и limits ресурсов для init container instrumentation:

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

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

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

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

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

#Выборочное instrumentation

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

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

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

#Справочник по Instrumentation

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

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

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