ユーザーとして Opsgenie の利用を開始する
プロフィールの設定、Opsgenie からの通知の取得、オンコール スケジュールの表示に関するすべての方法を説明します。
アラート コールバックを使用する
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 リクエスト本文の一部として以下の情報が渡されます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"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 のスクリプト プロキシ ドキュメントをご参照ください。 |
この内容はお役に立ちましたか?