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 のアクションが実行されます。
[Create BMC Remedy Incidents/Problems for Opsgenie Alerts (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 での設定

First download the Opsgenie BMC Remedy Integration Package.
.zip パッケージを展開して、展開された opsgenie-bmcremedy という名前のフォルダーをパス C:\opsgenie に移動します。

Paste the API Key copied from the previous chapter Add BMC Remedy Integration in Opsgenie into the apiKey field in the configuration file located at C:\opsgenie\opsgenie-bmcremedy\conf\opsgenie-integration.conf
管理者権限で BMC Developer Studio を開きます。

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

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

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

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

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

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

In filter configuration page expand the menus If Actions and Run Process respectively. If you want to override the api key you set in the opsgenie-integration.conf file add a flag named opsgenie-integration-api-key as shown in the below image with the key you copied from the previous chapter Add BMC Remedy Integration in Opsgenie then Press CTRL + S for saving your filter.

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

OEC を介した統合

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

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

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

To download the latest version of BMC Remedy package, please use readme file of oec-scripts repository.

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 サーバーのサーバー名。

The package that you downloaded also includes OEC executable which is located at path %OEC_HOME%\oecService64.exe and the script that is needed to be run by OEC which is located at path %OEC_HOME%\scripts\actionExecutor.py . After the configuration of OEC is done, you need to run it. In order to learn more about how to run OEC, you can refer to the Running OEC documentation.

すべてが設定されると、アクションマッピングに従って 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"
    }
}

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

正確ではなかった明確ではなかった関係なかった

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

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

コミュニティに質問