Datadog サーバーレス CLI

この機能は公開ベータ版です。質問や問題がございましたら、リポジトリに問題を登録してお知らせください。

CLI を使用して、AWS Lambda 関数を Datadog でインスツルメントできます。現在、Python および Node.js ランタイムのみがサポートされています。

はじめに

次のコマンドを使用して、AWS 認証情報 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY をご使用の環境で使用できるようにするか、AWS JS SDK でサポートされている認証方法のいずれかを使用します。


export AWS_ACCESS_KEY_ID="<ACCESS KEY ID>"
export AWS_SECRET_ACCESS_KEY="<ACCESS KEY>"

Datadog CI をダウンロードします。

コンフィギュレーション

構成ファイル

コンフィギュレーションは、コマンドライン引数または JSON コンフィギュレーションファイルを使用して行われます。コンフィギュレーションファイルを使用する場合は、--config 引数を使用して datadog-ci.json を指定し、次のコンフィギュレーションファイル構造を使用します。

{
    "lambda": {
        "layerVersion": 10,
        "extensionVersion": 8,
        "functions": ["arn:aws:lambda:us-east-1:000000000000:function:autoinstrument"],
        "region": "us-east-1",
        "tracing": true,
        "mergeXrayTraces": true,
        "forwarder": "arn:aws:lambda:us-east-1:000000000000:function:datadog-forwarder",
        "logLevel": "debug"
    }
}

コマンド

instrument を使用して、Datadog インスツルメンテーションを Lambda に適用します。このコマンドは、Datadog Lambda ライブラリおよび/または Datadog Lambda 拡張機能を Lambda レイヤーとして、インスツルメントされた Lambda 関数に自動的に追加し、そのコンフィギュレーションを変更します。

このコマンドは、既存の Lambda 関数で Datadog インスツルメンテーションを試す最も簡単な方法です。実稼働環境で使用するには、CI/CD パイプラインでこのコマンドを実行して、Lambda 関数がインスツルメンテーション用に常に更新されるようにします。

# ARN で指定された関数をインスツルメントします
datadog-ci lambda instrument --function arn:aws:lambda:us-east-1:000000000000:function:functionname --layerVersion 10

# 省略形を使用します
datadog-ci lambda instrument -f arn:aws:lambda:us-east-1:000000000000:function:functionname -v 10

# 名前で指定された複数の関数をインスツルメントします (--region を定義する必要があります)
datadog-ci lambda instrument -f functionname -f another-functionname -r us-east-1 -v 10

# すべての更新コマンドのドライラン
datadog-ci lambda instrument -f functionname -r us-east-1 -v 10 --dry

すべての引数

引数を instrument に渡してその行動を指定します。引数は、コンフィギュレーションファイルに設定されている値がある場合、これを上書きします。

引数省略形説明デフォルト
–function-fインスツルメントする Lambda 関数の ARN、または Lambda 関数の名前 (–region を定義する必要があります)
–region-r--function が ARN ではなく関数名で指定されている場合に使用するデフォルトのリージョン
–layerVersion-v適用する Datadog Lambda ライブラリレイヤーのバージョン。これはランタイムによって異なります。最新のレイヤーバージョンを確認するには、JS または python datadog-lambda-layer リポジトリのリリースノートを確認してください。
–extensionVersion-e適用する Datadog Lambda Extension レイヤーのバージョン。extensionVersion が設定されている場合は、お使いの環境でも必ず DATADOG_API_KEY (または DATADOG_KMS_API_KEY) をエクスポートしてください。extensionVersion を使用する場合は、forwarder を省略します。Lambda Extension の詳細はこちら。
–tracingLambda で dd-trace トレースを有効にするかどうかtrue
–mergeXrayTracesdd-trace トレースを AWS X-Ray トレースに結合するかどうか。API ゲートウェイスパンのトレースに役立ちます。false
–flushMetricsToLogsDatadog Forwarder を介してメトリクスを非同期に送信するかどうかtrue
–forwarderこの関数の LogGroup をアタッチする Datadog Forwarder の ARN。
–dry-dコマンドを実行している変更のプレビューが適用されます。false
–logLevelDatadog Lambda ライブラリおよび/または Lambda 拡張機能から追加の出力をトラブルシューティングのために確認するには、debug を設定します。

追加の環境変数

環境変数を使用して lambda instrument コマンドを構成できます。 datadog-ci lambda instrument を実行している環境でこれらの環境変数を公開する必要があります

環境変数説明例
DATADOG_API_KEYDatadog API キー。Lambda 関数設定に DD_API_KEY 環境変数を設定します。Datadog API キーの取得の詳細については、API キーのドキュメントを参照してください。export DATADOG_API_KEY=“1234”
DATADOG_KMS_API_KEYKMS を使用して暗号化された Datadog API キー。Lambda 関数設定に DD_KMS_API_KEY 環境変数を設定します。export DATADOG_KMS_API_KEY=“5678”
DATADOG_SITEデータを送信する Datadog サイトを設定します。Datadog Lambda Extension を使用する場合にのみ必要です。可能な値は、datadoghq.com、datadoghq.eu、us3.datadoghq.com、ddog-gov.com です。デフォルトは datadoghq.com です。Lambda 関数設定に DD_SITE 環境変数を設定します。export DATADOG_SITE=“datadoghq.com”

コミュニティ

製品のフィードバックや質問については、Slack の Datadog コミュニティの #serverless チャンネルに参加してください。