PagerDuty 用の Webhook 接続
PagerDuty webhook 接続により、Scheduled Search の結果を PagerDuty 通知として送信できます。PagerDuty webhook の詳細については、その API ヘルプを参照してください。
webhook 接続には、Sumo Logic にデータの送信先を指示する HTTP エンドポイントが必要です。任意の数の接続をセットアップできます。
webhook 用のサービス キーの作成
ペイロードの service_key フィールドについて、PagerDuty UI を使用して汎用 API サービス キーを生成する必要があります。
- アカウントの [Services (サービス)] タブで、[Add New Service (新規サービスの追加)] をクリックします。
- サービスの名前を入力してエスカレーション ポリシーを選択します。[Service Type (サービス タイプ)] について [Generic API (汎用 API)] を選択します。
- [Add Service (サービスの追加)] をクリックします。
- サービスを作成すると、サービス ページが開きます。表示されたサービス キーを使用して、このトピックの手順で説明しているようにペイロードを設定します。
PagerDuty 用の webhook 接続のセットアップ
- [Manage Data (データの管理)] > [Settings (設定)] > [Connections (接続)] に移動します。
- [Connections (接続)] ページで、[Add (追加)] をクリックします。
- [PagerDuty] をクリックします。
- [Create Connection (接続の作成)] ダイアログに、接続の名前を入力します。
- (省略可能) 接続の説明を入力します。
- エンドポイントの URL を入力します。
https://events.pagerduty.com/generic/2010-04-15/create_event.json
- (省略可能) 認証ヘッダーを入力します。認証トークンを含めることもできます。入力したすべてのテキストはヘッダーに含まれます。
形式: Token token=KdmGgrorGeABCDm1zDdC where KdmGgrorGeABCDm1zDdC is the API key. - (省略可能) [Custom Headers (カスタム ヘッダー)]。最大 5 つのコンマ区切りのキーと値のペアを入力します。
- [Payload (ペイロード)] で、サービス キーを入力します。これは、前のセクションで作成したものです。続いて、PagerDuty に必要な形式で JSON オブジェクトを入力します。JSON オブジェクト内でパラメータとして使用できる変数の詳細については、「Webhook ペイロードの変数」を参照してください。
- [Save (保存)] をクリックします。
Scheduled Search の作成
Scheduled Search とは、指定された間隔で自動的に実行される保存済み検索です。アラートを送信するように Scheduled Search を設定した場合、webhook 経由の PagerDuty への接続にアラートを送信できます。
まったく新しい検索を作成することも、既存の保存済み検索または Scheduled Search に基づくこともできます。既存の検索を使用する場合、検索の現在のスケジュールが上書きされないようにクエリを新規検索として保存する必要があります。手順については「Webhook 接続用の Scheduled Search」を参照してください。
webhook 用の Scheduled Search をセットアップする前に、webhook 接続を設定します。
Webhook 経由の PagerDuty インシデント レポートの作成
次のペイロードを使用すれば、webhook を使用して PagerDuty インシデントを作成できます。
{ "service_key": "SERVICE KEY", "event_type": "trigger", "description": "SAMPLE DESCRIPTION", "client": "Sumo Logic", "client_url": "{{SearchQueryUrl}}", "details": { "name": "{{SearchName}}", "time": "{{TimeRange}}--{{FireTime}}", "num": "{{NumRawResults}}", "query": "{{SearchQuery}}", "agg": "{{AggregateResultsJson}}", "raw": "{{RawResultsJson}}" } }