Amazon Lambda は、イベントに応答してコードを実行し、そのコードが必要とするコンピューティングリソースを自動的に管理するコンピューティングサービスです。
このインテグレーションを有効にすると、CloudWatch メトリクスが収集されるようになります。このページでは、Lambda 関数のカスタムメトリクス、ログ、トレースを設定する方法についても説明します。
Amazon Web Services インテグレーションをまだセットアップしていない場合は、最初にセットアップします。
AWS インテグレーションタイルのメトリクス収集で、Lambda をオンにします。
Amazon Lambda のメトリクスを収集するには、次のアクセス許可を Datadog IAM ポリシーに追加します。Lambda ポリシーの詳細については、AWS Web サイトのガイドを参照してください。
| AWS アクセス許可 | 説明 |
|---|---|
lambda:List* | Lambda 関数、メタデータ、およびタグを一覧表示します。 |
tag:GetResources | Lambda 関数に適用されたカスタムタグを取得します。 |
cloudtrail:LookupEvents | CloudTrail History を使用して Lambda 関数への変更を検出 |
Datadog - AWS Lambda インテグレーションをインストールします。
完了したら、Datadog Serverless ビューにすべての Lambda 関数が表示されます。このページは、サーバーレスアプリケーションを実行している AWS Lambda 関数からのメトリクス、トレース、ログを 1 つのビューにまとめて表示します。この機能の詳細については、Datadog Serverless のドキュメントを参照してください。
| aws.lambda.duration (gauge) | Measures the average elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.maximum (gauge) | Measures the maximum elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.minimum (gauge) | Measures the minimum elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.sum (gauge) | Measures the total execution time of the lambda function executing. Shown as millisecond |
| aws.lambda.duration.p50 (gauge) | Measures the p50 elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.p80 (gauge) | Measures the p80 elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.p95 (gauge) | Measures the p95 elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.p99 (gauge) | Measures the p99 elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.duration.p99.9 (gauge) | Measures the p99.9 elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. Shown as millisecond |
| aws.lambda.timeout (gauge) | Measures the amount of allowed execution time for the function before the Lambda runtime stops it. Shown as second |
| aws.lambda.memorysize (gauge) | Measures the amount of allocated memory available to the function during execution. Shown as mebibyte |
| aws.lambda.errors (count) | Measures the number of invocations that failed due to errors in the function (response code 4XX). Shown as error |
| aws.lambda.invocations (count) | Measures the number of times a function is invoked in response to an event or invocation API call. Shown as invocation |
| aws.lambda.throttles (count) | Measures the number of Lambda function invocation attempts that were throttled due to invocation rates exceeding the customer's concurrent limits (error code 429). Failed invocations may trigger a retry attempt that succeeds. Shown as throttle |
| aws.lambda.iterator_age (gauge) | Measures the age of the last record for each batch of records processed Shown as millisecond |
| aws.lambda.iterator_age.minimum (gauge) | Measures the minimum age of the last record for each batch of records processed Shown as millisecond |
| aws.lambda.iterator_age.maximum (gauge) | Measures the maximum age of the last record for each batch of records processed Shown as millisecond |
| aws.lambda.iterator_age.sum (gauge) | Measures the sum of the ages of the last record for each batch of records processed Shown as millisecond |
| aws.lambda.dead_letter_errors (count) | Measures the sum of times Lambda is unable to write the failed event payload to your configured Dead Letter Queues. Shown as error |
| aws.lambda.concurrent_executions (gauge) | Measures the average of concurrent executions for a given function at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions.minimum (gauge) | Measures the minimum of concurrent executions for a given function at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions.maximum (gauge) | Measures the maximum of concurrent executions for a given function at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions.sum (gauge) | Measures the sum of concurrent executions for a given function at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions_global (gauge) | Measures the average of concurrent executions for all functions in an account at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions_global.minimum (gauge) | Measures the minimum of concurrent executions for all functions in an account at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions_global.maximum (gauge) | Measures the maximum of concurrent executions for all functions in an account at a given point in time. Shown as execution |
| aws.lambda.concurrent_executions_global.sum (gauge) | Measures the sum of concurrent executions for all functions in an account at a given point in time. Shown as execution |
| aws.lambda.unreserved_concurrent_executions (gauge) | Measures the sum of the concurrency of the functions that don't have a custom concurrency limit specified. Shown as execution |
| aws.lambda.post_runtime_extensions_duration (gauge) | Measures the average amount of time that the runtime spends running code for extensions after the function code has completed. Shown as millisecond |
| aws.lambda.post_runtime_extensions_duration.maximum (gauge) | Measures the maximum amount of time that the runtime spends running code for extensions after the function code has completed. Shown as millisecond |
| aws.lambda.post_runtime_extensions_duration.minimum (gauge) | Measures the minimum amount of time that the runtime spends running code for extensions after the function code has completed. Shown as millisecond |
| aws.lambda.post_runtime_extensions_duration.sum (gauge) | Measures the cumulative amount of time that the runtime spends running code for extensions after the function code has completed. Shown as millisecond |
| aws.lambda.post_runtime_extensions_duration.p50 (gauge) | Measures the p50 elapsed wall time that the runtime spends running code for extensions after the function code has completed. Shown as millisecond |
| aws.lambda.post_runtime_extensions_duration.p99 (gauge) | Measures the p90 elapsed wall time that the runtime spends running code for extensions after the function code has completed. Shown as millisecond |
| aws.lambda.provisioned_concurrent_executions (gauge) | Measures the average number of events that are being processed on provisioned concurrency Shown as execution |
| aws.lambda.provisioned_concurrent_executions.minimum (gauge) | Measures the minimum number of events that are being processed on provisioned concurrency Shown as execution |
| aws.lambda.provisioned_concurrent_executions.maximum (gauge) | Measures the maximum number of events that are being processed on provisioned concurrency Shown as execution |
| aws.lambda.provisioned_concurrency_invocations (count) | Measures the number of invocations that are run on provisioned concurrency Shown as invocation |
| aws.lambda.provisioned_concurrency_spillover_invocations (count) | Measures the number of invocations that are run on non-provisioned concurrency when all provisioned concurrency is in use Shown as invocation |
| aws.lambda.provisioned_concurrency_utilization (gauge) | Measures the average fraction of provisioned concurrency in use for a given function at a given point in time Shown as percent |
| aws.lambda.provisioned_concurrency_utilization.minimum (gauge) | Measures the minimum fraction of provisioned concurrency in use for a given function at a given point in time Shown as percent |
| aws.lambda.provisioned_concurrency_utilization.maximum (gauge) | Measures the maximum fraction of provisioned concurrency in use for a given function at a given point in time Shown as percent |
| aws.lambda.signature_validation_errors (count) | Measures the number of times a function is successfully deployed but fails a signature check Shown as error |
| aws.lambda.enhanced.invocations (count) | Measures the number of times a function is invoked in response to an event or invocation API call. Shown as invocation |
| aws.lambda.enhanced.errors (count) | Measures the number of invocations that failed due to errors in the function (response code 4XX). Shown as error |
| aws.lambda.enhanced.max_memory_used (gauge) | Measures the maximum amount of memory (mb) used by the function. Shown as mebibyte |
| aws.lambda.enhanced.duration (gauge) | Measures the elapsed seconds from when the function code starts executing as a result of an invocation to when it stops executing. Shown as second |
| aws.lambda.enhanced.billed_duration (gauge) | Measures the billed amount of time the function ran for (100ms increments). Shown as second |
| aws.lambda.enhanced.init_duration (gauge) | Measures the initialization time (second) of a function during a cold start. Shown as second |
| aws.lambda.enhanced.estimated_cost (gauge) | Measures the total estimated cost of the function invocation (US dollars). Shown as dollar |
| aws.lambda.enhanced.timeouts (count) | Measures the number of times a function times out. Shown as timeout |
| aws.lambda.enhanced.out_of_memory (count) | Measures the number of times a function runs out of memory. Shown as error |
AWS から取得される各メトリクスには、関数名やセキュリティグループなど、AWS コンソールに表示されるタグと同じタグが割り当てられます。
カスタムメトリクスには関数名だけがタグ付けされます。
AWS Lambda インテグレーションには、イベントは含まれません。
AWS Lambda インテグレーションには、サービスのチェック機能は含まれません。
Datadog では、Node.js、Python、Ruby ランタイム用のリアルタイム Lambda ランタイムメトリクスを追加設定なしで生成できます。詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
Datadog では、Datadog APM または AWS X-Ray のいずれかを使用した AWS Lambda 関数の分散トレースをサポートします。いずれかのクライアントライブラリセットを使用してトレースを生成できます。Datadog APM は、ホスト、コンテナ、サーバーレス機能で実行されているアプリケーションからのトレースを自動的に接続します。詳細は、最新のサーバーレスドキュメントでご確認ください。
Datadog Node.js、Python、Ruby トレースライブラリは、AWS Lambda の分散トレースをサポートし、より多くのランタイムが間もなく登場します。アプリケーションにトレースを追加する最も簡単な方法は、依存関係として Datadog トレースライブラリを含む Datadog Lambda ライブラリ を使用することです。詳細は、最新のサーバーレスドキュメントでご確認ください。
該当する場合、Datadog は AWS X-Ray トレースをネイティブ Datadog APM トレースとマージします。これにより、AWS Lambda、コンテナ、オンプレミスホスト、マネージドサービスなど、インフラストラクチャーの境界を越えるリクエストの全体像がトレースに表示されることになります。詳細は、最新のサーバーレスドキュメントでご確認ください。
Lambda 関数に適用されたタグは、自動的に新しいディメンションになり、このディメンションでトレースを分類できます。詳細は、最新のサーバーレスドキュメントでご確認ください。
以下の Lambda 関数インテグレーションは、サーバーレスアプリケーションを監視するためのさらなる機能を提供します。詳細は、サーバレスドキュメントでご確認ください。
Datadog Lambda ライブラリをインストールし、カスタムメトリクスを収集して送信します。詳細は、最新のサーバーレスドキュメントでご確認ください。
ディストリビューションメトリクスでは、送信時に指定する代わりにグラフ化または照会するときに、集計を選択します。詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
関数コードで、Lambda レイヤーから必要なメソッドをインポートし、関数ハンドラーのラッパーを追加します。詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
詳細は、最新のサーバーレスドキュメントでご確認ください。
ご不明な点は、Datadog サポートまでお問い合せください。
お役に立つドキュメント、リンクや記事:
