Opsgenie を Redmine と統合する

Opsgenie の Redmine 統合によって、Opsgenie アラート アクティビティを課題として Redmine に転送します。アラートが作成されると、Opsgenie は Redmine プロジェクトで新しい課題を作成して、アラートにメモが追加されると課題にメモを追加して、アラートが誰かによって承認されると課題の状態を変更します。

インストール

以下の手順では、Opsgenie の Redmine 統合プラグインによって Opsgenie と Redmine を統合する方法を説明します。ディストリビューションによっては、これらの指示の変更が必要になる場合があります。

Opsgenie Redmine プラグインをダウンロードする

Windows の場合

1. Opsgenie Redmine (zip) をダウンロードする

2. OEC パッケージを含む opsgenie integration の zip ファイルをディレクトリ内に解凍します (C:\opsgenie-integration は優先パスです)。

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

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

1. Opsgenie Redmine (Linux RPM) をダウンロードする

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

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

1. Opsgenie Redmine (Linux DEB) をダウンロードする

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

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

1. Opsgenie の OEC インテグレーション ページに移動します。

2. [インテグレーションを保存] をクリックします。インテグレーション用の「API キー」が生成されます。このキーは、Opsgenie で認証するために OEC によって使用されます。

プラグイン環境設定ファイル

OEC アプリケーション構成ファイルは、次の場所にあります。

• Windows の場合: <OEC_HOME>/../conf/opsgenie-integration.conf

• Linux の場合: /etc/opsgenie/conf/opsgenie-integration.conf

設定パラメーター

• apiKey – 上記で作成した OEC インテグレーションから API キーをコピーします。

• redmine.url – Redmine が実行されているホストへの URL。

• redmine.projectId – Redmine プロジェクトの ID。Opsgenie はこのプロジェクトの課題を作成します。

• redmine.apiKey – Redmine アカウント ページ (/my/account) にある API アクセス キー。Redmine の管理設定から "REST Web サービスを有効" にする必要があることにご注意ください。

• redmine.customFieldId – オプション。課題のアップデートのために Opsgenie によって必要とされます: メモの追加、課題の承認またはクローズ。これらの機能を活用するには、Redmine の管理設定で alert_id という名前のカスタム フィールドを作成します。構成ファイルで redmine.customFieldId のコメントを解除して、カスタム フィールドの ID に設定します。

• redmine.inProgressStatusId – オプション。Opsgenie は、Opsgenie でアラートが承認されたときに status_id を使用して課題のステータスを変更します。Redmine 管理設定で "課題のステータス" を作成して承認済みの状態を保持し、構成ファイル内でステータスの ID を redmine.inProgressStatusId に設定してください。

• redmine.closedStatusId – オプション。Opsgenie は、Opsgenie でアラートをクローズする際に status_id を使用して課題のステータスを変更します。Redmine 管理設定で "課題のステータス" を作成してクローズ状態を保持し、構成ファイル内でステータスの ID を redmine.closedStatusId に設定してください。