Compute@Edge ログストリーミング:New Relic Logs
最終更新日 2022-09-06
Fastly の Compute@Edge サービスのリアルタイムログストリーミング機能では、ログファイルを New Relic Logs に送信することができます。
注意
Fastly ではサードパーティのサービスに関する直接のサポートは行っておりません。詳細については、Fastly サービスの利用規約をご参照ください。
前提条件
Fastly Compute@Edge サービスのログエンドポイントとして New Relic Logs を追加する前に以下が必要です。
- New Relic アカウント を登録します。
- ライセンスキーを取得するか、任意で Insert API キーを作成します。
ログエンドポイントとして New Relic Logs を追加する
以下の手順で New Relic Logs をログエンドポイントとして追加します。
- リモートログストリーミングの設定に関するガイドの情報をご参照ください。
ヒント
Rust、AssemblyScript、および JavaScript で書かれた Compute@Edge コードでログ記録を実行する方法に関する詳細については Fastly の開発者向けドキュメントをご覧ください。
New Relic Logs のCreate endpointボタンをクリックします。Create a New Relic Logs endpoint ページが表示されます。
以下の要領でCreate a New Relic Logs endpointページの各フィールドに入力します。
- Name フィールドに、Compute@Edge コードに指定した名前を入力します。例えば、Rust コードの例では、名前は
my_endpoint_name
です。 - License key / Insert keyフィールドに、New Relic のライセンスキーまたは Insert API キーを入力します。
- Name フィールドに、Compute@Edge コードに指定した名前を入力します。例えば、Rust コードの例では、名前は
- Create ボタンをクリックすると、新しいログエンドポイントが作成されます。
- Activate ボタンをクリックして設定変更をデプロイします。
New Relic Instant Observability の事前構築 Fastly ダッシュボードの使用
New Relic I/Oは、コミュニティが貢献したさまざまなモニタリングクイックスタートを備えたオープンソースのエコシステムです。New Relic と協力し、重要なメトリクスをハイライトする事前構築済みダッシュボードを開発しました。コードはオープンソースであるため、カスタマイズすることができます。
ログメッセージの設定
New Relic Logs に送られるデータは、JSON オブジェクトとして直列化する必要があります。JSON オブジェクトには、次のフィールドが含まれます:
timestamp
:リクエストが発生した場合。エポックが New Relic タイムスタンプを上書きするため、タイムスタンプはミリ秒または秒として指定する必要があります。タイムスタンプが含まれていない場合は、Fastly によってタイムスタンプが生成されます。client_ip
:HTTP リクエストを行ったクライアントの IP アドレス。url
:リクエストの URL。resp_status
:リクエストの HTTP ステータスコード。client_resp_header_size_write
:レスポンスヘッダーのサイズ。client_resp_body_size_write
:レスポンスボディのサイズ。fastly_datacenter
:現在のインスタンスが実行されている FASTLY_POP の3文字の識別コード。time_elapsed
:リクエストが開始された時間。service_id
:現在のリクエストを処理する Fastly サービスの識別子。
JSON オブジェクトの例は、下記のとおりです。
1{2 "timestamp": 1661976797605,3 "client_ip": "127.0.0.1",4 "url": "https://curiously-selected-llama.edgecompute.app/",5 "resp_status": 200,6 "client_resp_header_size_write": 1234,7 "client_resp_body_size_write": 56789,8 "fastly_datacenter": "IAD",9 "time_elapsed": 237,10 "service_id": "<service id>"11}
JSON オブジェクトに予想されるフィールドがすべて含まれていない場合、事前構築されたダッシュボードは壊れませんが、特定のチャートにはデータが含まれません。
期待されるフィールドに加えて、個人の目的のためにJSON オブジェクトに選択したフィールドを含めるか、構築した既存のダッシュボードとの後方互換性を維持することができます。
Fastly ダッシュボードをインストールする
Fastly ダッシュボードクイックスタートをインストールする手順に従ってください。
- 新しい Relic マーケットプレイスから Fastly ダッシュボードクイックスタートを選択するか、Fastly ダッシュボードページに直接移動します。Fastly CDN ページが表示されます。
- Install quickstart ボタンをクリックします。クイックスタートインストールページが表示されます。
- インストールを開始ボタンをクリックします。インストールプランウィンドウが表示されます。
- Done ボタンまたは Skip this step リンクをクリックします。
- データを表示ボタンをクリックします。Fastly ダッシュボードが表示されます。