ログストリーミング: Loggly

Fastly のリアルタイムログストリーミング機能によって、ログファイルを Loggly に送信することができます。Loggly はエージェントレス型のログ収集および管理ツールです。

前提条件

Loggly のアカウントをお持ちでない場合は、登録してアカウントを作成する必要があります。Loggly Web サイトの登録手順に従ってアカウントを作成してください。

以下の手順で Loggly のカスタマートークンを見つけます。

1. Loggly ダッシュボードで Source Setup を選択し、Customer Tokens にアクセスします。

   

2. Loggly のカスタマートークンをメモしてください。Loggly は、お客様が送信したデータをお客様のアカウントと関連付けるためにこのトークンを使用します。

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

Loggly アカウントを作成し、カスタマートークンを取得した後、以下の手順で Fastly サービスのログエンドポイントとして Loggly を追加します。

1. リモートログストリーミングの設定に関するガイドの情報をご参照ください。
2. Loggly の Create endpoint ボタンをクリックします。Create a Loggly endpoint ページが表示されます。
3. 以下の要領で Create a Loggly endpoint ページの各フィールドに入力します。
   • Name フィールドに分かりやすいエンドポイントの名前を入力します。
   • Placement セクションでは、生成される VCL にログコールが配置される場所を選択します。有効な値は Format Version Default、waf_debug (waf_debug_log)、None です。詳細については、ログ配置の変更に関するガイドをご参照ください。
   • Log format 欄には、ログフォーマットに使用するための Apache 形式の文字列や VCL 変数を任意で入力します。詳細は形式の例のセクションを参照してください。
   • Token フィールドに Loggly のカスタマートークンを入力します。
4. Create ボタンをクリックすると、新しいログエンドポイントが作成されます。
5. Activate ボタンをクリックして設定変更をデプロイします。

の形式例

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

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