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 での設定
まず、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 実行可能ファイル (パス %OEC_HOME%\oecService64.exe) と OEC で実行する必要があるスクリプト (パス %OEC_HOME%\scripts\actionExecutor.py) も含まれています。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"
}
}
この内容はお役に立ちましたか?