Oracle Enterprise Manager（OEM）と統合する

Jira Service Management の Oracle Enterprise Manager (OEM) 統合を使用して、OEM のアラートを Jira Service Management に転送します。

動作の仕組み

OEM でインシデントが作成されると、Jira Service Management でアラートが自動的に作成されます。

Jira Service Management は、オンコールスケジュールに基づいて適切な通知先を決定します。メール、テキストメッセージ (SMS)、電話、iPhone や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。

統合をセットアップする

OEM は API ベースの統合です。セットアップするには、次の操作を行う必要があります。

Jira Service Management で OEM 統合を追加する
OEM プラグインをダウンロードする
OEM で統合を設定する

OEM 統合を追加する

以下の機能は、Jira Service Management の Premium と Enterprise でのみご利用いただけます。

双方向の統合
チームレベルでの送信統合
[設定] ( アイコン) > [製品] ([Jira 設定] 内) > [オペレーション] を通じたサイトレベルでの統合

Jira Service Management Premium の機能を利用するには、Service Collection Premium または Enterprise プランに登録する必要があります。

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

Jira Service Management で OEM 統合を追加するには、次の手順に従います。

サイドバーの [オペレーション] の横にある [その他のアクション] () を選択し、次に [一般設定] を選択します。
[統合] > [統合を追加] の順に選択します。
[OEM] を検索して選択します。
統合の名前を入力します。
必要に応じて、特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
[統合を設定する手順] を展開して、API キーをコピーします。
- この API キーは、send2jsm プラグイン設定ファイルで使用します。
[統合をオンにする] を選択します。

Oracle Enterprise Manager プラグインをダウンロードする

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

Jira Service Management 用の Oracle Enterprise Manager プラグインをダウンロードしてインストールします。
次のコマンドを実行します。

sudo rpm -i jsm-oem-<your_version>.rpm

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

Jira Service Management 用の Oracle Enterprise Manager プラグインをダウンロードしてインストールします。
次のコマンドを実行します。

sudo dpkg -i jsm-oem-<your_version>.deb

プラグインを構成する

インストール後、プラグインの設定ファイル (jsm-integration.conf) を取得します。このファイルは、/etc/jsm/conf にあります。
このファイルを編集し、「apiKey」キーに OEM 統合用の API キーを置いて、「<your_integration_api_key>」を置き換えます。
設定ファイルを保存します。

設定パラメーター

apiKey – 上記で作成した Oracle Enterprise Manager 統合から API キーをコピーします。oem2jsm は、このキーを使用して Jira Service Management への認証を行います。アラートの処理に使用される適切な統合設定の識別にも API キーが使用されます。
チーム – 「チーム」フィールドは、Oracle Enterprise Manager のアラートを通知する必要があるチームを指定するために使用します。このフィールドは、チームフィールドの既定値を設定するために使用されます。Jira Service Management の Oracle Enterprise Manager 統合の [詳細設定] ページで、異なるアラートを異なるチームに送信するよう変更できます。
tags – tags フィールドは、Jira Service Management で作成されたアラートのタグを指定するために使用します。
logPath – ログファイルの完全なパスを指定します(既定値は /var/log/jsm/oem2jsm.log)。
oem2jsm.http.proxy.enabled – oem2jsm.http.proxy.enabled フィールドは、外部プロキシの設定を有効または無効にします。既定値は false です。
oem2jsm.http.proxy.host – プロキシのポート。
oem2jsm.http.proxy.port – プロキシのポート。
oem2jsm.http.proxy.scheme – プロキシ接続プロトコル。プロキシサーバーに応じて http または https になる場合があります。既定値は http です。
oem2jsm.http.proxy.username – プロキシ認証ユーザー名。
oem2jsm.http.proxy.password – プロキシ認証パスワードです。
jsm.api.url — API URL です。

追加のカスタム引数を送信する場合は、customArgName1 customArgValue1 customArgName2 customArgValue2 のようにフラグの後に追加します。{{_payload.customArgName}} を入力フィールドの該当する場所に追加してカスタム引数を解析します。動的プロパティに関する詳細をご確認ください。環境変数 HTTP_PROXY=http://host:port を定義して、HTTP リクエストを送信するプロキシを使用する golang 実行可能ファイルを設定します。

OEM で統合を設定する

OEM と Jira Service Management の統合を設定するには、次の手順に従います。

/etc/jsm/conf に移動し、設定ファイル jsm-integration.conf を開いて編集します。
Oracle Enterprise Manager で [Setup (セットアップ)] を選択します。
[Notifications (通知)] にカーソルを合わせ、[Scripts and SNMPv1 Traps (スクリプトと SNMPv1 トラップ)] を選択します。
メニューから [OS Command (OS コマンド)] を選択して [Go (開始)(] を選択します。
[Name (名前)] にコマンドの名前を入力します (例: send2jsm)。
必要に応じてコマンドの説明を入力します。
/etc/jsm/oem2jsm をコピーして [OS Command (OS コマンド)] に貼り付けます。
このコマンドに apiKey、teams、tagsの各パラメーターの値を入力します例: /etc/jsm/send2jsm -apiKey c193179e-4e72-43f4-b211-cdd0b029132f -teams "team1,team2" -tags "tag1,tag2"。
- 設定ファイルでこれらのパラメーターに値を割り当てることもできます。コマンドラインパラメーターを使用すると、設定ファイルに設定されている値があれば上書きされます。teams と tags のパラメーターは必須ではありませんが、統合の API キーを OEM OS コマンドのコマンドライン引数として、または設定ファイルのパラメーターとして設定する必要があります。
[OK] を選択します。
- これで、インシデントルールでこの通知方法をアクションとして使用できるようになりました。あとは、ルールに新しいアクションを追加するときに、[Advanced Notifications (高度な通知)] タブで [oem2jsm (OS Command) (oem2jsm (OS コマンド))] を選択するだけです。

OEM プラグインからの Webhook メッセージの例

JSON

{
            "ASSOC_EVENT_COUNT": "1",
            "CATEGORIES_COUNT": "1",
            "CATEGORY_1": "Capacity",
            "CATEGORY_CODES_COUNT": "1",
            "CATEGORY_CODE_1": "Capacity",
            "ESCALATED": "No",
            "ESCALATED_LEVEL": "0",
            "EVENT_SOURCE_1_HOST_NAME": "WIN-NAMD8F7JLL1",
            "EVENT_SOURCE_1_TARGET_GUID": "A0D26BACFF431D97FF36B90D82811004",
            "EVENT_SOURCE_1_TARGET_NAME": "WIN-NAMD8F7JLL1",
            "EVENT_SOURCE_1_TARGET_OWNER": "SYSMAN",
            "EVENT_SOURCE_1_TARGET_TYPE": "host",
            "EVENT_SOURCE_1_TARGET_URL": "https://WIN-NAMD8F7JLL1:7799/em/redirect?pageType",
            "EVENT_SOURCE_1_TARGET_VERSION": "6.3.9600.0.0",
            "EVENT_SOURCE_2_HOST_NAME": "WIN-NAMD8F7JLL2",
            "EVENT_SOURCE_2_TARGET_GUID": "A0D26BACFF431D97FF36B90D82811005",
            "EVENT_SOURCE_2_TARGET_NAME": "WIN-NAMD8F7JLL2",
            "EVENT_SOURCE_2_TARGET_OWNER": "SYSMAN2",
            "EVENT_SOURCE_2_TARGET_TYPE": "host2",
            "EVENT_SOURCE_2_TARGET_URL": "https://WIN-NAMD8F7JLL1:7799/em/redirect?pageType2",
            "EVENT_SOURCE_2_TARGET_VERSION": "6.3.9600.0.2",
            "EVENT_SOURCE_COUNT": "2",
            "INCIDENT_ACKNOWLEDGED_BY_OWNER": "No",
            "INCIDENT_CREATION_TIME": "Oct 10, 2016 7:26:50 AM GMT",
            "INCIDENT_ID": "30",
            "INCIDENT_STATUS": "New",
            "ISSUE_TYPE": "2",
            "LAST_UPDATED_TIME": "Oct 10, 2016 7:26:50 AM GMT",
            "MESSAGE": "CPU Utilization is 12.746%, crossed warning (2) or critical (10) threshold.",
            "MESSAGE_URL": "https://WIN-NAMD8F7JLL1:7799/em/redirect?pageType",
            "NOTIF_TYPE": "NOTIF_NORMAL",
            "ORCL_GTP_OS": "Windows",
            "ORCL_GTP_PLATFORM": "x64 (AMD or Intel)",
            "PRIORITY": "None",
            "PRIORITY_CODE": "PRIORITY_NONE",
            "REPEAT_COUNT": "0",
            "RULESET_NAME": "Prod Rule Set",
            "RULE_NAME": "Prod Rule Set,rule 132",
            "RULE_OWNER": "SYSMAN",
            "SEVERITY": "Critical",
            "SEVERITY_CODE": "CRITICAL",
            "SEVERITY_SHORT": "CR",
            "SystemRoot": "C:\\Windows",
            "UPDATES": "Incident created by rule (Name ",
            "UPDATES_1": "Incident created by rule (Name ",
            "UPDATES_COUNT": "1",
            "USER_DEFINED_TARGET_PROP": "Operating System",
            "apiKey": "1234-abcd-5678-efgh",
            "tags": "tag1,tag2",
            "teams": "team1,team2"
}

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

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

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

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

コミュニティに質問