メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::Logs::MetricFilter

AWS::Logs::MetricFilter リソースは、Amazon CloudWatch Logs が指定されたログから情報を抽出して Amazon CloudWatch メトリクスに変換する方法を記述したメトリクスフィルタを作成します。ロググループに関連付けられたメトリクスフィルタが複数ある場合、すべてのフィルタがそのグループのログストリームに適用されます。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

Copy
{ "Type": "AWS::Logs::MetricFilter",     "Properties": { "FilterPattern": String, "LogGroupName": String, "MetricTransformations": [ MetricTransformations, ... ] } }

YAML

Copy
Type: "AWS::Logs::MetricFilter" Properties: FilterPattern: String LogGroupName: String MetricTransformations: MetricTransformations

プロパティ

注記

各プロパティの制約と値の詳細については、Amazon CloudWatch Logs API Referenceの「PutMetricFilter」を参照してください。

FilterPattern

CloudWatch Logs がログの各エントリを解釈するために従うパターンを説明します。ログエントリにはタイムスタンプ、IP アドレス、エラーコード、転送バイト数などのフィールドが含まれている場合があります。パターンを使用して、ログファイルのこれらのフィールドや検索対象を指定します。たとえば、1234 で始まるエラーコードを探す場合は、フィルタパターンは [timestamps, ip_addresses, error_codes = 1234*, size, ...] のようになります。詳細については、『Amazon CloudWatch ユーザーガイド』の「フィルタとパターンの構文」を参照してください。

Required: Yes

Type: String

更新に伴う要件: 中断はありません。

LogGroupName

このメトリクスフィルタに関連付ける既存のロググループの名前です。

Required: Yes

Type: String

更新に伴う要件: 置換

MetricTransformations

ログのデータを CloudWatch メトリクスに変換する方法を説明します。

Required: Yes

: CloudWatch Logs MetricFilter MetricTransformation プロパティ のリスト

重要

現在、各メトリクスフィルタに対して指定できるメトリクス変換は 1 つのみです。複数のメトリクス変換を指定する場合は、複数のメトリクスフィルタを指定する必要があります。

更新に伴う要件: 中断はありません。

以下の例は、ステータスコードフィールドに 404 の値が含まれている場合は常に、1 の値を 404Count メトリクスに送信します。

JSON

Copy
"404MetricFilter": { "Type": "AWS::Logs::MetricFilter", "Properties": { "LogGroupName": { "Ref": "myLogGroup" }, "FilterPattern": "[ip, identity, user_id, timestamp, request, status_code = 404, size]", "MetricTransformations": [ { "MetricValue": "1", "MetricNamespace": "WebServer/404s", "MetricName": "404Count" } ] } }

YAML

Copy
404MetricFilter: Type: "AWS::Logs::MetricFilter" Properties: LogGroupName: Ref: "myLogGroup" FilterPattern: "[ip, identity, user_id, timestamp, request, status_code = 404, size]" MetricTransformations: - MetricValue: "1" MetricNamespace: "WebServer/404s" MetricName: "404Count"

追加情報

テンプレートのその他の例は、「Amazon CloudWatch Logs テンプレートスニペット」を参照してください。

このページの内容: