概要

Amazon API Gateway は、開発者があらゆる規模で API の作成、公開、保守、監視、およびセキュリティ保護を簡単に行えるフルマネージド型サービスです。

このインテグレーションを有効にすると、Datadog にすべての API Gateway メトリクスを表示できます。

セットアップ

インストール

Amazon Web Services インテグレーションをまだセットアップしていない場合は、セットアップします。

メトリクスの収集

1. AWS インテグレーションページで、Metric Collection タブの下にある API Gateway が有効になっていることを確認します。

2. API Gateway ステージにカスタムタグを適用するには、次のアクセス許可を Datadog IAM ポリシーに追加します。

   • apigateway:GET
   • tag:GetResources

3. Datadog - Amazon API Gateway インテグレーションをインストールします。

AWS から取得される各メトリクスには、ホスト名やセキュリティ グループなど、AWS コンソールに表示されるのと同じタグが割り当てられます。

注: CloudWatch の詳細メトリクスを有効にしている場合、ステージ内のすべてのリソースまたはルートで有効にする必要があります。無効の場合、Datadog の集計値が不正確になります。

ログ収集

API Gateway ログを有効にするには

1. AWS コンソールで API Gateway に移動します。

2. 目的の API を選択し、Stages セクションに移動します。

3. Logs タブで、Enable CloudWatch Logs と Enable Access Logging を有効にします。

4. INFO レベルを選択して、すべてのリクエストが取得されるようにします。

5. CloudWatch Group の名前が api-gateway で開始することを確認します。

6. JSON 形式を選択し (CLF と CSV もサポートされています)、Log format ボックスに以下を追加します。

   {
       "apiId": "$context.apiId",
       "stage": "$context.stage",
       "requestId":"$context.requestId",
       "ip":"$context.identity.sourceIp",
       "caller":"$context.identity.caller",
       "user":"$context.identity.user",
       "requestTime":$context.requestTimeEpoch,
       "httpMethod":"$context.httpMethod",
       "resourcePath":"$context.resourcePath",
       "status":$context.status,
       "protocol":"$context.protocol",
       "responseLength":$context.responseLength
   }
   

ログを Datadog に送信する方法

1. Datadog ログコレクション AWS Lambda 関数をまだセットアップしていない場合は、セットアップします。
2. Lambda 関数がインストールされたら、AWS コンソールから手動で API Gateway ログを含む CloudWatch ロググループにトリガーを追加します。 対応する CloudWatch ロググループを選択し、フィルター名を追加して (空にすることも可能)、トリガーを追加します。

完了したら、Logs ページに移動し、ログの検索を開始します。

収集データ

メトリクス

イベント

Amazon API Gateway インテグレーションには、イベントは含まれません。

サービスチェック

Amazon API Gateway インテグレーションには、サービスのチェック機能は含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問い合わせください。