Перейти к основному содержимому
Перейти к основному содержимому

AWS Lambda

Этот руководство интегрирует:

✅ Логи✅ Метрики✅ Трейсы

Установка слоев OpenTelemetry Lambda​

Проект OpenTelemetry предоставляет отдельные слои lambda для:

  1. Автоматического инструментирования кода вашей Lambda функции с помощью авто-инструментирования OpenTelemetry.
  2. Пересылки собранных логов, метрик и трейсов в ClickStack.

Добавление слоя авто-инструментирования для конкретного языка​

Слои авто-инструментирования для конкретного языка автоматически инструментируют код вашей Lambda функции с помощью пакета авто-инструментирования OpenTelemetry для вашего конкретного языка.

Каждый язык и регион имеют свой собственный ARN слоя.

Если ваша Lambda уже инструментирована с использованием SDK OpenTelemetry, вы можете пропустить этот шаг.

Чтобы начать:

  1. В разделе Слои нажмите "Добавить слой"
  2. Выберите указать ARN и выберите правильный ARN в зависимости от языка, убедитесь, что вы заменили <region> на ваш регион (например, us-east-2):
arn:aws:lambda:<region>:184161586896:layer:opentelemetry-nodejs-0_7_0:1

Последние версии слоев можно найти в репозитории OpenTelemetry Lambda Layers на GitHub.

  1. Настройте следующие переменные окружения в вашей Lambda функции в разделе "Конфигурация" > "Переменные окружения".
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler
OTEL_PROPAGATORS=tracecontext
OTEL_TRACES_SAMPLER=always_on

Установка слоя коллектора OpenTelemetry Lambda​

Слой коллектора Lambda позволяет пересылать логи, метрики и трейсы из вашей Lambda функции в ClickStack без воздействия на время отклика из-за задержки экспортера.

Чтобы установить слой коллектора:

  1. В разделе Слои нажмите "Добавить слой"
  2. Выберите указать ARN и выберите правильный ARN в зависимости от архитектуры, убедитесь, что вы заменили <region> на ваш регион (например, us-east-2):
arn:aws:lambda:<region>:184161586896:layer:opentelemetry-collector-amd64-0_8_0:1
  1. Добавьте следующий файл collector.yaml в ваш проект, чтобы настроить коллектор для отправки в ClickStack:

# collector.yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 'localhost:4317'
      http:
        endpoint: 'localhost:4318'

processors:
  batch:
  decouple:

exporters:
  otlphttp:
    endpoint: "<YOU_OTEL_COLLECTOR_HTTP_ENDPOINT>
    headers:
      authorization: <YOUR_INGESTION_API_KEY>
    compression: gzip

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp]
    metrics:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp]
    logs:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp]
  1. Добавьте следующую переменную окружения:
OPENTELEMETRY_COLLECTOR_CONFIG_FILE=/var/task/collector.yaml

Проверка установки​

После развертывания слоев вы должны увидеть трейс, автоматически собранный из вашей Lambda функции в HyperDX. Процессоры decouple и batching могут вводить задержку в сбор телеметрии, поэтому трейсы могут отображаться с задержкой. Чтобы эмитировать пользовательские логи или метрики, вам нужно инструментировать ваш код с помощью специфичных для языка SDK OpenTelemetry.

Устранение неполадок​

Пользовательское инструментирование не отправляется​

Если вы не видите ваши вручную определенные трейсы или другие телеметрические данные, возможно, вы используете несовместимую версию пакета OpenTelemetry API. Убедитесь, что ваш пакет OpenTelemetry API не выше версии, включенной в AWS lambda.

Включение отладочных логов SDK​

Установите переменную окружения OTEL_LOG_LEVEL в DEBUG, чтобы включить отладочные логи из SDK OpenTelemetry. Это поможет убедиться, что слой авто-инструментирования правильно инструментирует ваше приложение.

Включение отладочных логов коллектора​

Для отладки проблем с коллектором вы можете включить отладочные логи, изменив файл конфигурации вашего коллектора, добавив экспортёр logging и установив уровень логирования телеметрии на debug, чтобы включить более подробную запись логов из слоя коллектора lambda.


# collector.yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 'localhost:4317'
      http:
        endpoint: 'localhost:4318'

exporters:
  logging:
    verbosity: detailed
  otlphttp:
    endpoint: "https://in-otel.hyperdx.io"
    headers:
      authorization: <YOUR_INGESTION_API_KEY>
    compression: gzip

service:
  telemetry:
    logs:
      level: "debug"
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp, logging]
    metrics:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp, logging]
    logs:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp, logging]