VMware vCenter Server Appliance と統合する

この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。

統合でできるようになること

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

統合による機能

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

統合をセットアップする

VMware vCenter Server Virtual Appliance は API ベースの統合です。次の手順でセットアップを行います。

Jira Service Management で VMware vCenter Server Virtual Appliance 統合を追加する
VMware vCenter Server Virtual Appliance で統合を設定する

VMware vCenter Server Virtual Appliance 統合を追加する

Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。

統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。

Jira Service Management で VMware vCenter Server Virtual Appliance 統合を追加するには、次の手順を実行してください。

チームの運用ページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「VMware vCenter Server Virtual Appliance」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開して、API キーをコピーします。
このキーは、後ほど VMware vCenter Server Virtual Appliance で統合を設定する際に使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

VMware vCenter Server Virtual Appliance で統合を設定する

VMware vCenter Server Virtual Appliance と Jira Service Management の統合を設定するには、次の手順を実行してください。

Jira Service Management 用の VMware vCenter Server Virtual Appliance 統合パッケージをダウンロードします。
コマンド sudo rpm -i jsm-vcenter-your_version.rpm. を実行します。
プラグイン (jsm-integration.conf) の設定ファイルは /etc/jsm/conf にあります。
jsm-integration.conf を開いて編集します。
さきほどコピーした VCSA 統合用の API キーを apiKey にコピーします。
設定ファイルを保存します。
vSphere クライアントを実行します。
vSphere vClient で [Actions (アクション)] を選択します。
[Alarms (アラーム)] > [New Alarm (新しいアラーム)] を選択します。
アラームを設定するときに、「Run Command」という名前のアクションを追加して [Configuration (設定)] に C:\jsm-integration\scripts\send2jsm.exe と入力します。
アラームを保存します。

VMware vCenter Server Virtual Appliance でプラグインを設定する

プラグインでは golang 実行可能ファイル (vcsa2jsm としてプラグインに含まれています) を使用して、Jira Service Management でアラートを作成します。イベント時にこのファイルを実行して Jira Service Management でアラートを作成するように、VMware vCenter Server Virtual Appliance を設定する必要があります。

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

設定パラメーター

apiKey - さきほど作成した VMware vCenter Server Virtual Appliance 統合から API キーをコピーします。vcsa2jsm では、このキーを使用して Jira Service Management への認証を行います。アラートの処理に使用される適切な統合設定の識別にも API キーが使用されます。

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

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

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

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

vcsa2jsm.http.proxy.host - プロキシのホスト。

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

vcsa2jsm.http.proxy.scheme - プロキシ接続プロトコル。プロキシサーバーに応じて http または https になる場合があります。既定値は http です。

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

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

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

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

conf ファイルから設定する

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

golang フラグを使用して設定する

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

追加のカスタム引数を送信する場合は、customArgName1 customArgValue1 customArgName2 customArgValue2 のようにフラグの後に追加します。入力フィールドの必要な場所に {{_payload.customArgName}} を追加して、カスタム引数を解析します。
動的プロパティに関する詳細はこちらをご確認ください。

スクリプトから設定する

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

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": "jsmAlarm",
    "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 "

}

Jira Service Management ではペイロードは次のように解析されます。

(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": "jsmAlarm",
    "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 "

}

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

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート