ログストリーミング: Heroku の Logplex

  最終更新日 2023-09-13

Fastly のリアルタイムログストリーミング機能では、Heroku のアドオンを使用して、Heroku の Logplex システムに直接ログファイルを送信することができます。Logplex は、Heroku の分散型 syslog ルーターで、様々なソースからのログエントリを単一のチャンネルに送信し、照合します。

注意

Fastly ではサードパーティのサービスに関する直接のサポートは行っておりません。詳細については、Fastly のご利用規約をご覧ください。

前提条件

設定前に Heroku の Logplex アカウントのトークンが必要です。Heroku の Logplex アカウントをお持ちでない場合は、Heroku に登録してアカウントを作成してください。

有効にすると、Fastly のログを通常のアプリやホストされたサービスのログとまったく同じように利用できるようになります。Heroku のコマンドラインログビューアーを使用してログを確認したり、ログ記録のアドオンに送信することができます。

Heroku の Logplex をログエンドポイントとして追加する

以下の手順で、Fastly サービスのログエンドポイントとして Heroku の Logplex を追加します。

  1. Deliver サービス
  2. Compute サービス
  1. リモートログストリーミングの設定に関するガイドをご確認ください。
  2. Heroku Logplex エリアで、Create endpoint をクリックします。
  3. 以下の要領で Create a Heroku Logplex endpoint ページの各フィールドに入力します。
    • Name フィールドに分かりやすいエンドポイントの名前を入力します。
    • Placement セクションでは、生成される VCL にログコールが配置される場所を選択します。有効な値は Format Version Default、waf_debug (waf_debug_log)、None です。詳細については、ログ配置の変更に関するガイドをご覧ください。
    • Log format フィールドには、ログ形式に使用する Apache 形式の文字列や VCL 変数を任意で入力します。詳細については、形式例のセクションをご覧ください。
    • Tokenフィールドに Heroku Logplex のトークンを入力します。
    • URL フィールドには、Fastly のサポートスタッフからの指示がない限り https://1.us.logplex.io/logs と入力してください。　
  4. Create をクリックして新規のログエンドポイントを作成します。
  5. Activate をクリックして設定への変更をデプロイします。

フォーマットの例

以下に示すのは、Logplex にデータを送信する書式指定文字列の例です。書式指定文字列の詳細については、こちらをご覧ください。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "timestamp": "%{strftime(\{"%Y-%m-%dT%H:%M:%S%z"\}, time.start)}V",
  "client_ip": "%{req.http.Fastly-Client-IP}V",
  "geo_country": "%{client.geo.country_name}V",
  "geo_city": "%{client.geo.city}V",
  "host": "%{if(req.http.Fastly-Orig-Host, req.http.Fastly-Orig-Host, req.http.Host)}V",
  "url": "%{json.escape(req.url)}V",
  "request_method": "%{json.escape(req.method)}V",
  "request_protocol": "%{json.escape(req.proto)}V",
  "request_referer": "%{json.escape(req.http.referer)}V",
  "request_user_agent": "%{json.escape(req.http.User-Agent)}V",
  "response_state": "%{json.escape(fastly_info.state)}V",
  "response_status": %{resp.status}V,
  "response_reason": %{if(resp.response, "%22"+json.escape(resp.response)+"%22", "null")}V,
  "response_body_size": %{resp.body_bytes_written}V,
  "fastly_server": "%{json.escape(server.identity)}V",
  "fastly_is_edge": %{if(fastly.ff.visits_this_service == 0, "true", "false")}V
}

翻訳についての注意事項
このガイドは役に立ちましたか？

このフォームを使用して機密性の高い情報を送信しないでください。サポートが必要な場合は、サポートチームまでご連絡ください。このフォームは reCAPTCHA によって保護されており、Google のプライバシーポリシーと利用規約が適用されます。

Fastly
© Fastly 2024