- はじめに
- エージェント
- インテグレーション
- Watchdog
- イベント
- ダッシュボード
- モバイルアプリケーション
- インフラストラクチャー
- サーバーレス
- メトリクス
- ノートブック
- アラート設定
- APM & Continuous Profiler
- CI Visibility
- RUM & セッションリプレイ
- データベース モニタリング
- ログ管理
- セキュリティプラットフォーム
- Synthetic モニタリング
- ネットワークモニタリング
- 開発者
- API
- アカウントの管理
- データセキュリティ
- ヘルプ
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 の詳細はこちら。 | |
–tracing | Lambda で dd-trace トレースを有効にするかどうか | true | |
–mergeXrayTraces | dd-trace トレースを AWS X-Ray トレースに結合するかどうか。API ゲートウェイスパンのトレースに役立ちます。 | false | |
–flushMetricsToLogs | Datadog Forwarder を介してメトリクスを非同期に送信するかどうか | true | |
–forwarder | この関数の LogGroup をアタッチする Datadog Forwarder の ARN。 | ||
–dry | -d | コマンドを実行している変更のプレビューが適用されます。 | false |
–logLevel | Datadog Lambda ライブラリおよび/または Lambda 拡張機能から追加の出力をトラブルシューティングのために確認するには、debug を設定します。 |
環境変数を使用して lambda instrument
コマンドを構成できます。
datadog-ci lambda instrument
を実行している環境でこれらの環境変数を公開する必要があります
環境変数 | 説明 | 例 |
---|---|---|
DATADOG_API_KEY | Datadog API キー。Lambda 関数設定に DD_API_KEY 環境変数を設定します。Datadog API キーの取得の詳細については、API キーのドキュメントを参照してください。 | export DATADOG_API_KEY=“1234” |
DATADOG_KMS_API_KEY | KMS を使用して暗号化された 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
チャンネルに参加してください。