Opsgenie を VMware vCenter Server Appliance と統合する

Opsgenie が VMware vCenter Server Virtual Appliance ユーザーに提供するもの

Opsgenie の VMware vCenter Server Virtual Appliance インテグレーションを使用して、VMware vCenter Server Virtual Appliance インシデントを Opsgenie に転送します。Opsgenie はこれらのインシデントのディスパッチャーとして機能して、オンコールスケジュールに基づいて通知する適切な担当者を決定します。メール、テキストメッセージ (SMS)、電話、iPhone、Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。

統合の機能性

VMware vCenter Server Virtual Appliance でアラームが作成されると、Opsgenie でアラートが作成されます。

Opsgenie で VMware vCenter Server Virtual Appliance インテグレーションを追加する

Opsgenie の Free プランまたは Essentials プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合は、チームダッシュボードからのみこの統合を追加できます。このプランでは、[設定] の [統合] ページが利用できません。

[チーム] に移動して自分のチームを選択します。
左側のナビゲーションで [統合] を選択し、[統合を追加] を選択します。

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

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

VMware vCenter Server Virtual Appliance での設定

Opsgenie VMware vCenter Server Virtual Appliance RPM パッケージをダウンロードします。
sudo rpm -i opsgenie-vcsa-<your_version>.rpm を実行します
インストールが完了すると、プラグインの設定ファイル (opsgenie-integration.conf) が /etc/opsgenie/conf に配置されます。
このファイルを編集し、「apiKey」に VCSA 統合の API キーを置いて、「“<your_opsgenie_integration_api_key>“」を置き換えます。
設定ファイルを保存します。
vSphere Client を実行します。
vSphere Client で、[Actions (アクション)] をクリックします。
[Alarms (アラーム)]、[New Alarm (新しいアラーム)] の順に選択します。
アラームの設定時に、アクションを「実行コマンド」として追加し、[Configuration (構成)] の部分にお使いの vcsa2opsgenie パスを入力します。

10. アラームを保存します。

VMware vCenter Server Virtual Appliance での Opsgenie プラグインの設定

プラグインは golang-executable ファイル (vcsa2opsgenie としてプラグインに含まれる) を使用して、Opsgenie でアラートを作成します。イベント時にこのファイルを実行して Opsgenie でアラートを作成するように、VMware vCenter Server Virtual Appliance を構成する必要があります。

apiKey の設定は必須です。その他の設定パラメーター既定値に設定され、ほとんどの VMware vCenter Server Virtual Appliance 実装で動作しますが、変更が必要な場合もあります。

設定パラメーター

apiKey - 上記で作成した VMware vCenter Server Virtual Appliance 統合から API キーをコピーします。vcsa2opsgenie は、このキーによって Opsgenie への認証を行います。API キーは、アラートの処理に使用する必要がある適切な統合構成を識別するためにも用いられます。

teams - teams フィールドは、VMware vCenter Server Virtual Appliance アラートの通知先のチームを指定するために使用します。このフィールドで設定するチームが既定値として使用されます。Opsgenie VMware vCenter Server Virtual Appliance 統合の [詳細設定] ページで、異なるアラートを異なるチームにルーティングするように変更できます。

tags - tags フィールドは、Opsgenie で作成されたアラートのタグを指定するために使用します。

logPath - ログファイルの完全なパスを指定します (既定値は /var/log/vcsa2opsgenie.log)。

vcsa2opsgenie.http.proxy.enabled - vcsa2opsgenie.http.proxy.enabled フィールドは、外部プロキシ設定を有効/無効にするためのフィールドです。既定値は false です。

vcsa2opsgenie.http.proxy.host - プロキシのホストです。

vcsa2opsgenie.http.proxy.port - プロキシのポート。

vcsa2opsgenie.http.proxy.scheme - プロキシ接続プロトコル。ご利用のプロキシサーバーによって http または https になります。既定値は http です。

vcsa2opsgenie.http.proxy.username - プロキシ認証ユーザー名。

vcsa2opsgenie.http.proxy.password - プロキシ認証パスワード。

opsgenie.api.url - 別のドメインから Opsgenie を使用している場合 (例: EU、サンドボックス)、この設定を更新します。

golang 実行可能ファイルを設定するには、次の 3 つの方法があります。

conf ファイルからの設定:

/etc/opsgenie/conf/opsgenie-integration.conf ファイルから設定します。conf ファイルから設定すると、スクリプトで行われた設定が上書きされます。

Golang フラグを使用して設定:

VMware vCenter Server Virtual Appliance で作成した通知のコマンドにフラグを入力して設定します。詳細については、「vCenter Server Virtual Appliance でのトリガーの設定」セクションを参照してください。apiKey には -apiKey フラグを使用します。

追加のカスタム引数を送信するには、フラグの後に、customArgName1 customArgValue1 customArgName2 customArgValue2 のように追加します。
{{_payload.customArgName}} を入力フィールドの必要な場所に追加することで、カスタム引数を解析します。
加工前のパラメーターの使用に関する詳細については、動的フィールドのドキュメントをご確認ください。

スクリプトからの設定:

apiKey vcsa2opsgenie.go スクリプトを設定します。このオプションを使用するには、スクリプトを再構築し、新しい実行可能ファイルを /etc/opsgenie/ ディレクトリに配置します。go スクリプトは /etc/opsgenie/ ディレクトリにあります。

VMware vCenter Server Virtual Appliance から送信されるペイロードのサンプル

アラートのペイロードを作成します。

JSON

{
    "VMWARE_ALARM_ALARMVALUE": "Event details",
    "VMWARE_ALARM_DECLARINGSUMMARY": "([Event alarm expression: Alarm created; Status ",
    "VMWARE_ALARM_EVENTDESCRIPTION": "Reconfigured testAlarm 'testAlarm' on Datacenter.  \n \nModified:  \n \ninfo.expression.expression: ((comparisons ",
    "VMWARE_ALARM_EVENT_DATACENTER": "Datacenter",
    "VMWARE_ALARM_EVENT_USERNAME": "VSPHERE.LOCAL\\Administrator",
    "VMWARE_ALARM_ID": "alarm-310",
    "VMWARE_ALARM_NAME": "OpsGenieAlarm",
    "VMWARE_ALARM_NEWSTATUS": "Green",
    "VMWARE_ALARM_OLDSTATUS": "Yellow",
    "VMWARE_ALARM_TARGET_ID": "datacenter-21",
    "VMWARE_ALARM_TARGET_NAME": "Datacenter",
    "VMWARE_ALARM_TRIGGERINGSUMMARY": "Event: Alarm reconfigured (1978)\nSummary: Reconfigured alarm 'testAlarm' on Datacenter.  \n \nModified:  \n \ninfo.expression.expression: ((comparisons "

}

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

JSON

{
    "alarmValue": "Event details",
    "declaringSummary": "([Event alarm expression: Alarm created; Status ",
    "eventDescription": "Reconfigured testAlarm 'testAlarm' on Datacenter.  \n \nModified:  \n \ninfo.expression.expression: ((comparisons ",
    "eventDatacemter": "Datacenter",
    "eventUsername": "VSPHERE.LOCAL\\Administrator",
    "alarmID": "alarm-310",
    "alarmName": "OpsgenieAlarm",
    "newStatus": "Green",
    "oldStatus": "Yellow",
    "targetID": "datacenter-21",
    "targetName": "Datacenter",
    "triggeringSummary": "Event: Alarm reconfigured (1978)\nSummary: Reconfigured alarm 'testAlarmæ' on Datacenter.  \n \nModified:  \n \ninfo.expression.expression: ((comparisons "

}

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

正確ではなかった

明確ではなかった

関係なかった

Opsgenie サポート