Datadog Lambda 拡張機能 (プレビュー)

Datadog Lambda 拡張機能 (プレビュー)

概要

Datadog AWS Lambda 拡張機能は公開プレビューです。フィードバックがございましたら、Datadog サポートチームまでお寄せください。

AWS Lambda 拡張機能は、Lambda 関数を拡張できるコンパニオンプロセスです。Lambda の実行環境内で、Lambda 関数コードとともに動作します。Datadog 拡張機能は、最低限のパフォーマンスオーバーヘッドでコードと一緒に実行するよう構築された、Datadog Agent の軽量バージョンです。

Datadog 拡張機能は、AWS Lambda 関数の実行中にカスタムメトリクスおよびログの同期的送信をサポートします。つまり、Datadog Forwarder を使わずにテレメトリーデータを送信できます。注: トレースを Datadog に送信するには、依然として Datadog Forwarder が必要です。

セットアップ

現在 Datadog 拡張機能は、Node.js と Python rランタイムをサポートします。

Lambda レイヤーとして

Datadog Lambda 拡張機能は、独自の Lambda レイヤー (Datadog Lambda ライブラリとは別) として配布されます。

  1. Datadog Lambda ライブラリをインストールして、Python または Node.js アプリケーションをインスツルメントします。

  2. Datadog 拡張機能用 Lambda レイヤーを次の ARN で AWS Lambda 関数に追加します。

    arn:aws:lambda:<AWS_REGION>:464622532012:layer:Datadog-Extension:<VERSION_NUMBER>

    ARN のプレイスホルダーの値を次のように置き換えます。

    • Replace <AWS_REGION> を Lambda 関数と同じ AWS リージョンに置き換えます。例、 us-east-1
    • <VERSION_NUMBER> を使用する Datadog Lambda 拡張機能のバージョン（たとえば 6 ）に置き換えます。 現在のバージョンを確認するには、Amazon ECR リポジトリで最新のイメージタグを表示します。

    注: このレイヤーは Datadog Lambda ライブラリとは別のものです。Datadog Lambda ライブラリを Lambda レイヤーとしてインストールした場合、 関数には 2 つの Lambda レイヤーがアタッチされることになります。

  3. カスタムメトリクスを送信するには、サンプルコードを参照します。

コンテナイメージとして

関数をコンテナイメージとしてデプロイする場合は、関数に Lambda レイヤーを追加することはできません。代わりに、Datadog Lambda ライブラリとDatadog Lambda 拡張機能を、関数イメージに直接インストールする必要があります。

まず、Node.js または Python のインストール手順に従い、Datadog Lambda ライブラリをインストールします。コンテナイメージとしてデプロイされる機能に特化したインストレーション手順を使用してください。

次に、Dockerfile に以下を追加して、Datadog Lambda 関数をコンテナイメージに追加します。

COPY --from=public.ecr.aws/datadog/lambda-extension:<TAG> /opt/extensions/ /opt/extensions

<TAG> を特定のバージョン番号（たとえば 6 ）または latest に置き換えます。利用可能なタグのリストは、Amazon ECR リポジトリで確認できます。

ログの収集

拡張機能を使用して AWS Lambda ログを Datadog に送信するには、関数の環境変数 DD_LOGS_ENABLED を true に設定します。

その他の参考資料

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

AWS Lambda からのカスタムメトリクスの送信DOCUMENTATION more more