> ## 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 Datastream2 連携

> このドキュメントでは、Akamai Datastream2 を設定して CDN ログを Profound Agent Analytics プラットフォームに転送する方法を説明します。

## 概要

この連携では、Akamai Datastream2 を使用して CDN ログを Agent Analytics API に転送します。Akamai Datastream2 は、HTTP エンドポイントを含むさまざまな送信先にストリーミングデータを確実に配信するためのサービスです。Akamai Datastream2 の詳細については、[Akamai のドキュメントを参照してください](https://techdocs.akamai.com/datastream2/docs/welcome-datastream2)。

## 前提条件

* Datastream2 アドオンが有効な Akamai アカウント

* Akamai Datastream2 の設定へのアクセス権

* Agent Analytics 用の Profound Log Ingestion Token

## 設定

<img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/akamai_setup.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=d70903421c141d21d2f4beb6cb900afc" alt="Akamai Detected" width="3680" height="2390" data-path="images/agent-analytics/akamai/akamai_setup.png" />

<Steps>
  <Step title="ステップ 1">
    Akamai Control Center にサインインし、左サイドバーの [DataStream](https://control.akamai.com/apps/data-stream-ui/#/streams/group/all) に移動します。`Create a stream` をクリックします。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/create_a_stream.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=14c3af737e62235af30ed3f7db30cb07" alt="DataStream create stream Navigation" width="3680" height="2382" data-path="images/agent-analytics/akamai/create_a_stream.png" />
  </Step>

  <Step title="ステップ 2">
    プロパティを選択し、`Next` をクリックします。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/datastream_start.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=2486ffc50acbe122039bc01bdb64076a" alt="DataStream property selection" width="3680" height="2382" data-path="images/agent-analytics/akamai/datastream_start.png" />
  </Step>

  <Step title="ステップ 3">
    各セクションで次のオプションを選択します。

    **Log Information**

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/log_data.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=4d71519f3395e9515b691d54839133cd" alt="log information" width="456" height="478" data-path="images/agent-analytics/akamai/log_data.png" />

    **Message Exchange Data**

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/message_data.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=fbe0bc758691c5aaa77de1fc6404c5b8" alt="message data" width="1160" height="496" data-path="images/agent-analytics/akamai/message_data.png" />

    **Request Header Data**

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/header_data.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=16bfab22e601431817b5d61acfb24f7d" alt="request header data" width="478" height="574" data-path="images/agent-analytics/akamai/header_data.png" />

    **Network Data**

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/network.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=28c02304416dfd93365626ce8cfa3f28" alt="network data" width="762" height="496" data-path="images/agent-analytics/akamai/network.png" />

    **Log Format**

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/log_format.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=76d889d5b9ed3dc9c59b435fe7428019" alt="log format" width="2960" height="486" data-path="images/agent-analytics/akamai/log_format.png" />

    これらのフィールドの詳細については、[Akamai のドキュメント](https://techdocs.akamai.com/datastream2/docs/data-set-parameters)を参照してください。
  </Step>

  <Step title="ステップ 4">
    認証情報を追加します。

    * **Destination** ドロップダウンから **Custom HTTPS** を選択します。

    * **Authentication** タイプとして **BASIC** を選択します。

    * **URL** に `https://artemis.api.tryprofound.com/v1/logs/akamai` を入力します。

    * **Username** フィールドに組織名を入力します。

    * **Password** フィールドに Log Ingestion Token を入力します。

    * **Send compressed data** にチェックを入れます。

          <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/authentication.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=fd8855bdeebf8f995ba954a7ebe86a33" alt="authentication" width="910" height="1072" data-path="images/agent-analytics/akamai/authentication.png" />
  </Step>

  <Step title="ステップ 5">
    **Log format** として **JSON** を選択します。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/log_format.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=76d889d5b9ed3dc9c59b435fe7428019" alt="output format" width="2960" height="486" data-path="images/agent-analytics/akamai/log_format.png" />
  </Step>

  <Step title="ステップ 6">
    プッシュ頻度として **30** 秒を選択します。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/frequency.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=92de55c3ba5382bce59cac531094a217" alt="push frequency" width="1818" height="532" data-path="images/agent-analytics/akamai/frequency.png" />
  </Step>

  <Step title="ステップ 7">
    設定を確認します。次のようになっているはずです。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/review_configuration.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=620cb181cc50241f6db1a75fe1c60503" alt="Review configuration" width="3680" height="2382" data-path="images/agent-analytics/akamai/review_configuration.png" />

    準備ができたら、`Save stream` をクリックします。

    <Warning>
      DataStream2 がログの送信を開始するまでに約 **60 分**かかります。

      ログを確認する前に **60 分**お待ちください。
    </Warning>
  </Step>

  <Step title="ステップ 8">
    ストリームを作成すると、ストリームを有効化するよう案内されます。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/activate_stream.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=b3154f5ac1dbc08cec3ea597d1352300" alt="activate stream" width="1826" height="594" data-path="images/agent-analytics/akamai/activate_stream.png" />

    `Proceed to Property Manager` をクリックし、ストリームを作成したプロパティを選択します。
  </Step>

  <Step title="ステップ 9">
    **Edit a new version** をクリックして、プロパティにストリームを追加します。

    **Property Configuration Settings** に移動します。`+ Behavior` ドロップダウンから **Standard property behavior** を選択します。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/add_behavior.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=31859c483fef04f5143b991482e11c26" alt="add behavior" width="3680" height="2382" data-path="images/agent-analytics/akamai/add_behavior.png" />

    **DataStream** を検索し、`Insert Behavior` をクリックします。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/datastream_behavior.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=10ece92a22b6a37d5abf9a765a0e66ad" alt="datastream behavior" width="1758" height="990" data-path="images/agent-analytics/akamai/datastream_behavior.png" />

    <Info>
      ビヘイビアには **DataStream 1** と表示されます。バージョン 2 は後で選択するため、ここでは無視してください。
    </Info>
  </Step>

  <Step title="ステップ 10">
    **DataStream** セクションまでスクロールし、次のように選択します。

    * **Stream Version** ドロップダウンから **DataStream2** を選択します。

    * **Enable** を **On** に切り替えます。

    * **Stream Name** で作成したストリームを選択します。

    * サンプルレートを選択します。**100%** を推奨します。

          <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/add_stream_to_property.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=2c1d7e35b4578b1d9d5088abca0c9992" alt="datastream settings" width="2418" height="534" data-path="images/agent-analytics/akamai/add_stream_to_property.png" />
  </Step>

  <Step title="ステップ 11">
    左サイドバーから **Log Delivery** を選択します。

    次の項目を有効にします。

    * **Log Host Header**

    * **Log Referer Header**

    * **Log User-Agent Header**

    その他の設定はデフォルト値のままにしてください。

    <img src="https://mintcdn.com/profound-37face47/dU1U8PbY91PjiXyk/images/agent-analytics/akamai/log_delivery_behaviors.png?fit=max&auto=format&n=dU1U8PbY91PjiXyk&q=85&s=e5ab3c16f61a247431ddd4f38a9ad445" alt="log delivery settings" width="3680" height="2382" data-path="images/agent-analytics/akamai/log_delivery_behaviors.png" />
  </Step>

  <Step title="ステップ 12">
    設定を保存し、新しいバージョンを有効化します。
  </Step>
</Steps>

<Check>
  以上で完了です。Akamai から Profound にリアルタイムでログが送信されるようになります。ストリームを有効化してから **60 分**以内にダッシュボードにデータが表示され始めます。
</Check>

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

* ストリームが有効化され、プロパティに接続されていること、およびプロパティが更新されていることを確認してください

* Log Ingestion Token が正しいことを確認してください

## その他のリソース

* [Akamai Datastream2 ドキュメント](https://techdocs.akamai.com/datastream2/docs/welcome-datastream2)

* [ストリームの作成に関するドキュメント](https://techdocs.akamai.com/datastream2/docs/create-stream)

* [Data Set Parameters に関するドキュメント](https://techdocs.akamai.com/datastream2/docs/data-set-parameters)

* API に関するご質問は [support@tryprofound.com](mailto:support@tryprofound.com) までお問い合わせください

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

* Log Ingestion Token は定期的にローテーションしてください

* ログドレインの使用状況に異常なパターンや予期しないトラフィックの急増がないか監視してください
