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

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

> カスタムWebhookを使用して、ログイベントを任意のURLにストリーミングするログストリームを構成する方法を学びましょう。

Webhookは外部のWebサーバーにイベントを届けるようにします。Auth0はサードパーティのログ管理や分析システムに自動的にイベントをプッシュする複数の統合を提供します。サードパーティのシステムがサポートされていない場合、カスタムのWebhook統合をセットアップできます。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Webhookの構成につきペイロードURLを1つだけサブスクライブできますが、同じURLを複数のストリームに使用できます。ペイロードはJSON Lines形式で配信されます。Webhookの構成でログを使用する際には、この点に留意してください。
</Callout>

## APIエンドポイントを構成

1つのルート（`/api/logs`など）を提供するAPIを構築し、`HTTP POST`要求を受け入れます。

<Warning>
  自己署名付きHTTP証明書は、サポート対象外です。
</Warning>

## ログストリームを構成する

1. [［Dashboard］>［Monitoring（モニタリング）］>［Streams（ストリーム）］](https://manage.auth0.com/#/log-streams)に移動して、 **［Create Stream（ストリームの作成）］** をクリックします。

   <Frame>
     <img src="https://mintcdn.com/docs-dev-actions-triggers-prototype/dadTd1GKGvbSPiSP/docs/images/ja-jp/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png?fit=max&auto=format&n=dadTd1GKGvbSPiSP&q=85&s=cce426dd28f98b4e3f64adf35f5138fe" alt="Dashboard Monitoring Streams" width="1924" height="1336" data-path="docs/images/ja-jp/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png" />
   </Frame>

2. **［Custom Webhook（カスタムWebhook）］** を選択し、新しいストリームに対して一意の名前を入力します。

3. 次の設定を行います。

   <Frame>
     <img src="https://mintcdn.com/docs-dev-actions-triggers-prototype/dadTd1GKGvbSPiSP/docs/images/ja-jp/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/3886c59282d49515e58ac5f9f972e97b/Custom_Webhook_config_form.png?fit=max&auto=format&n=dadTd1GKGvbSPiSP&q=85&s=2880379fe1e3843e8f79d27389ca3df0" alt="Dashboard モニタリング ストリーム カスタムウェブフック設定タブ" width="1274" height="1935" data-path="docs/images/ja-jp/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/3886c59282d49515e58ac5f9f972e97b/Custom_Webhook_config_form.png" />
   </Frame>

   | 設定                                            | 説明                                  |
   | --------------------------------------------- | ----------------------------------- |
   | **Name（名前）**                                  | この統合を他の統合と区別する一意の表示名です。             |
   | **Payload URL（ペイロードURL）**                     | イベントのペイロードをHTTP POST要求として送信するURLです。 |
   | **Authorization Token（認可トークン）**               | （任意）要求のAuthorizationヘッダーに含まれる値です。   |
   | **Content Type（コンテンツタイプ）**                    | Webhookに転送されるペイロードのメディアタイプです。       |
   | **Content Format（コンテンツ形式）**                   | JSONの行、配列またはオブジェクトでデータを受信します。       |
   | **Filter by Event Category（イベントカテゴリーでフィルター）** | ログストリームフィルターのリストです。                 |
   | **Starting Cursor（開始カーソル）**                   | （任意）ストリームを開始する日時を指定します。             |

4. **［Save（保存）］** をクリックします。

## 構成をテストする

1. **［Health（ヘルス）］** ビューに切り替え、 **［Stream Status（ストリームステータス）］** が **［Active（アクティブ）］** になっていることを確認してください。
2. ログイン、トークン交換、Auth0 Management APIの呼び出しなどのテナントログイベントを作成するアクションを実行します。
3. イベントがテナントログに作成されたことを確認します。
4. APIがイベントデータと一緒に`HTTP POST`要求を受け取ったことを確認します。
5. **［Health（ヘルス）］** ビューに移動し、エラーが起きていないことを確認します。

## Webhookのトラブルシューティング

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/Runscope/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/)などのツールを使用して、実行フロー全体を監視します。

## もっと詳しく

* [ログストリームの正常性を確認する](/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)