> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Akamai

> Amazon S3 を経由して Akamai のアクセスログを Profound に送信します。

## 概要

Akamai のアクセスログを割り当てられた Profound の S3 送信先に送信すると、Agent Analytics でエージェントのトラフィックを確認できます。このガイドでは、DataStream 2 を通じて送信される CDN リクエストログについて説明します。

<Info>
  配信を設定する前に、[Profound サポート](mailto:support@tryprofound.com)に連絡して利用可否を確認し、送信先の設定と認証情報の手配を行ってください。
</Info>

HTTP 経由で送信する場合は、[Akamai HTTPS 連携](/ja-jp/agent-analytics/akamai)を使用してください。

## 前提条件

* DataStream 2 が有効になっている Akamai アカウント。
* 対象のプロパティに対してストリームを作成・有効化する権限。
* リクエストヘッダーのロギングや必要な DataStream の動作を設定するための Property Manager へのアクセス権。

## 暗号化

このガイドでは、**SSE-S3 (AES256)** を使用し、Amazon S3 が管理するキーで保存時のログを暗号化します。暗号化は Profound が送信先に設定します。

## 設定

<Steps>
  <Step title="送信先を手配する">
    モニタリングしたいドメインを Profound サポートに共有してください。サポートがソースの準備状況を確認し、バケット名、フォルダパス、リージョン、AWS 認証情報の受け渡しを調整します。

    シークレットアクセスキーは認証情報マネージャーで保管し、Akamai に直接入力してください。サポートへのメッセージやスクリーンショットに含めないようにしてください。
  </Step>

  <Step title="ストリームを作成する">
    Akamai Control Center で **Analytics & monitor > DataStream** を開き、**Create stream** を選択します。CDN 配信ログを選択し、わかりやすい名前を入力して、対象ドメインを配信しているプロパティを選択します。
  </Step>

  <Step title="ログフィールドを選択する">
    ログ形式として **JSON** を選択します。Profound は、次のフィールドを含む 1 行 1 JSON オブジェクトの形式で処理します。

    | フィールド | 用途 |
    | - | - |
    | `reqTimeSec` | リクエスト時刻 |
    | `cliIP` | クライアントアドレス |
    | `reqHost` | リクエストされたドメイン |
    | `reqMethod`, `reqPath` | リクエストされたリソース |
    | `statusCode` | レスポンスステータス |
    | `UA` | エージェントの識別 |

    クエリ文字列、リファラー情報、レスポンスサイズを取得するには、`queryStr`、`referer`、`totalBytes` を含めてください。

    選択したフィールドにリクエストの値が含まれるよう、Property Manager で Host、User-Agent、Referer ヘッダーのロギングを有効にします。対応する設定については、Akamai の [data set parameters](https://techdocs.akamai.com/datastream2/docs/data-set-parameters) を参照してください。
  </Step>

  <Step title="S3 送信先を設定する">
    **Destination** タブで **S3** を選択し、次の内容を入力します。

    | 設定 | 値 |
    | - | - |
    | Name | わかりやすい名前 |
    | Bucket | Profound から提供されたバケット |
    | Folder path | Profound から提供されたフォルダパス |
    | Region | `us-west-2`(オレゴン) |
    | Access key ID | Profound と手配した AWS アクセスキー ID |
    | Secret access key | 対応する AWS シークレットアクセスキー |

    **Validate & Save** を選択してアクセスを確認します。検証中、Akamai は送信先に検証用ファイルを書き込みます。

    DataStream 2 は、gzip で圧縮されたファイルを S3 に送信します。ログファイル名はデフォルトのままにしてください。Profound は、圧縮ファイル名が `.gz` で終わることを想定しています。

    詳細については、Akamai の [Amazon S3 destination guide](https://techdocs.akamai.com/datastream2/docs/stream-amazon-s3) を参照してください。
  </Step>

  <Step title="配信を有効化する">
    Profound から準備完了の連絡があったら、ストリームを確認して有効化します。条件に一致するすべてのリクエストを取得するため、サンプリングを **100%** に設定してください。

    Property Manager に依存するストリームの場合は、**DataStream** ビヘイビアを有効にし、DataStream 2 のストリームを選択して、プロパティバージョンを有効化します。DataStream で管理されるストリームでは、ストリームの設定がそのまま使用されます。

    連携タイプに応じた Akamai の [activation steps](https://techdocs.akamai.com/datastream2/docs/quick-start) に従ってください。有効化には最大 1 時間かかる場合があります。
  </Step>
</Steps>

## 取り込みを確認する

設定したドメインへのトラフィックを発生させます。配信と処理が完了したら、Agent Analytics を開き、それらのリクエストを含む期間を選択して、想定どおりのエージェントトラフィックがあるか確認します。

データが表示されない場合は、ドメイン、ストリーム ID、リクエスト時刻、および配信エラーがあればその内容を Profound サポートに共有してください。

## トラブルシューティング

| 問題 | 確認事項 |
| - | - |
| 送信先の検証に失敗する | バケット、フォルダパス、リージョン、認証情報を割り当てられた設定と照合してください。送信先の権限の確認をサポートに依頼してください。 |
| ログが届かない | ストリームと必要なプロパティバージョンが有効になっており、トラフィックを受信していることを確認してください。 |
| ファイルは届くがデータが欠けている | JSON フィールドの選択、リクエストヘッダーのロギング、選択した期間を確認してください。 |
| 認証情報の変更後にアクセスに失敗する | 新しい認証情報で送信先を更新し、再度検証してください。 |

## その他のリソース

* [Akamai: Stream logs to Amazon S3](https://techdocs.akamai.com/datastream2/docs/stream-amazon-s3)
* [Akamai: DataStream 2 quick start](https://techdocs.akamai.com/datastream2/docs/quick-start)
* [Akamai: Log format](https://techdocs.akamai.com/datastream2/docs/log-format)
* [Akamai HTTPS 連携](/ja-jp/agent-analytics/akamai)
* [Profound サポートへのお問い合わせ](mailto:support@tryprofound.com)