Opsgenie を BMC Remedy と統合する

Opsgenie が BMC Remedy ユーザーに提供するもの

Opsgenie は BMC Remedy との強力な双方向の統合を提供します。BMC Remedy で新しいインシデントが作成されると、インシデントに関する詳しい情報を含む、対応する Opsgenie アラートが自動で作成されます。Opsgenie は、オンコールローテーション、スケジューリング機能、アラートエスカレーションを含む詳細な通知を提供して、BMC Remedy の顧客に最適なインシデント管理を保証します。

統合の機能性

BMC Remedy でインシデントが作成されると、Opsgenie にアラートが作成されます。
インシデントが BMC Remedy でクローズされると、関連するアラートが Opsgenie でも自動的にクローズされます。また、BMC Remedy でインシデントをクローズするときに何らかの解決処理が行われた場合、その解決処理はメモとして Opsgenie アラートに追加されます。
[Send Alert Updates Back to BMC Remedy (アラート更新に戻る BMC Remedy に送信)] が有効になっている場合は、BMC Remedy によって作成されたアラートに対して Opsgenie で選択したアクションが実行されると、BMC Remedy で BMC Remedy のアクションが実行されます。
[Opsgenie アラートの BMC Remedy インシデント/問題の作成] が有効な場合は、ソースが BMC Remedy インテグレーション以外のアラートに対して選択したアクションが Opsgenie で実行されると、BMC Remedy のアクションが BMC Remedy で実行されます。

Opsgenie で BMC Remedy インテグレーションを追加する

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

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

[設定] > [統合] の順に移動します。BMC Remedy を検索して [追加] を選択します。
[応答者] フィールドを使用して、BMC Remedy アラートの通知先を指定します。入力し始めるとオートコンプリートの候補が表示されます。
API キーをコピーします。BMC Remedy の設定時にこれを使用します。
[Save Integration (統合の保存)] を選択します。

BMC Remedy での設定

まず、Opsgenie BMC Remedy インテグレーションパッケージをダウンロードします。
.zip パッケージを展開して、展開された opsgenie-bmcremedy という名前のフォルダーをパス C:\opsgenie に移動します。

前の章「Opsgenie で BMC Remedy インテグレーションを追加する」からコピーした API キーを、C:\opsgenie\opsgenie-bmcremedy\conf\opsgenie-integration.conf にある設定ファイルの apiKey フィールドに貼り付けます。
管理者権限で BMC Developer Studio を開きます。

BMC Developer Studio で [ファイル] メニューを開いて、[インポート] をクリックします。[Object Definitions (オブジェクトの定義)] を選択して、[次へ] をクリックします。

この操作を続行するには [AR システムサーバー] を選択します。

OpsgenieFilter.def (BMC Remedy インテグレーションパッケージに含まれている) をインポートファイルとして選択して、[次へ] をクリックします。

[オブジェクトの選択] ウィンドウで、[HPD:Help Desk Opsgenie Integration] という名前のフィルターが表示されていることを確認して [完了] をクリックします。

AR システムサーバーとオブジェクト アイテムをそれぞれ展開して、[フィルター] をクリックします。

フィルタータブで HPD:Help Desk Opsgenie Integration という名前のフィルターを選択します。簡単に見つけるために、下の画像のようなフィルタリングオプションを使用できます。

フィルター設定ページで、[If Actions (アクションの場合)] と [Run Process (プロセスを実行)] メニューをそれぞれ展開します。opsgenie-integration.conf ファイルで設定した API キーをオーバーライドする場合は、前の章 (Opsgenie における BMC Remedy インテグレーションの追加) からコピーしたキーと以下の画像に示すような opsgenie-integration-api-key という名前のフラグを追加し、Ctrl + S キーを押してフィルターを保存します。

これで、BMC Remedy インシデントに対して Opsgenie の膨大なアラートおよび通知管理機能を使用するように設定されました。BMC Remedy でインシデントを初めて作成すると、以下の画像のようなログファイルが作成されます。このログファイルは、各操作を記録してトラブルシューティングに使用できます。

OEC を介した統合

または、Opsgenie の OEC と BMC Remedy スクリプトを使用して、BMC Remedy でアクションを実行します。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更して、カスタマイズしたアクションを BMC Remedy v11 上で実行できます。

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

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

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

OEC パッケージをインストールする

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

便宜上、この解凍パスを %OEC_HOME% として参照できます。解凍場所の値を実行予定 OEC_HOME というシステム環境変数を作成して昇格した Powershell セッションを開き、次のコマンドを入力します。

テキスト

[Environment]::SetEnvironmentVariable("OEC_HOME", <Path you extracted OEC package to>, 'Machine')

OEC 用の BMC Remedy インテグレーションの設定

BMCRemedy インテグレーションに OEC ユーティリティを使用するには、統合設定で [OEC 経由の送信を有効化] を使用します。
BMC Remedy に関するその他の設定は、統合設定ページまたは OEC 設定ファイルを使用して行えます。統合ページの設定は設定ファイルより優先されます。

OEC 設定

BMC Remedy でアクションを実行できるように、OEC はパス %OEC_HOME%\conf\config.json にある統合ファイルから統合パラメーターを取得します。

設定パラメーター

apiKey — 上記で作成した BMC Remedy インテグレーションから API キーをコピーします。
username — BMC Remedy ARSYS のユーザー名。
password — BMC Remedy ARSYS のパスワード。
midtierServerUrl — BMC Remedy の中間ティアサーバーの URL。
serverName — BMC Remedy サーバーのサーバー名。

ダウンロードしたパッケージには、パス%OEC_HOME% \ oecService64.exe にある OEC 実行可能ファイル、およびパス%OEC_HOME% \ scripts \ actionExecutor.py にある OEC で実行する必要があるスクリプトも含まれています。OEC の設定が完了したら、OEC を実行する必要があります。OEC の実行方法について詳しくは、OEC の実行のドキュメントを参照してください。

すべてが設定されると、アクションマッピングに従って Opsgenie アクティビティが [Work Detail (作業詳細)] として追加されます。

OEC に送信されるパラメーターの例

作業情報追加アクションのペイロード

JSON

{
  {
   "type":"bmcRemedy",
   "alertId":"5494d725-3c00-472c-9f60-3fd49352b457",
   "customerId":"aeb4417d-10b8-4826-9aec-18950b617d4c",
   "action":"Acknowledge",
   "mappedActionV2":{
      "name":"addWorkInfo",
      "extraField":""
   },
   "integrationId":"dda61d1d-98bc-4153-93eb-752d6087395d",
   "integrationName":"BMCRemedy",
   "integrationType":"BMCRemedy",
   "sendViaOEC":true,
   "alertFlowContext":{
      "requestId":"0ed9d43d-74b6-4996-886e-d38b07930772",
      "traceId":"0ed9d43d-74b6-4996-886e-d38b07930772",
      "content":{
         "alertId":"5494d725-3c00-472c-9f60-3fd49352b457"
      }
   },
   "username":"Bob",
   "password":"123",
   "midtierServerUrl":"http://localhost:8080",
   "serverName":"localhost",
   "workInfoDetails":"[Opsgenie]Bener acknowledged alert: \"[BMCRemedy] New incident: \"Email Service is Down\"\" https://opsg.in/i/14",
   "incidentNumber":"INC000000000673"
}
}

インシデントアクションを作成するためのペイロード

JSON

{
  {
   "type":"bmcRemedy",
   "alertId":"5494d725-3c00-472c-9f60-3fd49352b458",
   "customerId":"aeb4417d-10b8-4826-9aec-18950b617d4d",
   "action":"Create",
   "mappedActionV2":{
      "name":"createIncident",
      "extraField":""
   },
   "integrationId":"dda61d1d-98bc-4153-93eb-752d6087395d",
   "integrationName":"BMCRemedy",
   "integrationType":"BMCRemedy",
   "sendViaOEC":true,
   "alertFlowContext":{
      "requestId":"0ed9d43d-74b6-4996-886e-d38b07930772",
      "traceId":"0ed9d43d-74b6-4996-886e-d38b07930772",
      "content":{
         "alertId":"5494d725-3c00-472c-9f60-3fd49352b458"
      }
   },
   "username":"Bob",
   "password":"123",
   "midtierServerUrl":"http://localhost:8080",
   "serverName":"localhost",
   "message": "Alert is created",
   "priority": "P1",
   "teamName":"Service Desk",
   "alias":"BMCRemedyForce Id-ekU1N000000pZXrUAM1",
    }
}

インシデントアクションを作成するためのペイロード

JSON

{
  {
   "type":"bmcRemedy",
   "alertId":"5494d725-3c00-472c-9f60-3fd49352b458",
   "customerId":"aeb4417d-10b8-4826-9aec-18950b617d4d",
   "action":"Close",
   "mappedActionV2":{
      "name":"closeIncident",
      "extraField":""
   },
   "integrationId":"dda61d1d-98bc-4153-93eb-752d6087395d",
   "integrationName":"BMCRemedy",
   "integrationType":"BMCRemedy",
   "sendViaOEC":true,
   "alertFlowContext":{
      "requestId":"0ed9d43d-74b6-4996-886e-d38b07930772",
      "traceId":"0ed9d43d-74b6-4996-886e-d38b07930772",
      "content":{
         "alertId":"5494d725-3c00-472c-9f60-3fd49352b458"
      }
   },
   "username":"Bob",
   "password":"123",
   "midtierServerUrl":"http://localhost:8080",
   "serverName":"localhost",
   "message": "Alert is created",
   "priority": "P1",
   "teamName":"Service Desk",
   "alias":"BMCRemedyForce Id-ekU1N000000pZXrUAM1",
   "incidentNumber":"INC000000000673",
   "resolution":"[Opsgenie]Emel closed alert: \"[BMCRemedyForce] Incident:                  \"Email Service is Down\"\" https://opsg.in/i/14"
    }
}

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問