ログストリーミング: Coralogix

  最終更新日 2024-07-03

Fastly のリアルタイムログストリーミング機能によって Coralogix にログファイルを送信することができます。Coralogix は動的アラート、比率ベースのアラート、フローの異常検出、そして 脅威発見機能などで異常な動作を検出できる分析プラットフォームを提供しています。

注意

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

前提条件

まだ Coralogix のアカウントをお持ちでない場合、Coralogix の Web サイトの登録手順に従ってアカウントを登録する必要があります。登録が完了したら、Coralogix のダッシュボードの Settings セクションにある Send Your Logs エリアに移動し、固有の秘密鍵をメモします。この秘密鍵は、お客様が送信したデータをお客様のアカウントと関連付けるために、Coralogix によって使用されます。Fastly でエンドポイントを設定する際に必要となります。

ヒント

Coralogix の Fastly との統合 に関するドキュメントをお読みください。

Coralogix をログエンドポイントとして追加

以下の手順で、Coralogix をログエンドポイントとして追加します。

  1. Deliver サービス
  2. Compute サービス
  1. リモートログストリーミングの設定に関するガイドをご確認ください。
  2. HTTPS エリアで、Create endpoint をクリックします。
  3. Create an HTTPS endpoint フィールドに次のように入力します。
    • Name フィールドに分かりやすいエンドポイントの名前を入力します。
    • Placement セクションでは、生成される VCL にログコールが配置される場所を選択します。有効な値は Format Version Default、waf_debug (waf_debug_log)、None です。詳細については、ログ配置の変更に関するガイドをご覧ください。
    • Log format フィールドで、プレースホルダーとして入力されているログ形式を、以下の推奨されるログ形式とフィールド設定に示すように適切に変更してください。
    • URL フィールドに、Coralogix Domain の Coralogix REST API Singles Endpoint を入力します。 例えば、https://ingress.coralogix.us/logs/v1/singles ドメインには coralogix.us を使用できます。
    • Maximum logs フィールドは、デフォルトの値である 0のままにしておきます。
    • Maximum bytes フィールドに、2000000 を入力します。
  4. Advanced options をクリックして、以下のようにフィールドにすべて入力します。
    • Content type フィールドに application/json を入力します。
    • Custom header name フィールドに Authorization を入力します。
    • Custom header value フィールドに Bearer <your Coralogix private key> を入力します。
    • Method コントロールから、POST を選択します。
    • JSON log entry format コントロールから、Array of JSON を選択します。
    • Select a log line format コントロールはデフォルトのままにします。
    • 残りのフィールドは空白のままにします。
  5. Create をクリックして新規のログエンドポイントを作成します。
  6. Activate をクリックして設定への変更をデプロイします。
注意

Coralogix では、HTTPS ドメイン所有権証明の要件を満たすように特に設定する必要はなく、警告を無視しても問題ありません。

推奨されるログ形式とフィールド設定

以下のログ形式を使用します。

1{
2  "timestamp":%{time.start.msec}V,
3  "applicationName":"fastly",
4  "subsystemName":"%{req.service_id}V",
5  "severity": 3,
6  "json": {
7    "time": {
8        "start":"%{begin:%Y-%m-%dT%H:%M:%S%Z}t",
9        "end":"%{end:%Y-%m-%dT%H:%M:%S%Z}t",
10        "elapsed":%D
11    },
12    "cdn_server": {
13        "ip_ipaddr":"%A",
14        "code":"%{server.datacenter}V",
15        "hostname":"%{server.hostname}V",
16        "region_code":"%{server.region}V",
17        "response_state":"%{fastly_info.state}V",
18        "is_h2":%{if(fastly_info.is_h2, "true", "false")}V,
19        "is_h2_push":%{if(fastly_info.h2.is_push, "true", "false")}V,
20        "h2_stream_id":"%{fastly_info.h2.stream_id}V"
21    },
22    "client": {
23        "city_name":"%{client.geo.city.utf8}V",
24        "country_code":"%{client.geo.country_code}V",
25        "country_name":"%{client.geo.country_name}V",
26        "continent_code":"%{client.geo.continent_code}V",
27        "region":"%{client.geo.region}V",
28        "ip_ipaddr":"%h",
29        "name":"%{client.as.name}V",
30        "number":"%{client.as.number}V",
31        "connection_speed":"%{client.geo.conn_speed}V",
32        "location_geopoint": {
33            "lat":%{client.geo.latitude}V,
34            "lon":%{client.geo.longitude}V
35        }
36    },
37    "response": {
38        "status":%>s,
39        "content_type":"%{Content-Type}o",
40        "age":"%{Age}o",
41        "cache_control":"%{Cache-Control}o",
42        "expires":"%{Expires}o",
43        "last_modified":"%{Last-Modified}o",
44        "tsv":"%{TSV}o",
45        "header_size":%{resp.header_bytes_written}V,
46        "body_size":%B
47    },
48    "request": {
49        "host":"%{req.http.host}V",
50        "is_ipv6":%{if(req.is_ipv6, "true", "false")}V,
51        "backend":"%{req.backend}V",
52        "service_id":"%{req.service_id}V",
53        "url":"%{cstr_escape(req.url)}V",
54        "url_ext":"%{req.url.ext}V",
55        "header_size":%{req.header_bytes_read}V,
56        "body_size":%{req.body_bytes_read}V,
57        "method":"%m",
58        "protocol":"%H",
59        "referer":"%{Referer}i",
60        "user_agent":"%{User-Agent}i",
61        "accept_content":"%{Accept}i",
62        "accept_language":"%{Accept-Language}i",
63        "accept_encoding":"%{Accept-Encoding}i",
64        "accept_charset":"%{Accept-Charset}i",
65        "connection":"%{Connection}i",
66        "dnt":"%{DNT}i",
67        "forwarded":"%{Forwarded}i",
68        "via":"%{Via}i",
69        "cache_control":"%{Cache-Control}i",
70        "x_requested_with":"%{X-Requested-With}i",
71        "x_att_device_id":"%{X-ATT-Device-Id}i",
72        "x_forwarded_for":"%{X-Forwarded-For}i"
73    },
74    "socket": {
75        "cwnd":%{client.socket.cwnd}V,
76        "pace":%{client.socket.pace}V,
77        "nexthop":"%{client.socket.nexthop}V",
78        "tcpi_rcv_mss":%{client.socket.tcpi_rcv_mss}V,
79        "tcpi_snd_mss":%{client.socket.tcpi_snd_mss}V,
80        "tcpi_rtt":%{client.socket.tcpi_rtt}V,
81        "tcpi_rttvar":%{client.socket.tcpi_rttvar}V,
82        "tcpi_rcv_rtt":%{client.socket.tcpi_rcv_rtt}V,
83        "tcpi_rcv_space":%{client.socket.tcpi_rcv_space}V,
84        "tcpi_last_data_sent":%{client.socket.tcpi_last_data_sent}V,
85        "tcpi_total_retrans":%{client.socket.tcpi_total_retrans}V,
86        "tcpi_delta_retrans":%{client.socket.tcpi_delta_retrans}V,
87        "ploss":%{client.socket.ploss}V
88    }
89  }
90}

以下の推奨形式の最初の5つのフィールドは必須です。

  • timestamp: このフィールドの形式は変更しないでください。

  • applicationName: このフィールドにはアプリケーションの名前を入力してください。

  • subsystemName: このフィールドにサブシステムの名前を入力してください。これは、コンポーネントを分離するために使用されます。例では req.service_id を使用していますが、これは対人可読媒体ではありません。サブシステムを識別するのに分かりやすい、意味のあるサブシステム名を使用してください。

  • severity: 重大度を指定し、以下の選択肢を使用してすべてのログに適用することができます: 1 (デバッグ)、2 (冗長化)、3 (情報)、4 (警告)、5 (エラー)、6 (危機的)。これは後から、後述の抽出ルールを使って変更することができます。

  • json (object): 必要に応じてフィールドを追加または削除してください。静的フィールドを追加することができます。Fastly VCL リファレンス に記載されているフィールドを含む、ネスト化された JSON 形式がサポートされています。

    ネストされた response.status フィールドの指定は、リクエストのサービスを特定するための便利な方法です。Coralogix 解析ルールを使用すると、ログのステータスコード値で Coralogix インターフェイスの重大度フィールドにデータを入力するように JSON 抽出ルールを設定することができます。具体的には、HTTP ステータスコードを重大度の値を自動的にマッピングすることができます。例えば、ステータスコード 2xx は Coralogix の深刻度を "INFO" とし、 ステータスコード 4xx は Coralogix の深刻度を "ERROR" とします。

    Coralogix コントロールパネルでは、以下のように表示されます。

    ![新しい Coralogix ルール の 作成](/img/guides/create-new-coralogix-rule.png)

Coralogix ダッシュボードとアラートの設定

Coralogix は、ダッシュボードやアラートを介して Fastly と自社サービスを統合するためのチュートリアルを提供しています。サービスの概要、ビジターの内訳、サービスの質など、Fastly のデータを使って作成されたデータダッシュボードの例が掲載されています。

チュートリアルでは、Fastly からのログの受信問題、オリジンでの障害、エラー率やキャッシュミスの増加、様々な異常や疑わしいリクエスト、Web サイトの改ざんなどの状況に応じてユーザー定義アラート設定する方法も説明されています。


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

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

Fastly
© Fastly 2024