Jira Service Management の新しいナビゲーション

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

Solarwinds NPM と統合する

 

SolarWinds のロゴ

SolarWinds NPM のクイック・インストールで、デバイスを検出して監視を開始しましょう。SolarWinds NPM は、ネットワーク・デバイスの応答時間、可用性、パフォーマンスを監視/表示します。また、インテリジェントなアラートシステムを備えているため、アラートの作成やリセット時にアクション(メールの送信、Get 機能または Post URL 機能の使用など)を実行します。

SolarWinds NPM アラートは、サーバーが応答しない等のネットワーク・イベントの発生に関する自動通知です。アラートをトリガーするネットワーク・イベントは、アラートの設定時に設定された条件によって決まります。

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

Jira Service Management は、SolarWinds NPM の双方向統合を提供します。この統合は、SolarWinds NPM の「Web サーバーへの Post リクエスト送信」機能と JEC ユーティリティを活用してアラートを自動で作成し、SolarWinds NPM と Jira Service Management の間でアラートのステータスを同期します。

SolarWinds NPM 統合を使用すると、Jira Service Management がこれらのアラートのディスパッチャーとして機能し、オンコール スケジュールに基づいて通知すべきユーザーを決定します。メール、テキストメッセージ(SMS)、電話、iPhone や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。

Jira Service Management には SolarWinds NPM 統合専用の API があります。SolarWinds NPM は Jira Service Management にアラートを送信し、Jira Service Management がアラートの自動作成を処理します。

統合による機能

  • SolarWinds NPM は、監視しているオブジェクトがアラートの条件を満たした際にアラートをトリガーします。SolarWinds NPM でアラートが作成されると、統合を通じて Jira Service Management でアラートが自動で作成されます。

  • Jira Service Management でアラートが承認されると、JEC でスクリプトが実行されて、SolarWinds NPM でもアラートが自動で承認されます。

  • Jira Service Management でアラートにメモが追加されると、JEC でスクリプトが実行されて、SolarWinds NPM でもアラートにメモが追加されます。

Microsoft servers (.NET based apps, MS S Channel, and so on) have problems handling TLS (https) against Cloudflare; connection failures occur every hour. Ensure you have installed the update to improve TLS session resumption interoperability on your Microsoft servers to keep your integration stable. Read more about the update improve TLS session resumption interoperability.

統合をセットアップする

SolarWinds NPM は双方向の統合です。次の手順でセットアップを行います。

  • Jira Service Management に SolarWinds NPM 統合を追加する

  • SolarWinds NPM で統合を設定する

SolarWinds NPM 統合を追加する

The following capabilities are available in Jira Service Management Premium and Enterprise:

  • 双方向の統合

  • Outgoing integrations at the team level

  • Integrations at a site level through Settings (icon) > Products (under Jira settings) > Operations

To access Jira Service Management Premium features, you must subscribe to a Service Collection Premium or Enterprise plan.

Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management only assigns the alerts received through this integration to your team.

 

Jira Service Management で SolarWinds NPM 統合を追加するには、次の手順を実行します。

  1. Next to Operations in the sidebar, select More actions (), then General configuration.

  2. Select Integrations and then Add integration.

  3. 検索を実行して [SolarWinds NPM] を選択します。

  4. 次の画面で、統合の名前を入力します。

  5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

  6. [Continue] を選択します。
    この時点で、統合が保存されます。

  7. 統合を設定する手順」セクションを展開して、統合 URL をコピーします。
    この URL は、後ほど SolarWinds NPM で統合を設定する際に使用します。

  8. [統合をオンにする] を選択します。
    統合のために作成したルールは、統合をオンにした場合にのみ機能します。

SolarWinds NPM で統合を設定する

Jira Edge Connector is a prerequisite for configuring the outgoing authentication of Solarwinds Orion NPM integration. Download the latest version of the Solarwinds Orion NPM package.

SolarWinds NPM で統合を設定するには、次の手順を実行します。

  1. SolarWinds NPM で、[設定] > [アラートを管理] > [Alert Manager(アラート・マネージャー)] の順に移動します。

  2. [新しいアラートを追加] を選択します。

  3. 必要に応じてアラートのプロパティを設定します。
    名前、重大度、条件を評価する頻度、アカウント制限を使用してアラート全体のアクセスを制限するかどうかなど、アラートに関する情報を指定します。

  4. 必要に応じてトリガー条件を設定します。
    トリガー・アクションは、トリガー条件が満たされたときに実行されます。SolarWinds NPM には、ユーザーが複雑な条件を構築するための堅牢な条件メカニズムがあります。データベースで利用可能なすべてのフィールドを、これらの条件で使用できます。
    利用できる変数の多様性と柔軟性を考慮して、Jira Service Management ではなく SolarWinds で条件を構築することを強くお勧めします。

  5. リセット条件を設定します。
    条件が満たされるとリセット アクションが実行されます。

  6. アラートがネットワークを監視する時間間隔を設定します (常に有効、または指定した時間に制限)。

  7. トリガー・アクションの値を入力して、[アクションを追加] を選択します。
    このトリガー・アクションにより、SolarWinds NPM がアラートデータを Jira Service Management に送信して、Jira Service Management でアラートが作成されます。Jira Service Management にアラートデータを送り返すには、トリガー・アクションを [Web サーバーに Get リクエストまたは Post リクエストを送信する] に設定します。

  8. POST メソッドを選択します。

  9. Jira Service Management で統合を追加する際にコピーした URL を貼り付けます。

  10. Jira Service Management に送信する変数を次の形式で入力します:variable1=val1&variable2=val2
    Jira Service Management にトリガー・アクションと併せて送信されるすべての変数は、SolarWinds NPM 統合の "アラート" フィールドの「アラートを作成」アクションで使用されます。

  11. Specify teams, recipients, and tags by putting them into the content. Send the default trigger action body from SolarWinds.
    The "alias" field in the following example becomes the SolarWinds NPM alerts alias field. To make different alias configurations, change the value of the alias field in post content. Ensure the alias configurations in "Trigger" and "Reset" are the same.

    Jira Service Management parses incoming data and creates robust alerts according to the incoming content. With dynamic properties, you can modify alert fields based on incoming data. Read more about dynamic properties.

    SolarWinds NPM で、監視しているオブジェクト(ノード、ボリューム、インターフェイスなど)のアラートを作成します。共通するフィールドと、監視しているオブジェクトに固有のフィールドを送信するには、「HTTP リクエストを送信」アクションを使用します。SolarWinds NPM 統合では、アラート固有のフィールドをカスタム統合のフィールドとして利用できます。Jira Service Management に送信される動的フィールドは、引き続きサポートされます。

    :NodeID 変数は Jira Service Management で利用可能な統合フィールドの 1 つではないので、これをアラートに含めるには SolarWinds NPM から送信してアラート設定で動的に使用します。Jira Service Management と SolarWinds NPM で使用される変数名が同じであることをご確認ください。

    NodeID=${N=SwisEntity;M=NodeID} によって NodeID 変数を HTTP の Post 本文に追加してから、{{NodeID}} の次の例のように SolarWinds NPM 統合の "アラート・アクションを作成" アラート フィールドで使用します。

  12. Set the reset action. With a reset action, SolarWinds NPM posts the data that closes the corresponding alert in Jira Service Management. Configure the reset action with Send a Get or Post Request to a Web Server option. Download the default reset action body to send from SolarWinds NPM.

  13. アラート設定を確認して、[送信] を選択します。

オプション:SolarWinds 統合を更新するように Jira Service Management を設定する

JEC ユーティリティと SolarWinds スクリプトを使用して、SolarWinds でアラートを更新します。このセットアップによって、独自のスクリプトのデプロイ、提供されたスクリプトの変更、SolarWinds 上でのカスタマイズ済みアクションの実行を行えます。SolarWinds 統合パッケージを使用するには、次の手順を実行します。

  1. Download the latest version of JEC for the SolarWinds package.

  2. パッケージをインストールします。

Windows の場合

Unzip Jira Service Management integration zip file, which contains the JEC package into a directory (C:\jsm\jec is the preferred path). Read more about installing JEC on Windows.

To execute actions in SolarWinds, JEC gets the configuration parameters from the configuration file (found under the directory where the zip file is extracted). If you used the preferred path in Windows, it is C:\jsm\jec\config.json. Read more about running JEC.

3. Jira Service Management の「SolarWinds 統合設定」ページにある [SolarWinds にアラート アクションを送信する] チェックボックスを選択します。

設定パラメーター

設定パラメーター

 説明

URL

アラートが承認された、コメントを受け取った際などに、SolarWinds アラートをアップデートするための URL

ホスト

SolarWinds のホスト

ログイン

SolarWinds Web サーバーを認証するログイン名。アラートが承認された、コメントを受け取った際などにアップデートを受け取ります。

パスワード

SolarWinds Web サーバーを認証するパスワード。アラートが承認された、コメントを受け取った際などにアップデートを受け取ります。

SolarWinds 統合パッケージは SSL v1.0 をサポートしていません。SolarWinds サーバーで SSL v1.0 を使用している場合は、SSL サーバーをアップグレードしてください。

SolarWinds から送信されるサンプル パラメーター

(テキスト形式)

ActionType:Create alias:1 ObjectID:1 NodeName:172.31.14.211 Acknowledged:Not Acknowledged AcknowledgedBy: AcknowledgedTime:Never AcknowledgeUrl:http://WIN-PM7542TQNF9:8787/Orion/Netperfmon/AckAlert.aspx?AlertDefID=1 AlertDefID:e896e98d-b36b-4d7d-a32b-d6016269841d AlertDescription:default description AlertDetailsUrl:http://WIN-PM7542TQNF9:8787/Orion/View.aspx?NetObject=AAT:1 AlertID:49 AlertMessage:deneme was triggered AlertName:deneme AlertTriggerCount:312 AlertTriggerTime:Tuesday, January 5, 2016 8:16 AM Application:SolarWinds.Core.Common DateTime:Tuesday, January 5, 2016 8:16 AM DownTime:0 LastEdit:Tuesday, January 5, 2016 8:16 AM ObjectType:Node Severity:Critical TimeOfDay:Alert is always enabled teams:team1, team2 recipients:test@abc.com, test2@abc.com tags:tag1,tag2

Jira Service Management はペイロードを次のように解析します。

(JSON 形式)

[ "ActionType": "Create", "ObjectID": "1", "NodeName": "172.31.14.211", "AlertDefID": "e896e98d-b36b-4d7d-a32b-d6016269841d", "DownTime": 0, "AlertTriggerTime": "Tuesday, January 5, 2016 8:16 AM", "DateTime": "Tuesday, January 5, 2016 8:16 AM", "AlertTriggerCount": 312, "ObjectType": "Node", "AlertID": "49", "alias": "1", "AcknowledgedTime": "Never", "AlertMessage": "deneme was triggered", "TimeOfDay": "Alert is always enabled", "AcknowledgedBy": "", "AlertName": "deneme", "teams": "[team1, team2]", "originalTags": "[tag1, tag2]", "AcknowledgeUrl": "http://WIN-PM7542TQNF9:8787/Orion/Netperfmon/AckAlert.aspx?AlertDefID=1", "Severity": "Critical", "originalExtraProperties": "[AlertDefinitionID:e896e98d-b36b-4d7d-a32b-d6016269841d, ObjectType:Node, ObjectID:1]", "tags": "[tag1, tag2]", "AlertDescription": "default description", "LastEdit": "Tuesday, January 5, 2016 8:16 AM", "recipients": "[test@abc.com, test2@abc.com]", "AlertDetailsUrl": "http://WIN-PM7542TQNF9:8787/Orion/View.aspx?NetObject=AAT:1", "Application": "SolarWinds.Core.Common", "Acknowledged": "Not Acknowledged" ]

トラブルシューティング

SolarWinds NPM sends the body without making any escapes on data. Hence, if any variables contain any characters that need to be escaped (like &), send the data in advanced mode. Use µ#µ instead of = and §#§ instead of &. Sending the data from SolarWinds NPM to Jira Service Management in either format produces the same results in Jira Service Management. Refer to a troubleshooting version of the default content for the trigger action body and reset action. Ensure that the Body to Post text matches this to Acknowledge/Close/AddNote actions on the SolarWinds side.

 

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

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