Opsgenie にアラートを送信する
Webhook と Jira 自動化を使用して Opsgenie にアラートを送信します。Jira 自動化について
誰がこれを実行できますか? |
ステップ 1: Opsgenie で新しい API 統合を作成する
Opsgenie では、設定内またはチーム内で API 統合を作成できます。この例では、チーム向けの統合を作成します。Opsgenie で API 統合を作成する方法
Opsgenie で新しい API 統合を作成するには、次の手順に従います。
Opsgenie でチームに移動して、[統合] を選択します。
[統合の追加] を選択します。
API 統合を検索します。
統合に名前をつけます (例: アトラシアン)。
アラート)、チームに割り当てます。
[続行] を選択します。
API キーをメモしておきます。これは後ほどステップで必要となります。
ステップ 2: Jira 自動化ルールを作成して、Webhook URL を取得する
自動化ルールはグローバル ルールとして作成できますが、ご自身が Jira 管理者でない場合は Jira プロジェクトでも作成できます。この例では、プロジェクト内でルールを作成します。
Jira で自動化ルールを作成するには、次の手順に従います。
Jira でプロジェクトに移動します。
[プロジェクト設定] > [自動化] に進みます。
[ルールを作成] を選択します。
[受信 Webhook] コンポーネントを検索します。
自動化ルールの実行方法を尋ねられたら、[Webhook からの課題がない] を選択します。
Webhook URL をコピーします。これは次のステップで必要となります。
[受信 Webhook] コンポーネントに変更を保存します。
ステップ 3: Webhook URL を Guard Detect に追加する
Webhook URL を追加するには、次の手順に従います。
Guard Detect で、[統合] > [SIEM Webhook] に移動します。
[Webhook URL を追加] を選択します。
Jira からコピーした Webhook URL を貼り付けて [保存] します。
ステップ 4: 課題を作成するための自動化ルールを設定する
Jira で自動化ルールに戻り、[THEN: アクションを追加] を選択します。
[Web リクエストを送信] コンポーネントを検索します。
Opsgenie API URL や API キーなど、Web リクエストの詳細を入力します。下のテーブルをご参照ください。
[Web リクエストを送信] コンポーネントに変更を [保存] します。
自動化ルールに名前を付けて [オンにする] を選択します。
Web リクエストの詳細
次の情報を使用して Web リクエストを設定します。
Web リクエスト URL | https://api.opsgenie.com/v2/alerts |
---|---|
ヘッダー | Authorization ヘッダーを追加して、Opsgenie API キーを GenieKey abcdefg-a25a-4652-883c-73703b12345 形式の値として指定します。 |
HTTP メソッド | POST |
Web リクエスト本文 | カスタム データ |
カスタム データ | Webhook ペイロードのデータを Opsgenie アラートに含めることができます。たとえば、次のようにアラートのタイトルを含められます。 1
2
3
{
"message":"{{webhookData.alertTitle}}"
} これはシンプルな一例です。Webhook ペイロードの任意の属性を使用して、Opsgenie フィールドにマッピングできます。 |
ステップ 4: テスト アラートを送信する
テスト アラートを送信するには、次の手順に従います。
Guard Detect で、[統合] > [SIEM Webhook] に移動します。
この統合用の Webhook の横にある [テスト] を選択します。
統合が機能していれば、Opsgenie チームに対して新しいアラートが表示されるようになります。
ツールに送信されるデータ
統合を設定すると、選択したサードパーティ ツールにアラート データが送信されるようになります。 アラートのタイトル、説明、コンテキストが送信され、以下が含まれる場合があります。
アクターの名前とそのプロフィール写真
対象の名前 (個人、またはスペース、プロジェクト、ポリシーなどのエンティティ)
アクティビティが発生したサイト URL またはページ URL
アクターの Atlassian アカウント プロフィールの表示設定が優先されます。 アクターが自分のプロフィール写真をアトラシアン組織と共有しないことを選択している場合にはその設定が優先されます。
統合を設定する前に、このデータをサードパーティ ツールと共有することが適切であることを確認する必要があります。
この内容はお役に立ちましたか?