Kinesis Data Firehose を使用した AWS CloudWatch メトリクスストリーム

docs>integrations>Kinesis Data Firehose を使用した AWS CloudWatch メトリクスストリーム

Amazon CloudWatch メトリクスストリームと Amazon Kinesis Data Firehose を使用すると、CloudWatch メトリクスを 2〜3 分のレイテンシーでより速く Datadog に取り込むことができます。これは、10 分ごとに更新されたメトリクスを提供する Datadog の API ポーリングアプローチよりも大幅に高速です。

概要

メトリクスをストリーミングする各 AWS アカウントとリージョンにこれらの AWS リソースを作成します。
- メトリクスの配信に失敗した場合の S3 バックアップとともに、メトリクスを Datadog に配信する Kinesis Data Firehose 配信ストリームを作成します。
- 配信ストリームにリンクされた CloudWatch メトリクスストリームを作成します。
- オプションで、メトリクスをストリーミングするためのネームスペースの限定されたセットを指定します。
これらのリソースを作成すると、Datadog はストリーミングされたメトリクスの受信をすぐに開始し、追加のコンフィギュレーションを必要とせずにそれらを Datadog サイトに表示します。

Metric Streaming と API ポーリングの比較

CloudWatch Metric Streams と API ポーリングの主な相違点は以下の通りです。

AWS でのネームスペースフィルタリング: AWS インテグレーションページのネームスペースごとのデフォルトとアカウントレベルの設定は、API ポーリングアプローチにのみ適用されます。AWS アカウントの CloudWatch メトリクスストリーム設定を使用して、ストリームにネームスペースを含めたり除外したりするためのすべてのルールを管理します。
2 時間以上遅れて報告されるメトリクス: API ポーリングは、CloudWatch Metric Stream を通して送ることができないため、メトリクスストリーミングを有効にした後も aws.s3.bucket_size_bytes や aws.billing.estimated_charges などのメトリクスを収集し続けます。

API ポーリングからメトリクスストリームへの切り替え

API ポーリングメソッドを通じて特定の CloudWatch ネームスペースのメトリクスを既に受け取っている場合、Datadog は自動的にこれを検出し、ストリーミングを開始するとそのネームスペースのメトリクスポーリングを停止します。Datadog は引き続き API ポーリングを使用して、ストリームされたメトリクスに対してカスタムタグや他のメタデータを収集するため、AWS インテグレーションページの構成設定は変更しないままにしておきます。

メトリクスストリームから API ポーリングに戻る

AWS アカウントやリージョン、あるいは特定のネームスペースのメトリクスをストリーミングしたくないと後で判断した場合、Datadog は自動的に AWS インテグレーションページの構成設定に基づいて、API ポーリングを使用してそれらのメトリクスの収集を再び開始します。AWS アカウントとリージョンのすべてのメトリクスのストリーミングを停止したい場合は、本ドキュメントのメトリクスストリーミングを無効にするのセクションの指示に従います。

課金

メトリクスをストリーミングするための Datadog からの追加料金はありません。

AWS は、CloudWatch メトリクスストリームのメトリクスアップデートの数と Kinesis Data Firehose に送信されたデータボリュームに基づいて課金します。ストリーミングしているメトリクスのサブセットの CloudWatch コストが増加する可能性があるため、Datadog は、より低いレイテンシーが最も必要な AWS サービス、リージョン、アカウントにメトリクスストリームを使用することを優先することをお勧めします。詳細については、Amazon CloudWatch の価格設定を参照してください。

ストリーム内の EC2 または Lambda メトリクスは、請求対象のホストと Lambda 呼び出しの数を増やす可能性があります (EC2 の場合、これらのホストと関数が AWS インテグレーションまたは Datadog Agent でまだ監視されていない場合)。

セットアップ

はじめに

Metric Streaming と API ポーリングの比較のセクションをよく読んで、Metric Streaming を有効にする前に違いを理解してください。
まだ接続していない場合は、AWS アカウントを Datadog に接続します。詳細については、CloudFormation のセットアップ手順を参照してください。

インストール

複数の AWS リージョンを使用している場合は自動的かつ簡単になるため、Datadog では CloudFormation の使用をお勧めします。

Datadog サイトで、AWS インテグレーションページの Configuration タブに移動します。
AWS アカウントをクリックして、メトリクスストリーミングを設定します。
Metric Collection の下、CloudWatch Metric Streams の下にある Automatically Using CloudFormation をクリックし、AWS コンソールでスタックを起動させます。

AWS インテグレーションページの Metric Collection タブの CloudWatch Metric Streams セクションで、Automatically Using CloudFormation ボタンをハイライトした状態

必須パラメータを入力します。
- ApiKey: Datadog API キーを追加します。
- DdSite: Datadog サイトを選択します。サイトは次のとおりです:
- Regions: メトリクスストリーミング用に設定するリージョンのコンマ区切りのリスト。サポートされるリージョンの完全なリストについては、AWS のドキュメントメトリクスストリームを使用するを参照してください。
オプションのパラメータを入力します。
- FilterMethod: メトリクスストリーミングに含めるネームスペースのリストを含めるか除外します。
- First/Second/Third Namespace: 含めるまたは除外するネームスペースを指定します。注: ネームスペースの値は、AWS のドキュメントのネームスペース列の値と正確に一致する必要があります。例: AWS/EC2。
“I acknowledge that AWS CloudFormation might create IAM resources with custom names.” (AWS CloudFormation がカスタム名で IAM リソースを作成する可能性があることを認めます) という確認ボックスをオンにします。
Create Stack をクリックします。

結果

スタックが正常に作成されたら、Datadog が変更を認識するまで 5 分ほど待ちます。完了を確認するには、Datadog の AWS インテグレーションページの Metric Collection タブに移動し、選択したアカウントに対してアクティブ化したリージョンが表示されることを確認します。

AWS インテグレーションページの Metric Collection タブの CloudWatch Metric Streams セクションで、1 つのリージョンがアクティブになっている状態

AWS コンソールを使用してメトリクスストリームを設定する場合は、AWS リージョンごとに次の手順に従います。

次の仕様で新しい Kinesis Data Firehose 配信ストリームを作成します。
- Source: Direct PUT を選択します。
- Destination:
  - Datadog を選択します。
  - Datadog サイトに対応するメトリクスのエンドポイント URL を選択します: Datadog metrics - US または Datadog metrics - EU。
- API key: Datadog API キーを入力します。
- Retry duration: 60 seconds を入力します。
- S3 backup bucket: Failed data only を選択し、バックアップに必要な S3 バケットを選択します。
- HTTP endpoint バッファ条件:
  - バッファサイズに 4MB、バッファ間隔に 60 seconds を入力します。
- S3 バッファ条件:
  - バッファサイズに 4MB、バッファ間隔に 60 seconds を入力します。
- S3 compression and encryption: GZIP を選択します。
- Advanced settings で Amazon CloudWatch error logging を有効にします。
次の手順で CloudWatch メトリクスストリームを作成します。
CloudWatch の全メトリクスをストリーミングするか、特定のネームスペースのみをストリーミングするかを選択します。
ステップ 1 で作成した Firehose を選択して、メトリクスを Datadog に送信するために使用します。
Kinesis Data Firehose にレコードを配置するための新しいサービスロールを作成します。
出力形式を OpenTelemetry 0.7 に変更します。
Add additional statistics では、Datadog に送信する AWS のパーセンタイルメトリクスを含みます。Datadog がポーリングでサポートするパーセンタイルメトリクスの一覧は、CloudFormation テンプレートを参照してください。
メトリクスストリームに名前を付けます。
Create metric stream をクリックします。

結果

Metric Stream リソースが正常に作成されたことを確認したら、Datadog が変更を認識するまで 5 分ほど待ちます。完了を確認するには、Datadog の AWS インテグレーションページの Metric Collection タブを開き、指定した AWS アカウントの CloudWatch Metric Streams で有効化したリージョンが有効になっていることを確認します。

注: CloudWatch API のポーリングをすでに有効にしている場合、ストリーミングへの移行により、ストリーミングしている特定のメトリクスが Datadog で二重にカウントされる短い期間 (最大 5 分) が発生する可能性があります。これは、Datadog のクローラーが実行されて CloudWatch メトリクスを送信するタイミングと、Datadog がこれらのメトリクスのストリーミングを開始したことを認識してクローラーをオフにするタイミングが異なるためです。

メトリクスストリーミングを無効にする

特定の AWS アカウントとリージョンに対してメトリクスストリーミングを完全に無効にするには、AWS Metric Steam とその関連リソースを削除する必要があります。Datadog のメトリクスの損失を防ぐために、これらの削除手順に注意深く従うことが重要です。

CloudFormation でストリーミングを設定した場合:

セットアップ時に作成されたスタックを削除します。

AWS コンソールからストリーミングを設定した場合:

配信ストリームにリンクしている CloudWatch Metric Stream を削除します。
Datadog にメトリクスを配信していた Kinesis Data Firehose の配信ストリームを削除します。
Firehose にリンクされた失敗メッセージのバックアップ S3 バケットを削除します。
ストリームに関連付けられた IAM ロールと、ストリームのセットアップ中に作成された他のすべてのリソースを削除します。

リソースが削除されたら、Datadog が変更を認識するまで 5 分ほど待ちます。完了を確認するには、Datadog の AWS インテグレーションページの Metric Collection タブを開き、指定した AWS アカウントの CloudWatch Metric Streams で無効化したリージョンが表示されないことを確認します。