Opsgenie に Marid インテグレーションを追加する

Opsgenie Marid を視聴する: オンプレミス モニタリングと ITSM ツールの接続

OpsGenie Marid インテグレーションを使用すると、システムと OpsGenie 間の双方向ブリッジの管理、OpsGenie アラート アクティビティのシステムへの転送、システムからイベントに関するアラートの更新を行えます。

このドキュメントでは、OpsGenie Marid インテグレーションのインストール方法と使用方法について説明します。

• Opsgenie に Marid インテグレーションを追加する

• Marid をインストールする

• Marid 設定

• アラートアクションの実行

Opsgenie に Marid インテグレーションを追加する

1. Opsgenie アカウントをまだ作成していない場合は作成してください。

2. Opsgenie Marid インテグレーション ページに移動します。

3. [Save Integration (統合を保存)] ボタンをクリックして統合を保存します。統合用の「API キー」が生成されるので、コピーします。このキーは、Opsgenie で認証するために Marid によって使用されます。

Marid をインストールする

「概要とインストール」ドキュメントを参照して、Marid をインストールしてください。

Marid 設定

Marid の設定については、「概要とインストール」ドキュメントをご参照ください。

Marid インテグレーションを使用するには、Marid の apikey 設定を設定する必要があります。

プロキシ サーバーの背後にある Marid セットアップのプロキシの構成

社内サーバーからのインターネットへの直接アクセスは、ほとんどのエンタープライズ環境では許可されていません。代わりに、いくつかのプロキシ サーバーを設定して、すべてのアプリケーションはこれらのプロキシ サーバーを介してインターネットに接続するように構成されています。このタイプのシステムで Marid を使用するには、Opsgenie で操作したりスクリプトからインターネットに接続したりするために、次の Marid 外部プロキシ設定を構成する必要があります。

外部プロキシ設定

アラートアクションの実行

Marid は Opsgenie ユーザー アクションをサブスクライブして、ユーザー アクションごとにスクリプトを実行できます。Opsgenie への接続は Marid によって開始されます。したがって、Marid サーバーは Web からアクセス可能である必要はありません。この方法は、Marid が HTTPS 経由で Opsgenie と通信して内部から接続を開始するため、ファイアウォールの変更やポートの開放などは不要です。

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

例:

• Marid が次の設定で開始された場合は、actions.restart.script=script1.groovy: restart アクションの実行ごとに、<MARID_HOME>/scripts/script1.groovy が実行されます。

• actions.Create.script=scriptCreate.groovy: Opsgenieで作成された新しいアラートごとに <MARID_HOME>/scripts/scriptCreate.groovy が実行されます。

• actions.Acknowledge.script=scriptAcknowledge.groovy: Opsgenie でアラートが承認されるたびに <MARID_HOME>/scripts/scriptAcknowledge.groovy が実行されます。

• actions.AddNote.script=scriptAddNote.groovy: Opsgenie のアラートにノートが追加されるたびに、<MARID_HOME>/scripts/scriptAddNote.groovy が実行されます。

• actions.Close.script=scriptClose.groovy: Opsgenie アラートがクローズされるたびに、<MARID_HOME>/scripts/scriptClose.groovy が実行されます。

• actions.TakeOwnership.script=scriptTakeOwnership.groovy: ユーザーが Opsgenie でアラートの所有権を持つたびに、<MARID_HOME>/scripts/scriptTakeOwnership.groovy が実行されます。

• actions.AssignOwnership.script=scriptAssignOwnership.groovy: Opsgenie で誰かがユーザーにアラートを割り当てるたびに、<MARID_HOME>/scripts/scriptAssignOwnership.groovy が実行されます。

• actions.AddRecipient.script=scriptAddRecipient.groovy: ユーザーがアラートに受信者を追加するたびに、<MARID_HOME>/scripts/scriptAddRecipient.groovy が実行されます。

• actions.AddTeam.script=scriptAddTeam.groovy: ユーザーがアラートにチームを追加するたびに、<MARID_HOME>/scripts/scriptAddTeam.groovy が実行されます。

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

これらのアクション スクリプトで使用するために、Opsgenie は有用なアラート関連データを Marid に送信します。これらのパラメーターは、<MARID_HOME>/scripts ディレクトリの下に置いた任意のスクリプトですぐに使用できます。これらのパラメーターは次のとおりです。