Amazon CloudFront 連携(Data Firehose)

​

概要

​

前提条件

• CloudFront と Amazon Data Firehose の権限を持つ AWS アカウント
• CloudFront ディストリビューションの設定へのアクセス権
• Agent Analytics 用の Profound Log Ingestion Token

​

設定

1

ステップ 1

AWS コンソールにサインインし、Amazon Data Firehose コンソールに移動します。

2

ステップ 2

新しい配信ストリームを作成し、ソースとして “Direct PUT”、送信先として “HTTP Endpoint” を選択します。

3

ステップ 3

1. 次の URL 形式で HTTP エンドポイントを設定します。

https://artemis.api.tryprofound.com/v1/logs/aws_data_firehose_cloudfront

2. 認証には、Profound Log Ingestion Token をアクセスキーとして指定します(トークンを安全に保管するため、AWS Secrets Manager の使用を推奨します)。

AWS Secrets Manager を使用する場合は、シークレットの作成時に次の JSON 形式を使用してください。

{
  "api_key": "bot_PROFOUND_LOG_INGESTION_TOKEN"
}

3. GZIP コンテンツエンコーディングを有効にします。
4. 配信に失敗したログを保存するための新しい S3 バケットを作成します(AWS で必須)。

4

ステップ 4

CloudFront ディストリビューションに移動し、“Logging” タブを開きます。“Add” ボタンをクリックし、送信先として “Kinesis Data Firehose” を選択します(Kinesis Data Firehose は Amazon Data Firehose の旧称です)。

5

ステップ 5

“Add standard logging destination” 画面が表示されます。ステップ 3 で作成した配信ストリームを選択します。“Additional settings - optional” で、次のフィールドを選択します。

• 時刻と IP
  • date - リクエストが完了した日付
  • time - リクエストが完了した時刻
  • c-ip - クライアントの IP アドレス
• リクエストの詳細
  • cs-method - HTTP リクエストメソッド
  • x-host-header - リクエストの Host ヘッダーの値
  • cs-uri-stem - リクエスト URI のパス
  • cs-uri-query - リクエストのクエリ文字列
  • cs(User-Agent) - クライアントのユーザーエージェント
  • cs(Referer) - リクエストのリファラー
• レスポンスの詳細
  • sc-status - HTTP レスポンスステータス
  • sc-bytes - レスポンスサイズ(バイト)
  • time-taken - リクエストの処理時間

6

ステップ 6

Output format として JSON を選択します。Submit をクリックして設定を保存します。

​

トラブルシューティング

• ログが表示されない場合は、CloudWatch で Firehose 配信ストリームのステータスを確認してください
• Data Firehose のモニタリングで配信エラーを確認してください
• Log Ingestion Token が正しいことを確認してください
• ディストリビューションで CloudFront のリアルタイムログが有効になっていることを確認してください
• IAM ロールに CloudFront と Firehose の両方に対する適切な権限があることを確認してください

​

その他のリソース

• Amazon CloudFront リアルタイムログのドキュメント
• Amazon Kinesis Data Firehose のドキュメント
• API に関するご質問は support@tryprofound.com までお問い合わせください

​

セキュリティに関する考慮事項

• Log Ingestion Token は AWS Secrets Manager に保存してください
• Log Ingestion Token は定期的にローテーションしてください
• CloudWatch ログに異常なパターンがないか監視してください
• API アクティビティを監視するために CloudTrail を有効にしてください
• 最小権限のアクセスを持つ IAM ロールを使用してください