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 の最新バージョンをダウンロードする
To download the latest version of XMPP/Jabber package, please use readme file of oec-scripts repository.
Red Hat ベースのディストリビューションの場合
次のコマンドを実行します。
rpm -i opsgenie-xmpp-<your_version>.rpm
During upgrades, rpm package does not overwrite your existing configurations. It saves the new default configuration file as opsgenie-integration.conf.rpmnew. Find more information about rpm upgrade config file handling from here.
バージョン 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 ファイルを解凍します
Install OEC by following steps in OEC installation page
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 で実行する必要があるスクリプトも含まれています。
In order to learn more about how to run OEC you can refer to the Running OEC documentation.
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 |
この内容はお役に立ちましたか?