• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

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

Marid は廃止予定で、2022 年 11 月 21 日に完全に廃止されます。詳細はコミュニティの投稿をご覧ください。

アトラシアンの拡張性プラットフォームをこれまでご利用になられたことがない場合は「拡張性プラットフォームとしての Opsgenie Edge Connector」をご参照のうえ、Opsgenie アカウントで実行する方法をご確認ください。

Marid をご利用で Opsgenie Edge Connector に移行する場合は「Opsgenie Edge Connector に移行する必要がある理由」をご参照ください。

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

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

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

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

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

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

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

Marid をインストールする

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

Marid 設定

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

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

設定

説明

(必須)

既定値

API キー

「opsgenie」スクリプト変数を介して実行される Opsgenie API リクエストを認証して、Opsgenie サービスから Marid 設定を取得するために使用される API キー。
Opsgenie で Marid インテグレーションを保存した際に取得した API キーをここに貼り付けます。

はい

-

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

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

外部プロキシ設定

設定

説明

(必須)

既定値

http.proxy.enabled

外部プロキシ設定を有効/無効化します。true または false の場合があります

はい

false

http.proxy.host

プロキシ ホスト

はい

-

http.proxy.port

プロキシ ポート

はい

-

http.proxy.username

プロキシ認証ユーザー名

いいえ

-

http.proxy.password

プロキシ認証パスワード

いいえ

-

http.proxy.procol

プロキシ接続プロトコル。プロキシ サーバーによって、http または https になる場合があります。

いいえ

http

http.proxy.authMethod

プロキシ認証メカニズム。BASIC または NT のいずれかである必要があります。

いいえ

NT

ファイアウォール設定

システムにファイアウォールがある場合は、Marid が使用する一部のアドレスをアウトバウンド ルールに対して「許可リストに登録済み」にする必要があります。インバウンド ルールを変更する必要はありません。つまり、ファイアウォールへのパス スルーとして以下を追加することで、Opsgenie サブドメインの依存関係をアウトバウンド ルールに追加する必要があります。

  • *.opsgenie.com

  • pubsub.pubnub.com

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

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 ファイルで設定できます。

Linux ディストリビューションの場合、<MARID_HOME>/var/opsgenie/marid です。

例:

  • 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 が実行されます。

設定

説明

(必須)

既定値

actions.<action_name>.script=<script_name>

スクリプト マッピング構成に対するアラート アクション。設定したアラート アクションの実行ごとに指定する場合、<MARID_HOME>/scripts ディレクトリにある groovy または ruby スクリプト ファイルが呼び出されます。

いいえ

-

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

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

パラメーター

説明

警報

アクションが実行されるアラート プロパティにアクセスするための変数。alertId、ユーザー名、およびこのようなプロパティには、この変数を使用してアクセスできます。Opsgenie によって提供されるアラート データのサンプルについては、このドキュメントをご参照ください。

操作

実行したアクションの名前

ソース

実行されたアクションのソースにアクセスする変数。これは、次の属性を持つマップです:
タイプ: アクション実行ソース。次のいずれかを使用できます: ウェブapiアラート メールチャット統合音声SMS
: ユーザーによって Opsgenie API に渡されたソース プロパティ。ソースが指定されていない場合は、空の文字列になります。

サンプルソース: {"type":"api", "name":"source1"}

conf

設定ファイルのプロパティへの参照。すべての設定プロパティには、このパラメーターを介してアクセスできます。

logger

ロギング ユーティリティ。すべてのスクリプト ログは <LOGS_DIR>/script.log ファイルに書き込まれます。

Opsgenie

Opsgenie サーバー上で操作を実行するための変数。使用可能な操作のリストについては、Marid のスクリプト プロキシ ドキュメントをご参照ください。

 

その他のヘルプ