> ## 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>

単一のルート (`/api/logs` など) を持ち、`HTTP POST` リクエストを受け付ける 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>

   | 設定                           | 説明                                          |
   | ---------------------------- | ------------------------------------------- |
   | **名前**                       | この統合を他の統合と区別するための一意の表示名です。                  |
   | **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. イベントデータを含む `HTTP POST` リクエストを API が受信したことを確認します。
5. **Health** ビューに移動し、エラーが発生していないことを確認します。

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

Webhook が機能していない場合、問題の原因を特定するのは簡単ではありません。Webhook は非同期で動作するため、テストでは webhook をトリガーしてしばらく待ち、その後レスポンスを確認する必要があります (レスポンスが返ってきた場合) 。

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

1. [Auth0 Dashboard > Monitoring > Logs](/ja/docs/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>

* [ログストリームの正常性を確認する](/ja/docs/customize/log-streams/check-log-stream-health)
* [ログイベントをフィルタリングする](/ja/docs/deploy-monitor/logs/log-event-filters)
* [ログタイプコード](/ja/docs/deploy-monitor/logs/log-event-type-codes)