Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
XMPP/Jabber と統合する
Opsgenie から Jira Service Management にオペレーションを移行したお客様の場合、この統合の新しいインスタンスを Jira Service Management で追加することはできません。 編集できるのは、元々 Opsgenie から移行された統合だけです。
Jira Service Management が XMPP/Jabber ユーザーにもたらすメリット
Jira Service Management XMPP/Jabber 統合プラグインでは、Jira Service Management の全機能を利用して XMPP/Jabber とのチャット統合を実現しています。この統合では、 Jira Service Management の xmpp 専用実行可能ファイルと OEC ユーティリティを活用することで Jira Service Management のアラートとアラート アクションが XMPP/Jabber のルームに送られるようにしています。
統合の機能性
Jira Service Management でアラートが作成されると、Jira Service Management でアラートが作成されたという情報が XMPP/Jabber のルームに送られます。
ユーザーが Jira Service Management アプリを使用しているモバイル デバイスからアラートを承認すると、この情報が XMPP/Jabber のルームに送信されます。
ユーザーが Jira Service Management でアラートにコメントを追加すると、メモ追加情報も送信されます。
OEC では Jira Service Management でアラート アクションをサブスクライブし、これらのアクションを XMPP/Jabber のルームに反映することで Jira Service Management アラートについて通知されるようにします。
Jira Service Management で XMPP/Jabber 統合を編集する
Jira Service Management で XMPP/Jabber 統合を編集するには、次の手順を実行します。
チームの運用ページに移動します。
左側のナビゲーション パネルで [統合] を選択します。
お使いの XMPP/Jabber 統合を検索します。
必要に応じて統合の設定とルールを編集します。
次のセクションの説明は定期的に更新されていません。 ご不明な点がございましたら、当社までお問い合わせください。
インストール
以下の手順では、Jira Service Management XMPP/Jabber 統合プラグインを使用して Jira Service Management と XMPP/Jabber を統合する方法について説明します。ご使用の Linux ディストリビューションと XMPP/Jabber の設定によっては、これらの指示に若干の変更が必要になる場合があることにご注意ください。
前提条件
提供されるパッケージは、以下のシステムをサポートしています。
Red Hat ベースの Linux ディストリビューション
Debian ベースの Linux ディストリビューション
Windows
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 をインストールします
Jira Service Management で 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 |
この内容はお役に立ちましたか?