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

統合でできるようになること
Jira Service Management の Oracle Enterprise Manager (OEM) 統合を使用して、OEM のアラートを Jira Service Management に転送します。 Jira Service Management は、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iPhone と Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。
統合による機能
OEM でインシデントが作成されると、統合により Jira Service Management でもアラートが自動的に作成されます。
統合をセットアップする
OEM は API ベースの統合です。設定は次の手順で行います。
Jira Service Management で OEM 統合を追加する
OEM で統合を設定する
OEM 統合を追加する
Bidirectional integrations aren’t supported in Free and Standard plans. All the other integrations are supported at a team level in Free and Standard; however, for their outgoing part to work, you need to upgrade to a higher plan. To add any integration at a site level through Settings
(gear icon) > Products
(under JIRA SETTINGS) > OPERATIONS
, you need to be either on Premium or Enterprise.
統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。
Jira Service Management で OEM 統合を追加するには、次の手順を実行します。
チームの運用ページに移動します。
左側のナビゲーション パネルで、[統合] > [統合を追加] の順に選択します。
検索を実行して「OEM」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して、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 キーが使用されます。
teams – Teams field is used to specify which teams should be notified for the Oracle Enterprise Manager alerts. This field is used to set the default teams field value. It can be modified to route different alerts to different teams in Jira Service Management Oracle Enterprise Manager integration, Advanced Settings page.
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 です。
To send additional custom arguments, add them after the flags as: customArgName1 customArgValue1 customArgName2 customArgValue2. Parse custom arguments by adding {{_payload.customArgName}} to wherever needed in the input fields. Read more about dynamic properties. Configure the golang-executable to use a proxy for sending HTTP requests by defining the environment variable HTTP_PROXY=http://host:port
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 コマンド)] に貼り付けます。Enter values for the apiKey, teams, and tags parameters into this command. For example,
/etc/jsm/send2jsm -apiKey c193179e-4e72-43f4-b211-cdd0b029132f -teams "team1,team2" -tags "tag1,tag2"
You can also assign values to these parameters in the configuration file. If you use command-line parameters, it'll override the values set in the configuration file if any. Teams and tags parameters are optional but you have to configure the API key of the integration either as a command-line argument to OEM OS Command or as a parameter in the configuration file.[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"
}
この内容はお役に立ちましたか?