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

Opsgenie を XMPP/Jabber と統合する

XMPP のロゴ

Opsgenie が XMPP/Jabber ユーザーに提供するもの

Opsgenie XMPP/Jabber インテグレーション プラグインは、Opsgenie の全機能を利用し、XMPP/Jabber とのチャット インテグレーションを提供します。このインテグレーションでは、Opsgenie の xmpp 固有の実行可能ファイルと OEC ユーティリティを活用して、Opsgenie のアラートとアラート アクションが XMPP/Jabber ルームに送信されるようにします。

統合の機能性

  • Opsgenie でアラートが作成されると、Opsgenie でアラートが作成されたという情報が XMPP/Jabber ルームに送信されます。

  • ユーザーが Opsgenie アプリを使用しているモバイルデバイスからのアラートを承認すると、この情報が XMPP/Jabber ルームに送信されます。

  • ユーザーが Opsgenie でアラートにコメントを追加すると、追加メモ情報も送信されます。

OEC は Opsgenie のアラート アクションをサブスクライブして、これらのアクションを XMPP/Jabber ルームに反映させます。これによって、Opsgenie アラートの通知を受け取ります。

インストール

以下の手順では、Opsgenie XMPP/Jabber インテグレーション プラグインを使用して、OpsgenieXMPP/Jabber を統合する方法を説明します。ご使用の Linux ディストリビューションと XMPP/Jabber の設定によっては、これらの指示に若干の変更が必要になる場合があることにご注意ください。

前提条件

提供されるパッケージは、以下のシステムをサポートしています。

  • Red Hat ベースの Linux ディストリビューション

  • Debian ベースの Linux ディストリビューション

  • Windows

Opsgenie XMPP/Jabber プラグインをダウンロードする

OEC の最新バージョンをダウンロードする

XMPP/Jabber パッケージの最新バージョンをダウンロードするには、oec-scripts リポジトリの readme ファイルを使用してください。

Red Hat ベースのディストリビューションの場合

  • 次のコマンドを実行します。 rpm -i opsgenie-xmpp-<your_version>.rpm

アップグレード時、rpm パッケージは既存の設定を上書きしません。これによって、新しい既定の設定ファイルが opsgenie-integration.conf.rpmnew として保存されます。rpm アップグレード設定ファイルの処理の詳細については、こちらをご参照ください。

バージョン 201X-XX-XX から 2.X.X に更新するには、--force パラメーターを追加します。

例: 

rpm -U --force opsgenie-integration-<your_version>.rpm

更新する前に、設定ファイルをバックアップすることをお勧めします。

rpm パッケージのインストール中にパッケージが廃止されたというエラーが表示された場合は、代わりに "rpm -i opsgenie-xmpp-<your_version>.rpm --nodeps" を使用する必要があります。

"is already installed (インストール済み)" エラーが表示された場合は、代わりに "rpm -i opsgenie-xmpp-<your_version>.rpm --force" を使用する必要があります。

Debian ベースのディストリビューションの場合

  • 次のコマンドを実行します。 dpkg -i opsgenie-xmpp-<your_version>.deb

Windows の場合

  1. Opsgenie インテグレーションの zip ファイルを解凍します

  2. OEC のインストールページの手順に従って、OEC をインストールします

Opsgenie で XMPP/Jabber インテグレーションを追加する

この統合は、Opsgenie の Standard プランと Enterprise プラン、および Jira Service Management の Premium プランと Enterprise プランでのみ利用できます。

統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。

  1. [設定] > [統合] の順に移動します。XMPP/Jabber を検索して [追加] を選択します。

  2. API キーをコピーします。

  3. [Save Integration (統合の保存)] を選択します。

Opsgenie から XMPP/Jabber へのインテグレーションを設定する

Opsgenie の OEC と XMPP スクリプトを使用して、XMPP/Jabber ルームにアラートアクションを送信します。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを XMPP 上で実行できます。

XMPP インテグレーション パッケージを使用するには、以下のセクションの手順を最後まで実行します。

ダウンロードしたパッケージには、OEC ユーティリティと OEC で実行する必要があるスクリプトも含まれています。

XMPP でアクションを実行できるようにするには、OEC で設定ファイルから設定パラメーターを取得します。設定ファイルは、/home/opsgenie/oec/conf/config.json の下にあります。

この機能を使用するには、[Send Alert Actions To XMPP (アラート アクションを XMPP に送信する)] チェックボックスを、Opsgenie XMPP/Jabber インテグレーションで有効にする必要があります。

設定パラメーター

 

場所

API キー

XMPP/Jabber のインテグレーション API キー。XMPP/Jabber インテグレーション ページから API キーをコピーし、conf ファイルの apiKey フィールドに貼り付けます。

/home/opsgenie/oec/conf/config.json

hostUrl

使用している XMPP/Jabber サーバーのサービス名。この hostUrl は、XMPP/Jabber サーバーとの接続を作成するために使用されます。

/home/opsgenie/oec/conf/config.json

ユーザ名

XMPP/Jabber サーバーへのログイン時に使用されるユーザー名。

/home/opsgenie/oec/conf/config.json

パスワード

XMPP/Jabber サーバーへのログイン時に使用されるパスワード。

/home/opsgenie/oec/conf/config.json

room

アラートアクションが送信されるルーム名。

/home/opsgenie/oec/conf/config.json



その他のヘルプ