LogicMonitor と統合する

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

この統合のレガシーバージョンは、 LogicMonitor REST API v1 および v2 の提供終了後は利用できなくなります。

デバイスの AutoDiscovery によって、監視ツールをより迅速かつ自動的にデプロイ/管理します。組み込みのカスタマイズ可能なダッシュボード、パフォーマンス予測、完全なレポートで、インフラストラクチャのパフォーマンスデータに対応します。アラートルーティングやエスカレーション管理など、組み込みのワークフロー機能で IT チームの課題への対応を向上して、解決時間を短縮します。LogicMonitor アラートを Jira Service Management に転送して、iPhone や Android のプッシュ通知、メール、SMS、電話を通じてユーザーに通知し、アラートのライフサイクルの追跡、アラートのエスカレーションなどを行います。

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

Jira Service Management は LogicMonitor とのネイティブで双方向的な統合を備えています。統合を使用して LogicMonitor と Jira Service Management アラートを自動的に同期することで、Jira Service Management の豊富なアラート通知システム、エスカレーション、オンコールローテーションのメリットが得られます。

このドキュメントでは、統合の基本機能、設定方法、Jira Service Management と LogicMonitor 間で交換されるデータの詳細について説明します。

統合による機能

LogicMonitor でアラートが作成されると、統合を通じて Jira Service Management でアラートが自動的に作成されます。
アラートが LogicMonitor でクローズされると、関連するアラートが Jira Service Management でもクローズされます。
LogicMonitor でアラートが承認されると、関連するアラートが Jira Service Management でも承認されます。
Jira Service Management でアラートが承認されると、関連するアラートが LogicMonitor でも自動的に承認されます。

統合をセットアップする

LogicMonitor は双方向の統合です。設定は次の手順で行います。

Jira Service Management で LogicMonitor 統合を追加する
LogicMonitor で統合を設定する

LogicMonitor 統合を追加する

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

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

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

チームのオペレーションページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「LogicMonitor」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開して、Jira Service Management のエンドポイントと API キーを含む統合 URL をコピーします。
この URL は、後ほど LogicMonitor で統合を設定する際に使用します。
Jira Service Management のアラートアクションを LogicMonitor に送信するには、[Outgoing (出力)] セクションで [アラートの更新を LogicMonitor に送信] を選択します。
ボックスが選択されていれば、次に関連フィールドに入力します。LogicMonitor で、Jira Service Management から LogicMonitor にアラートアクションを送信するための「ackonly」ロールのみを持つユーザーを作成すると役立つ場合があります。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

LogicMonitor で統合を設定する

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

LogicMonitor で、[設定] > [統合] を選択します。
LogicMonitor を検索して、[追加] > [カスタム HTTP 配信] を選択します。
http://www.example.com/uri を、先ほどコピーした統合 URL で置き換えます。
alertData.txt をダウンロードして、その内容を [Alert Data (アラートデータ)] にコピーします。
[データ形式] には「フォームデータ」を選択します。
[送信] を選択します。

アラートアクションをマッピングする

Jira Service Management アクションと LogicMonitor アクション間 (アラートのソースが LogicMonitor である場合も同様) のマッピングを定義できます。これには LogicMonitor アカウントの追加認証が必要です。

「設定」ページで [編集] を選択して、統合を編集します。
[Authenticate for sending alert updates to Logic Monitor (Logic Monitor にアラートの更新を送信するための認証)] セクションで、[Authenticate with a Logic Monitor account (Logic Monitor アカウントで認証)] チェックボックスをオンにして、それに応じてフィールドに値を入力します。
- レガシーバージョンの LogicMonitor を使用している場合:
  - アカウント名: LogicMonitor アカウントの名前
  - ユーザー名: LogicMonitor にログインするためのユーザー名
  - パスワード: LogicMonitor にログインするためのパスワード
- 新しいバージョンの LogicMonitor を使用している場合:
  - アカウント名: LogicMonitor アカウントの名前
  - Logic Monitor ベアラートークン: LogicMonitor のシステムと安全に対話し、データを取得したり、アクションを実行したりするために使用するトークン。
[保存] を選択します。

LogicMonitor から送信されるペイロードの例

(JSON 形式)

{
        "alertid": "LMS22",
        "alertstatus": "active",
        "datasource": "WinVolumeUsage-C:\",
        "datapoint": "PercentUsed",
        "date": "2014-05-02 14:21:40 PDT",
        "dsdesc": "Monitors space usage on logical volumes.",
        "dsidesc": null,
        "datapointdesc": "Percentage Used on the volume",
        "group": "group1,group2",
        "host": "jsm-test-server",
        "hostdesc": "Server used for testing Jira Service Management integrations",
        "instance": "C:\",
        "level": "warning",
        "duration": "1465",
        "threshold": "10",
        "eventsource": "WinVolumeUsage-C:\",
        "eventlogfile": "Application",
        "eventtype": "information",
        "eventmsg": "Percentage used on the volume exceeded 80%",
        "eventlogmsg": "Remaining capacity(1456750MB) of volume C:\ is lower than 25%",
        "eventcode": "1847502394",
        "eventuser": "test-user",
        "value": "83",
        "batchdesc": "Monitors space usage on logical volumes everyday.",
        "hostips": "123.456.789.012",
        "hosturl": "https://jsm-test-server.net/",
        "service": "webservice",
        "alerttype": "error",
        "agent": "jsm-test-server",
        "checkpoint": "1879234",
        "hostinfo": null,
        "servicedetail": null,
        "serviceurl": "https://jsm-test-server.net/",
        "servicegroup": "Functional Testing",
        "clearvalue": "1"
    }

テストアラートのトラブルシューティング

これらの情報アラートは、受信データがテスト目的のみであることを示します。テストデータは予想されるデータとは異なる可能性があるため、統合フローを実行せずにアラートが作成されます。

LogicMonitor リクエストを処理する際に、それがテストリクエストであるかどうかがチェックされます。もしテストリクエストである場合は、統合フロー (動的フィールドへの入力など) を中断して、必要なパラメーターを含むアラートリクエストを作成します。"統合" フィールドが null である場合は、DefaultAPI 統合 (削除することも、存在を保証することもできません) に設定されます。こうしたケースでは、既定 API によって作成されるアラートになります。

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問