AWS Lambda と OpenTelemetry

OpenTelemetry は、テレメトリーデータの収集とルーティングのための標準化されたプロトコルとツールを IT チームに提供するオープンソースの可観測性フレームワークです。

このページでは、Datadog Serverless Monitoring for AWS Lambda での OpenTelemetry の使用について説明します。非サーバーレス環境での OpenTelemetry の使用方法など、詳細については Datadog における OpenTelemetry を参照してください。

OpenTelemetry による AWS Lambda のインスツルメンテーション

AWS の Lambda 関数を OpenTelemetry でインスツルメンテーションし、Datadog にデータを送信する方法は複数あります。

Datadog トレーサー内での OpenTelemetry API サポート

Datadog Lambda 拡張機能のインストール時に含まれる Datadog トレーシングライブラリは、OpenTelemetry でインスツルメンテーションされたコードで作成されたカスタムスパンとトレースを受け入れ、テレメトリーを処理し、Datadog に送信します。

例えば、すでに OpenTelemetry API でインスツルメンテーションされたコードが主な目的であれば、このアプローチを使用することができます。これは、Datadog のネイティブな実装、タグ付け、機能を利用しながら、すべてのサービスのインスツルメンテーションをベンダーニュートラルに維持できることを意味します。

AWS Lambda を OpenTelemetry API でインスツルメンテーションするには、Lambda 関数内で環境変数 DD_TRACE_OTEL_ENABLED を true に設定し、ランタイム固有の手順については OpenTelemetry API によるカスタムインスツルメンテーションを参照してください。

任意の OpenTelemetry SDK から、Datadog Lambda 拡張機能を通して OpenTelemetry トレースを送信する

このアプローチは、Datadog Agent の OLTP 取り込みに似ています。例えば Rust や PHP などのランタイムでトレースサポートが利用できない場合に推奨します。

注: 拡張機能内の OTLP エンドポイントからカスタムメトリクスを送信することはサポートされていません。

  1. Datadog の Lambda 拡張機能にスパンをエクスポートするように OpenTelemetry に指示します。そして、AWS Lambda 用の OpenTelemetry のインスツルメンテーションを追加します。

      from opentelemetry.instrumentation.botocore import BotocoreInstrumentor
from opentelemetry.instrumentation.aws_lambda import AwsLambdaInstrumentor
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.exporter.otlp.trace_exporter import OTLPExporter
from opentelemetry.sdk.trace.export import SimpleSpanProcessor
from opentelemetry.resource import Resource
from opentelemetry.semconv.resource import (
    SERVICE_NAME,
    SemanticResourceAttributes,
)

# Create a TracerProvider
tracer_provider = TracerProvider(resource=Resource.create({SERVICE_NAME: <YOUR_SERVICE_NAME>}))

# Add a span processor with an OTLP exporter
tracer_provider.add_span_processor(
    SimpleSpanProcessor(
        OTLPExporter(endpoint="http://localhost:4318/v1/traces")
    )
)

# Register the provider
trace.set_tracer_provider(tracer_provider)

# Instrument AWS SDK and AWS Lambda
BotocoreInstrumentor().instrument(tracer_provider=tracer_provider)
AwsLambdaInstrumentor().instrument(tracer_provider=tracer_provider)

      // instrument.js

const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");
const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http');
const { Resource } = require('@opentelemetry/resources');
const { SemanticResourceAttributes } = require('@opentelemetry/semantic-conventions');
const { SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-base');
const provider = new NodeTracerProvider({
    resource: new Resource({
        [ SemanticResourceAttributes.SERVICE_NAME ]: 'rey-app-otlp-dev-node',
    })
});
provider.addSpanProcessor(
    new SimpleSpanProcessor(
        new OTLPTraceExporter(
            { url: 'http://localhost:4318/v1/traces' },
        ),
    ),
);
provider.register();

const { AwsInstrumentation } = require('@opentelemetry/instrumentation-aws-sdk');
const { AwsLambdaInstrumentation } = require('@opentelemetry/instrumentation-aws-lambda');
const { registerInstrumentations } = require('@opentelemetry/instrumentation');

registerInstrumentations({
    instrumentations: [
        new AwsInstrumentation({
            suppressInternalInstrumentation: true,
        }),
        new AwsLambdaInstrumentation({
            disableAwsContextPropagation: true,
        }),
    ],
});
      1. serverless.yml を修正して、ランタイムでインスツルメンテーションを適用し、Datadog 拡張機能 v53 以降を追加し、環境変数 DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT を localhost:4318 (HTTP 用) または DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT を localhost:4317 (gRPC 用) に設定して、Datadog 拡張機能で OpenTelemetry を有効にします。Datadog トレーシングレイヤーを追加しないでください。
        service: <YOUR_SERVICE_NAME>

provider:
  name: aws
  region: <YOUR_REGION>
  runtime: python3.8  # または使用している Python のバージョン
  environment:
    DD_API_KEY: ${env:DD_API_KEY}
    DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT: localhost:4318
  layers:
    - arn:aws:lambda:sa-east-1:464622532012:layer:Datadog-Extension:53

functions:
  python:
    handler: handler.handler
    environment:
      INSTRUMENTATION_FLAG: true

        それに従って Python のコードを更新してください。例えば、handler.py では以下のようになります。

        import os

def handler(event, context):
    if os.environ.get('INSTRUMENTATION_FLAG') == 'true':
        # インスツルメンテーションロジックをここに記述
        print("Instrumentation is enabled")

    # 通常のハンドラーロジックをここに記述
    print("Handling the event")

        # serverless.yml

service: <YOUR_SERVICE_NAME>

provider:
  name: aws
  region: <YOUR_REGION>
  runtime: nodejs18.x # または使用している Node.js のバージョン
  environment:
    DD_API_KEY: ${env:DD_API_KEY}
    DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT: localhost:4318
  layers:
    - arn:aws:lambda:sa-east-1:464622532012:layer:Datadog-Extension:53

functions:
  node:
    handler: handler.handler
    environment:
      NODE_OPTIONS: --require instrument

      • デプロイします。

      その他の参考資料

      お役に立つドキュメント、リンクや記事:

      Datadog の OpenTelemetryドキュメント more more