Opsgenie を XMPP/Jabber と統合する
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 インテグレーション プラグインを使用して、Opsgenie と XMPP/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 の場合
Opsgenie インテグレーションの zip ファイルを解凍します
OEC のインストール ページの手順に従って、OEC をインストールします
Opsgenie で XMPP/Jabber インテグレーションを追加する
この統合は、Opsgenie の Standard プランと Enterprise プラン、および Jira Service Management の Premium プランと Enterprise プランでのみ利用できます。
統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。
[設定] > [統合] の順に移動します。XMPP/Jabber を検索して [追加] を選択します。
API キーをコピーします。
[Save Integration (統合の保存)] を選択します。
Opsgenie から XMPP/Jabber へのインテグレーションを設定する
Opsgenie の OEC と XMPP スクリプトを使用して、XMPP/Jabber ルームにアラートアクションを送信します。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを XMPP 上で実行できます。
XMPP インテグレーション パッケージを使用するには、以下のセクションの手順を最後まで実行します。
ダウンロードしたパッケージには、OEC ユーティリティと OEC で実行する必要があるスクリプトも含まれています。
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 |
この内容はお役に立ちましたか?