Opsgenie を Cherwell と統合する

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

Opsgenie は Cherwell との強力な双方向のインテグレーションを提供します。インテグレーションを使用して Cherwell インシデントを Opsgenie の API に詳細情報とともに送信します。Opsgenie は Cherwell のアラートのディスパッチャーとして機能して、オンコールスケジュールに基づいて通知する適切な担当者を決定します。メール、テキストメッセージ (SMS)、電話、iOS、Android のプッシュ通知によって通知し、アラートが確認されるかクローズされるまでアラートをエスカレートします。

統合の機能性

Cherwell でインシデントのステータスが [新規] または [再オープン] の場合は、統合によって Opsgenie でアラートが自動で作成されます。
Cherwell でインシデントのステータスが [進行中] の場合は、Opsgenie で作成されたアラートは自動で承認されます。
Cherwell でインシデントのステータスが [解決済み] または [クローズ] の場合、Opsgenie で作成されたアラートは自動的にクローズされます。
[アラート更新を Cherwell に送信する] が有効化されている場合は、選択したアクションが Cherwell アラートの Opsgenie で実行されると、インシデントアクションが Cherwell で実行されます。
[OpsGenie アラート用の Cherwell インシデントの作成] が有効な場合は、Cherwell 以外のソースからのアラートに対して Opsgenie で選択したアクションが実行されると、インシデントアクションが Cherwell で実行されます。

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

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

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

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

OEC は Opsgenie から Cherwell にデータを送信するために必要です。

現在、Cherwell バージョン 10.X をサポートしています。Cherwell の API の変更によって、以前のバージョンはサポート対象外です。

Cherwell での設定

統合のブループリントである opsgenie.bp をダウンロードします。
Cherwell Service Management Administrator で opsgenie.bp を開いて、ブループリントを公開します。

3. Stored Values Manager (格納される値のマネージャー) を開いて、グローバル/統合にある [OpsGenie API キー] を見つけます。コピーした API キーを値として貼り付けます。保存値の更新については、こちらをご参照ください。

すべて完了! Cherwell インシデントを Opsgenie に転送して、Opsgenie のアラート機能をフル活用してください。

Opsgenie の EU サービスリージョンでの Cherwell インテグレーションの使用

Opsgenie の専用ヨーロッパサービスリージョンを使用する場合は、OpsGenie Web サービスで若干の変更が必要です。

Cherwell Service Management Administrator で [ブラウザとモバイル設定] を開きます。
[Web サービスマネージャー] をクリックします。
リストで [OpsGenie Webhook] を探して右クリックし、[編集] を選択して変更します。
URL フィールドを https://api.opsgenie.com/v1/json/cherwell から https://api.eu.opsgenie.com/v1/json/cherwell に変更します

OEC インテグレーションに Cherwell で必要な変更

OEC を介した統合を設定する前に、快適なエクスペリエンスをご利用いただくために以下のステップに従ってください。

REST API クライアント ID の取得

Cherwell Service Management Administrator で [セキュリティ] を開きます。
[REST API クライアント設定の編集] をクリックします。
プラス記号をクリックして、新しいエントリを作成します。
REST API クライアントに OpsGenie という名前を付けて、クライアント ID をコピーします。
フロッピーディスクのアイコンをクリックして保存します。

OEC 統合のユーザーを作成する
Cherwell で認証するための OEC 統合用の Cherwell ユーザーを作成します。

Cherwell Service Management Administrator で [セキュリティ] を開きます。
[ユーザーの編集] をクリックします。
プラス記号をクリックして、新しいエントリを作成します。
このユーザーの Cherwell 認証資格情報を指定します。
ユーザーの [氏名] を OpsGenie に設定します、このフィールドでは大文字と小文字が区別されます。
画像はオプションです。
フロッピーディスクのアイコンをクリックして保存します。

OEC 統合の顧客を作成する
Opsgenie が作成したインシデントのリクエスト元として使用される OEC 統合用の Cherwell Customer を作成します。

Cherwell サービス管理 で、[新規] > [新規顧客 - 社内] の順にクリックします。
顧客の [フルネーム] を OpsGenie に設定します。このフィールドでは、大文字と小文字が区別されます。
画像はオプションです。
フロッピーディスクのアイコンをクリックして保存します。

OEC を介した統合

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

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

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

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

インストール

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

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

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

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

Windows の場合

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

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

テキスト

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

OEC の実行方法について詳しくは、OEC の実行のドキュメントを参照してください。

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

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

OEC 設定

Cherwell でアクションを実行できるようにするために、OEC はパス /home/opsgenie/oec/conf/config.json (Linux) または %OEC_HOME%\conf\config.json (Windows) にある設定ファイルから設定パラメーターを取得します。

設定パラメーター

apiKey — 上記で作成した Cherwell インテグレーションから API キーをコピーします。
apiUrl – Cherwell API の URL。例: http://localhost/CherwellAPI/。
username — Cherwell へのサインインに使用したユーザー名。
password — Cherwell へのサインインに使用したパスワード。
clientID —「OEC インテグレーションに Cherwell で必要な変更」の章で取得した clientId。

ダウンロードしたパッケージには、パス /usr/local/bin/OpsgenieEdgeConnector (Linux) または %OEC_HOME%\OpsgenieEdgeConnector64.exe (Windows) にある OEC ユーティリティや、OEC によって実行される必要のある /home/opsgenie/oec/scripts (Linux) または %OEC_HOME%\scripts\actionExecutor.py (Windows) にあるスクリプトも含まれます。OEC の設定が完了したら実行する必要があります。OEC の実行方法に関する詳細については、OEC の実行のドキュメントをご参照ください。
すべてが設定された後、アクションマッピングに従ってインシデントが Cherwell で作成/更新されます。

Cherwell から Opsgenieに送信されるペイロードの例

JSON

{
    "incident" : {
       "callSource" : "Walk in",
       "status" : "Reopened",
       "shortDescription" : "Printer Issue",
       "category" : "Network",
       "cause" : "Hardware Malfunction",
       "id" : "102256",
       "description" : "Having trouble with the network printer",
       "type" : "Incident",
       "priority" : "3",
       "service" : "Printing",
       "subcategory" : "Submit Incident",
       "isMajorIncident" : "FALSE",
       "isRecurringIncident" : "FALSE"
    }
}

このペイロードは Opsgenie によって次のように解析されます。

JSON

[
    "call_source" : "Walk in",
    "status" : "Reopened",
    "short_description" : "Printer Issue",
    "category" : "Network",
    "cause" : "Hardware Malfunction",
    "incident_id" : "102256",
    "description" : "Having trouble with the network printer",
    "type" : "Incident",
    "priority" : "3",
    "service" : "Printing",
    "subcategory" : "Submit Incident",
    "is_major_incident" : false,
    "is_recurring_incident" : false
]

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問