• 使用を開始する
  • 関連ドキュメント
クラウド

We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

Oracle Enterprise Manager（OEM）と統合する

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

Use Jira Service Management's Oracle Enterprise Manager (OEM) integration to forward OEM alerts to Jira Service Management.

動作の仕組み

When an incident is created in OEM, an alert is automatically created in Jira Service Management.

Jira Service Management finds the right people to notify based on on-call schedules, then notifies them using email, text messages (SMS), phone calls, and iPhone and Android push notifications, then escalates until the alert is acknowledged or closed.

統合をセットアップする

OEM is an API-based integration. To set it up, you’ll need to:

  1. Add the OEM integration in Jira Service Management

  2. Download the OEM plugin

  3. OEM で統合を設定する

OEM 統合を追加する

双方向統合は Free プランと Standard プランではサポートされていません。他のすべての統合は Free と Standard でチーム レベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイト レベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。

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

To add an OEM integration in Jira Service Management:

  1. チームの運用ページに移動します。

  2. From the navigation on the left, select Integrations, then Add integration.

  3. Search for and select “OEM”.

  4. 統合の名前を入力します。

  5. If desired, a team in Assignee team if you want a specific team to receive alerts from the integration.

  6. [続行] を選択します。

  7. Expand Steps to configure the integration, and copy the API key.

    • You'll use this API key in the send2jsm plugin configuration file.

  8. Select Turn on integration.

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

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

  1. Jira Service Management 用の Oracle Enterprise Manager プラグインをダウンロードしてインストールします。

  2. 次のコマンドを実行します。

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

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

  1. Jira Service Management 用の Oracle Enterprise Manager プラグインをダウンロードしてインストールします。

  2. 次のコマンドを実行します。

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

プラグインを構成する

  1. インストール後、プラグインの設定ファイル (jsm-integration.conf) を取得します。このファイルは、/etc/jsm/conf にあります。

  2. このファイルを編集し、「apiKey」キーに OEM 統合用の API キーを置いて、「<your_integration_api_key>」を置き換えます。

  3. 設定ファイルを保存します。

設定パラメーター

  • apiKey – 上記で作成した Oracle Enterprise Manager 統合から API キーをコピーします。oem2jsm は、このキーを使用して Jira Service Management への認証を行います。アラートの処理に使用される適切な統合設定の識別にも API キーが使用されます。

  • teams – The “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 です。

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

OEM で統合を設定する

To configure the integration of OEM with Jira Service Management:

  1. /etc/jsm/conf に移動し、設定ファイル jsm-integration.conf を開いて編集します。

  2. Oracle Enterprise Manager で [Setup (セットアップ)] を選択します。

  3. [Notifications (通知)] にカーソルを合わせ、[Scripts and SNMPv1 Traps (スクリプトと SNMPv1 トラップ)] を選択します。

  4. メニューから [OS Command (OS コマンド)] を選択して [Go (開始)(] を選択します。

  5. Enter a name for the command into Name. For example, send2jsm.

  6. If desired, enter a description for the command.

  7. /etc/jsm/oem2jsm をコピーして [OS Command (OS コマンド)] に貼り付けます。

  8. 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.

  9. [OK] を選択します。

    • You can now use this notification method in your incident rules as an action. All you have to do is select oem2jsm (OS Command) in the Advanced Notifications tab while adding a new action to the rule.

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" }

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

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容動作の仕組み統合をセットアップするOEM 統合を追加する Oracle Enterprise Manager プラグインをダウンロードするプラグインを構成するOEM で統合を設定するOEM プラグインからの Webhook メッセージの例
コミュニティ質問、ディスカッション、記事