> ## 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.

# Fastly HTTPS エンドポイント

> Fastly のカスタム HTTPS エンドポイントを使用して、Fastly のリアルタイムログを Profound Agent Analytics プラットフォームに配信する設定方法を説明します

## 概要

この統合では、Fastly のカスタム HTTPS エンドポイントを使用して、Fastly のリアルタイムログを Agent Analytics API に転送します。Fastly のリアルタイムログストリーミングは、トラフィック、パフォーマンス、脅威、トラブルシューティングを即座に可視化し、HTTP エンドポイントを含むさまざまな宛先にログをストリーミングします。Fastly のリアルタイムログの詳細については、[Fastly のドキュメント](https://docs.fastly.com/en/guides/streaming-logs)を参照してください。

## 前提条件

* Fastly アカウント

* Logging Endpoints を編集するためのアクセス権/権限

* Agent Analytics 用の Profound Log Ingestion Token

## 設定

<img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/fastly_setup.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=376e9c92e922aed26a434d2028bc0af0" alt="Fastly の検出" width="3680" height="2390" data-path="images/agent-analytics/fastly/fastly_setup.png" />

<Steps>
  <Step title="ステップ 1">
    Fastly コンソールにサインインし、サービスを選択して、Service configuration タブに移動します。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/service_configuration.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=9f5c9b84ec0be5034c9e3d29a998bc68" alt="Service Configuration タブ" width="2542" height="348" data-path="images/agent-analytics/fastly/service_configuration.png" />
  </Step>

  <Step title="ステップ 2">
    「Edit configuration」を選択し、Logging セクションに移動します。

    「HTTPS」を見つけて `+ Create endpoint` をクリックします。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/logging_endpoint.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=1fdf94eb3baeea16c21a0b2d651602f7" alt="ログエンドポイント" width="2490" height="2018" data-path="images/agent-analytics/fastly/logging_endpoint.png" />
  </Step>

  <Step title="ステップ 3">
    次の設定で HTTPS エンドポイントを構成します。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/create_https_endpoint.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=f229d92714f0e359e77fe14b9e625acf" alt="設定" width="1348" height="1840" data-path="images/agent-analytics/fastly/create_https_endpoint.png" />

    * **Name:** わかりやすい名前を入力します

    * **Placement:** デフォルトを使用します

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

    * **Maximum logs & Maximum bytes:** 任意です。必要に応じて設定してください。

    * **Log format**: 次のログ形式を貼り付けます。これにより、Agent Analytics API に送信される情報が決まります。別の形式を使用すると、ログが API によって拒否される場合があります。

      ```
        {
            "timestamp": "%{strftime(\{"%Y-%m-%dT%H:%M:%S%z"\}, time.start)}V",
            "client_ip": "%{req.http.Fastly-Client-IP}V",
            "start_time": "%{begin:%Y-%m-%dT%H:%M:%S%z}t",
            "end_time": "%{end:%Y-%m-%dT%H:%M:%S%z}t",
            "host": "%{req.http.Host}V",
            "url": "%{json.escape(req.url)}V",
            "request_method": "%{json.escape(req.method)}V",
            "request_referer": "%{json.escape(req.http.referer)}V",
            "request_user_agent": "%{json.escape(req.http.User-Agent)}V",
            "response_status": %{resp.status}V,
            "response_body_size": %{resp.body_bytes_written}V
        }
      ```

      * 時刻と IP

        * `timestamp` - リクエストが完了した時刻

        * `client_ip` - クライアントの IP アドレス

      * リクエストの詳細

        * `request_method` - HTTP リクエストメソッド

        * `host` - リクエストされたホストヘッダー

        * `url` - リクエストの URL パス

        * `request_referer` - リクエストのリファラー

        * `request_user_agent` - クライアントのユーザーエージェント

      * レスポンスの詳細

        * `start_time` - リクエストが開始された時刻

        * `end_time` - リクエストが終了した時刻

        * `response_status` - HTTP レスポンスステータス

        * `response_body_size` - レスポンスのサイズ (バイト)

      *詳細については[ドキュメント](https://docs.fastly.com/en/guides/useful-variables-to-log)を参照してください*

          <Note>
            次のような警告が表示される場合があります。

            <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/warning_message.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=05aab745a4e1946bb2ae3cec2df9527c" alt="警告メッセージ" width="1908" height="130" data-path="images/agent-analytics/fastly/warning_message.png" />

            このメッセージは無視しても問題ありません。検証はすでに設定済みです。
          </Note>
  </Step>

  <Step title="ステップ 4">
    次に、「Attach a condition」をクリックします。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/attach_a_condition1.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=70409e193f42a771baa45bb24c161099" alt="条件の設定 1" width="934" height="104" data-path="images/agent-analytics/fastly/attach_a_condition1.png" />

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/attach_a_condition2.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=a9c05f001e10b3e81e3b9d7e63bd3817" alt="条件の設定 2" width="1842" height="264" data-path="images/agent-analytics/fastly/attach_a_condition2.png" />

    ドメイン名を使用して次のように入力します。

    `req.http.host == "my-website.com"`

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/filter_to_host.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=70fb508bcb2ebfc02de72b1603b7ee9b" alt="ホストでフィルタリング" width="990" height="1100" data-path="images/agent-analytics/fastly/filter_to_host.png" />

    このフィルターにより、選択したドメインのログのみが Profound に送信されます。`Save and apply` を選択します。
  </Step>

  <Step title="ステップ 5">
    「Advanced options」までスクロールします。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/fastly/advanced_options.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=f604cc2170c571c08d0f610874d8c6c2" alt="Advanced Options" width="1942" height="1498" data-path="images/agent-analytics/fastly/advanced_options.png" />

    次のように設定します。

    * **Content type** - `application/json`

    * **Custom header name** - `X-API-Key`

    * **Custom header value** - Profound の Agent Analytics プラットフォーム用に発行された Log Ingestion Token (`bot_PROFOUND_LOG_INGESTION_TOKEN`)

    * **Method** - `POST`

    * **JSON log entry format** - `Array of JSON`

    * **Select a log line format** - `Blank`
  </Step>

  <Step title="完了">
    設定を保存し、新しいサービスバージョンを有効化します。
  </Step>
</Steps>

<Check>以上です。これで Fastly がリアルタイムログを Profound に送信するようになります。数分以内にダッシュボードにデータが表示され始めます。</Check>

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

* ログが表示されない場合は、HTTPS エンドポイントの設定を確認してください

* Fastly で配信エラーを確認してください

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

* API エンドポイントが正しいことを確認してください

## その他のリソース

* [Fastly のリアルタイムログストリーミング](https://docs.fastly.com/en/guides/about-fastlys-realtime-log-streaming-features)

* [Log streaming: HTTPS](https://docs.fastly.com/en/guides/log-streaming-https)

* [ログ形式](https://docs.fastly.com/en/guides/useful-log-formats)

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