• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

Solarwinds NPM と統合する

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

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 サーバー(.NET ベースのアプリ、MS S Channel など)では、Cloudflare に対する TLS(https)の処理に問題があるため、接続障害が 1 時間ごとに発生します。TLS セッション再開の相互運用性を改善して、統合を安定させるためのアップデートが Microsoft サーバーにインストールされているか、ご確認ください。TLS セッション再開の相互運用性を改善するためのアップデートの詳細をご確認ください

統合をセットアップする

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

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

  • SolarWinds NPM で統合を設定する

SolarWinds NPM 統合を追加する

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

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

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

  1. チームのオペレーション ページに移動します

  2. 左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。

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

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

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

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

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

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

SolarWinds NPM で統合を設定する

Jira Edge Connector は SolarWinds Orion NPM 統合の送信認証を設定するための前提条件です。SolarWinds Orion NPM パッケージの最新バージョンをダウンロードしてください

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. チーム、受信者、タグは、コンテンツに配置することで指定します。SolarWinds から既定のトリガー・アクションのボディを送信します
    次の例の "エイリアス" フィールドは、SolarWinds NPM の "アラート・エイリアス" フィールドになります。別のエイリアス設定を行うには、Post コンテンツの "エイリアス" フィールドの値を変更します。「トリガー」と「リセット」の両方のエイリアス設定が同じであることをご確認ください。

    Jira Service Management は受信データを解析して、受信コンテンツに応じて堅牢なアラートを作成します。動的プロパティを使用すると、受信データに基づいて "アラート" フィールドを変更できます。動的プロパティに関する詳細をご確認ください。

    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. リセット・アクションを設定します。リセット・アクションを使用すると、SolarWinds NPM は対応するアラートをクローズするデータを Jira Service Management に送信します。[Web サーバーに Get リクエストまたは Post リクエストを送信する] オプションを使用して、リセット・アクションを設定します。SolarWinds NPM から送信する既定のリセット・アクション本文をダウンロードします

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

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

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

  1. SolarWinds パッケージ用の JEC の最新バージョンをダウンロードします

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

Windows の場合

JEC パッケージを含む Jira Service Management 統合 zip ファイルをディレクトリ内に解凍します(C:\jsm\jec が推奨パス)。Windows への JEC のインストールに関する詳細をご確認ください

SolarWinds でアクションを実行するために、JEC は設定ファイル(zip ファイルが解凍されたディレクトリの下)から設定パラメーターを取得します。Windows で推奨パスを使用した場合は、C:\jsm\jec\config.json です。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 から送信されるサンプル パラメーター

(テキスト形式)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 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 形式)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 [ "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 は、データでエスケープを行わずに本文を送信します。したがって、エスケープする必要がある文字(& など)が変数に含まれている場合は、高度なモードでデータを送信してください。「=」の代わりに「µ#µ」を、「&」の代わりに「§#§」を使用します。SolarWinds NPM から Jira Service Management に対して、どちらの形式でデータを送信しても、Jira Service Management では同じ結果が得られます。トリガー・アクション本体リセット・アクションについては、既定コンテンツのトラブルシューティング・バージョンをご参照ください。SolarWinds で「承認/クローズ/メモを追加」の各アクションを実行するには、送信する本文テキストこちらと一致することをご確認ください。

 

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

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