> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> カスタム webhook を使ってログストリームを設定し、任意の URL にログイベントをストリーミングする方法を説明します。

# Webhook を使用してカスタムログストリームを作成する

Webhook を使用すると、イベントを外部の Web サーバーに配信できます。Auth0 では、イベントをサードパーティーのログ管理・分析システムに自動的に送信するための統合がいくつか用意されています。ただし、使用するサードパーティーシステムがサポートされていない場合は、カスタム webhook 統合を設定できます。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  各 webhook 設定で登録できるペイロード URL は 1 つのみですが、同じ URL を複数のストリームで使用できます。ペイロードは JSON Lines 形式で配信されます。Webhook 設定でログを取り込む際は、この点に注意してください。
</Callout>

<div id="configure-api-endpoint">
  ## APIエンドポイントを設定
</div>

`HTTP POST` リクエストを受け付ける、1つのルート (`/api/logs` など) のみを持つAPIを構築します。

<Warning>
  自己署名のHTTP証明書はサポートされていません。
</Warning>

<div id="configure-log-stream">
  ## ログストリームを設定する
</div>

1. [Dashboard > Monitoring > Streams](https://manage.auth0.com/#/log-streams) に移動し、**Create Stream** をクリックします。

   <Frame>
     <img src="https://mintcdn.com/translations/MV7tE-x71x8RWRES/docs/images/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png?fit=max&auto=format&n=MV7tE-x71x8RWRES&q=85&s=d758c12e1c9314e6cbddb3457bdf088e" alt="Dashboard Monitoring Streams" width="1924" height="1336" data-path="docs/images/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png" />
   </Frame>
2. **Custom Webhook** を選択し、新しいストリームに一意の名前を入力します。
3. 以下の設定を行います。

   <Frame>
     <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=7e02467792efac2a21bd4409a82adcc6" alt="Dashboard Monitoring Streams Custom Webhook Settings Tab" width="1498" height="2064" data-path="docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png" />
   </Frame>

   | 設定                           | 説明                                          |
   | ---------------------------- | ------------------------------------------- |
   | **Name**                     | この連携を他の連携と区別するための一意の表示名です。                  |
   | **Payload URL**              | イベントのペイロードが HTTP POST リクエストとして送信される URL です。 |
   | **Authorization Token**      | (任意) リクエストの Authorization ヘッダーに含まれる値です。     |
   | **Content Type**             | webhook に配信されるペイロードのメディアタイプです。              |
   | **Content Format**           | データの受信形式を JSON Lines、配列、またはオブジェクトから選択します。   |
   | **Filter by Event Category** | ログストリームのフィルター一覧です。                          |
   | **Starting Cursor**          | (任意) ストリームを開始する日時を指定します。                    |
4. **Save** をクリックします。

<div id="test-configuration">
  ## 設定のテスト
</div>

1. **Health**ビューに切り替え、**Stream Status**が**Active**になっていることを確認します。
2. ログイン、トークン交換、Auth0 Management API の呼び出しなど、テナントのログイベントが生成される操作を実行します。
3. そのイベントがテナントのログに記録されていることを確認します。
4. API がイベントデータを含む `HTTP POST` リクエストを受信していることを確認します。
5. **Health**ビューに移動し、エラーが発生していないことを確認します。

<div id="troubleshoot-webhooks">
  ## Webhook のトラブルシューティング
</div>

Webhook が正常に動作しない場合、原因を切り分けて特定するのは難しいことがあります。Webhook は非同期で動作するため、テストでは Webhook をトリガーして待機し、その後レスポンスを確認する必要がある場合があります (そもそもレスポンスを受け取れていればですが) 。

ただし、上で説明したような非効率な手順に代わる方法はあります。特定の Webhook のトラブルシューティング方法の詳細はこの記事の範囲外ですが、デバッグの際には次のような手順を試せます。

1. 参考になるメッセージがないか、[Auth0 Dashboard > Monitoring > Logs](/docs/ja-jp/deploy-monitor/logs) を確認します。
2. [Mockbin](http://mockbin.io/)、[Beeceptor](https://beeceptor.com/)、または (セルフホスト型の) [RequestBin](https://github.com/RonTt/Requestbin) などのツールを使って、Webhook が送信しているリクエストを分析します。
3. cURL または [Postman](https://www.getpostman.com/) を使ってリクエストをモックします。
4. [localtunnel](https://github.com/localtunnel/localtunnel) や [ngrok](https://ngrok.com/) などを使って、Webhook のコードをローカルでテストします。
5. [Runscope](https://www.runscope.com/) や [Assertible](https://assertible.com/) などのツールを使って、実行フロー全体を確認します。

<div id="learn-more">
  ## 詳細はこちら
</div>

* [ログストリームの状態を確認する](/docs/ja-jp/customize/log-streams/check-log-stream-health)
* [ログイベントを絞り込む](/docs/ja-jp/deploy-monitor/logs/log-event-filters)
* [ログタイプコード](/docs/ja-jp/deploy-monitor/logs/log-event-type-codes)