Lambda 関数から Datadog へカスタムメトリクスを送信するにはいくつかの異なる方法があります。
MONITORING|<UNIX_EPOCH_TIMESTAMP>|<METRIC_VALUE>|<METRIC_TYPE>|<METRIC_NAME>|#<TAG_LIST> 形式のログを出力してカスタムメトリクスを送信する方法は非推奨となりました。上記のいずれかの方法に移行してください。Lambda 関数から送信されたカスタムメトリクスは、基底のホストからは独立してアプリケーションをインスツルメントするよう設計されているため、ディストリビューションとして集計されます。メトリクスのクエリは、avg、sum、max、min、count の集計を使用して作成できます。また、パーセンタイル集計 (p50、p75、p90、p95、p99) を有効にしたり、Metric Summary ページで集計用にタグを管理したりすることも可能です。
ログベースのメトリクスを使用すると、クエリに一致するログの数を記録したり、リクエストの継続時間など、ログに含まれる数値を要約したりできます。ログベースのメトリクスは、インジェストストリーム全体からログデータを要約するコスト効率の高い方法です。ログベースのメトリクスの生成の詳細をご参照ください。
保持フィルターによりインデックス化されたかどうかにかわらず、取り込んだスパンのすべてからメトリクスを生成することも可能です。スパンベースのメトリクスの生成について、詳しくはこちらを参照してください。
Datadog では、サポートされている Lambda ランタイムからのカスタムメトリクスの送信には Datadog Lambda 拡張機能を使用することをお勧めしています。
DD_TRACE_ENABLED を false に設定します。DD_SERVERLESS_LOGS_ENABLED を false に設定します。lambda_metric または sendDistributionMetric などのヘルパー関数をインポートして使用し、サンプルコードに続けてカスタムメトリクスを送信します。Lambda 関数が VPC で実行している場合、パブリックインターネット、PrivateLink、またはプロキシのいずれかを使用して関数が Datadog API エンドポイントに到達することを確認します。
Datadog では、Datadog Lambda 拡張機能によりサポートされていない Lambda ランタイムからのカスタムメトリクスの送信に Datadog Forwarder Lambda を使用することをおすすめしています。
DD_TRACE_ENABLED を false に設定します。DdForwardLog を false に設定します。lambda_metric または sendDistributionMetric などのヘルパー関数をインポートして使用し、サンプルコードに続けてカスタムメトリクスを送信します。Datadog Lambda ライブラリをランタイムに使用できない場合は、予期される JSON 形式でメトリクスを CloudWatch ログに出力できます。サンプルコードセクションで「Other」タブを選択します。
注: カスタムメトリクスを報告するメソッドの引数には次の要件があります。
<METRIC_NAME> は、メトリクス命名ポリシーに従ってメトリクスを一意に識別します。<METRIC_VALUE> は、数値 (整数または浮動小数点数) でなければなりません。<TAG_LIST> はオプションです。['owner:Datadog', 'env:demo', 'cooltag'] のように書式設定されます。from datadog_lambda.metric import lambda_metric
def lambda_handler(event, context):
lambda_metric(
"coffee_house.order_value", # メトリクス名
12.45, # メトリクス値
tags=['product:latte', 'order:online'] # 関連タグ
)
const { sendDistributionMetric } = require('datadog-lambda-js');
async function myHandler(event, context) {
sendDistributionMetric(
'coffee_house.order_value', // メトリクス名
12.45, // メトリクス値
'product:latte', // 最初のタグ
'order:online' // 2 番目のタグ
);
return {
statusCode: 200,
body: 'hello, dog!'
};
}
package main
import (
"github.com/aws/aws-lambda-go/lambda"
"github.com/DataDog/datadog-lambda-go"
)
func main() {
// ラップする必要があるのは関数ハンドラーだけです（ヘルパー関数ではありません）。
lambda.Start(ddlambda.WrapFunction(myHandler, nil))
/* または、手動構成オプションを使用します
lambda.Start(ddlambda.WrapFunction(myHandler, &ddlambda.Config{
BatchInterval: time.Second * 15
APIKey: "my-api-key",
}))
*/
}
func myHandler(ctx context.Context, event MyEvent) (string, error) {
ddlambda.Distribution(
"coffee_house.order_value", // メトリクス名
12.45, // メトリクス値
"product:latte", "order:online" // 関連付けられたタグ
)
// ...
}
require 'datadog/lambda'
def handler(event:, context:)
# ラップする必要があるのは関数ハンドラーだけです（ヘルパー関数ではありません）。
Datadog::Lambda.wrap(event, context) do
Datadog::Lambda.metric(
'coffee_house.order_value', # メトリクス名
12.45, # メトリクス値
"product":"latte", "order":"online" # 関連付けられたタグ
)
return { statusCode: 200, body: 'Hello World' }
end
end
public class Handler implements RequestHandler<APIGatewayV2ProxyRequestEvent, APIGatewayV2ProxyResponseEvent> {
public Integer handleRequest(APIGatewayV2ProxyRequestEvent request, Context context){
DDLambda dd = new DDLambda(request, lambda);
Map<String,String> myTags = new HashMap<String, String>();
myTags.put("product", "latte");
myTags.put("order", "online");
dd.metric(
"coffee_house.order_value", // メトリクス名
12.45, // メトリクス値
myTags); // 関連タグ
}
}
次の形式でカスタムメトリクスをログする再利用可能な関数を作成します。
{
"m": "メトリクス名",
"v": "メトリクス値",
"e": "Unix タイムスタンプ（秒）",
"t": "タグの配列"
}
例:
{
"m": "coffee_house.order_value",
"v": 12.45,
"e": 1572273854,
"t": ["product:latte", "order:online"]
}
このカスタムメトリクスの送信メソッドはもうサポートされておらず、すべての新しいお客様に対しては無効になっています。推奨ソリューションのいずれかに移行してください。
注: いずれかの推奨ソリューションに移行する場合、Datadog に送信する際に、新しいメトリクス名でカスタムメトリクスのインスツルメントを開始する必要があります。ディストリビューションと非ディストリビューションメトリクスタイプの両方として、同じメトリクス名を同時に存在させることはできません。
これには、[Datadog IAM ポリシー][0]で次の AWS アクセス許可が必要です。
| AWS アクセス許可 | 説明 |
|---|---|
logs:DescribeLogGroups |
使用可能なロググループを一覧表示します。 |
logs:DescribeLogStreams |
グループで使用可能なログストリームを一覧表示します。 |
logs:FilterLogEvents |
ストリームの特定のログイベントを取得してメトリクスを生成します。 |
Lambda ログから Datadog にカスタムメトリクスを送信するには、次の形式を使用してログ行を出力します。
MONITORING|<UNIX_EPOCH_タイムスタンプ>|<メトリクス値>|<メトリクスタイプ>|<メトリクス名>|#<タグリスト>
ここで、
MONITORING は、このログエントリを収集する必要があることを Datadog インテグレーションに通知します。<UNIX_EPOCH_TIMESTAMP> は秒単位です。ミリ秒ではありません。<METRIC_VALUE> は、数値 (整数または浮動小数点数) でなければなりません。<METRIC_TYPE> は、count、gauge、histogram、または check です。<METRIC_NAME> は、メトリクス命名ポリシーに従ってメトリクスを一意に識別します。<タグリスト> はオプションです。先頭に # が付いたカンマ区切りリストです。カスタムメトリクスには、自動的にタグ function_name:<関数の名前> が適用されます。注: 各タイムスタンプに対する合計がカウントとして使用され、特定のタイムスタンプの最後の値がゲージとして使用されます。メトリクスをインクリメントするたびにログステートメントを出力することは、ログのパースにかかる時間が増大するため、お勧めしません。コードでメトリクスの値を継続的に更新し、関数が終了する前にメトリクスに 1 つのログステートメントを出力してください。