アラートコールバックを使用する

Opsgenie は基本的に IT アラート用のルーターです。Opsgenie は、メールと API を介して運用管理システムからアラートを受信し、定義されたルールを使用して適切なユーザーに通知します。Opsgenie はコールバックもサポートし、アラートアクティビティ (アラートの作成、確認、クローズなど) を外部システムに転送できます。

アラートアクティビティは、HTTP リクエストを Webhook として処理できる任意のシステムに転送できます。Opsgenie が提供する Marid 統合サーバーを使用して、アラートアクティビティをサブスクライブし、Opsgenie を外部システムに統合することもできます。

1. Webhook コールバック

Opsgenie は、Web アクセス可能な URL エンドポイント (Webhook と呼ばれることが多い) を呼び出し、アラートアクティビティデータを渡すことができます。URL エンドポイントは、Web から URL にアクセスできる限り、任意のプラットフォーム、Web サーバーなどを指定できます。Webhook データには、アラートアクティビティ (作成、確認など) および HTTP リクエストペイロード (JSON) の一部として、アラートフィールドのサブセット (alertId、ユーザー名、エイリアス、エンティティ、userId) が含まれます。

Webhook は Opsgenie Webhook インテグレーションを介して作成できます。Webhook インテグレーションの詳細については、サポートドキュメントをご参照ください。

たとえば、アラートが作成されると、HTTP リクエスト本文の一部として以下の情報が渡されます。

{
  "source": {
     "name": "mytool",
    "type": "api"
  },
  "alert": {
    "message": "testing webhooks",
    "username": "fili@opsgenie.com",
    "alertId": "44f717bf-44bd-11c9-44c7-2d0cf1d07b23",
    "alias": "webhooktest",
    "tinyId": "454",
    "entity": "",
    "userId": "4caaaa77-9222-4322-8622-d3522fbd7dda"
  },
  "action": "Create"
}

"action" フィールド値は、"Create"、"Acknowledge"、"AddNote"、"AssignOwnership"、"Close"、"Delete"、またはカスタムアクションの名前を指定できます。

Opsgenie アラート API を使用してアラートリクエストを取得すると、Webhook ペイロードに含まれる alertId を使用して他のアラートフィールドを取得できます。

2. Marid コールバック

Marid 統合サーバーでは、OpsGenie アラートアクティビティをサブスクライブし、アラートアクティビティごとにスクリプトを実行できます。この方法の主な違いは、Opsgenie への接続は Marid によって開始されるため、Marid サーバーは、Web からアクセス可能である必要はないということです。この方法は、Marid が HTTPS 経由で Opsgenie と通信し、内側から接続を開始するため、ファイアウォールの変更、ポートの開放などを必要としません。

Marid インストール手順を参照して、システムに Marid をインストールする必要があります。

このオプションを使用するには、Marid 統合を作成し、apiKey を取得し、Marid の設定ファイルに貼り付けます。

Marid 統合を追加した後、Marid を既に実行している場合は、再起動する必要があります。

Marid は、アラートアクションごとに groovy または ruby スクリプトを実行します。Marid は、アクションと同じ名前のファイルで <MARID_HOME>/scripts ディレクトリを検索して、既定でそのスクリプトをいくつかのパラメーターで実行します。たとえば、アクション「restart」が実行されると、Marid は <MARID_HOME>/scripts/restart.groovy または <MARID_HOME>/scripts/restart.rb を検索します。そのスクリプトが存在する場合、Marid はスクリプトを自動で実行します。また、スクリプトマッピングへのアクションは、Marid の設定ファイルで設定できます。たとえば、Marid が次の設定 actions.restart.script=script1.groovy で開始された場合は、restart アクションの実行ごとに、<MARID_HOME>/scripts/script1.groovy が実行されます。

設定	説明	(必須)	既定値
actions.<action_name>.script=<script_name>	スクリプトマッピング構成に対するアラートアクション。設定したアラートアクションの実行ごとに指定する場合、<MARID_HOME>/scripts ディレクトリにある groovy または ruby スクリプトファイルが呼び出されます。	いいえ	-

アラートアクションのスクリプトパラメーター

パラメーター	説明
警報	アクションが実行されるアラートプロパティにアクセスするための変数。alertId、ユーザー名、およびこのようなプロパティには、この変数を使用してアクセスできます。
操作	実行したアクションの名前
conf	設定ファイルのプロパティへの参照。すべての設定プロパティには、このパラメーターを介してアクセスできます。
logger	ロギングユーティリティ。すべてのスクリプトログは <MARID_HOME>/logs/script.log ファイルに書き込まれます。
Opsgenie	Opsgenie サーバー上で操作を実行するための変数。使用可能な操作のリストについては、Marid のスクリプトプロキシドキュメントをご参照ください。

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

アラート コールバックを使用する

1. Webhook コールバック

2. Marid コールバック

アラート アクションのスクリプト パラメーター

さらにヘルプが必要ですか?

アラートコールバックを使用する

アラートアクションのスクリプトパラメーター