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

SignalFx(レガシー)と統合する

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

SignalFX のロゴ

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

SignalFx 検出機能は信号を監視して、定義されたしきい値を超えるとアラートを送信します。SignalFx 統合によって、Jira Service Management はこれらのアラートのディスパッチャーとして機能し、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iPhone や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。

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

統合による機能

SignalFx 検出機能は信号を監視して、定義されたしきい値を超えるとアラートを送信します。SignalFx でアラートが作成されると、統合を通じて Jira Service Management でもアラートが自動的に作成されます。値が正常に戻ると、SignalFx 検出機能はアラートを解決します。SignalFx でアラートが解決されると、Jira Service Management でもアラートがクローズされます。

統合をセットアップする

SignalFx は API ベースの統合です。設定は次の手順で行います。

  • Jira Service Management で SignalFx 統合を追加する

  • SignalFx で統合を設定する

SignalFX 統合を追加する

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 で SignalFx 統合を追加するには、次の手順に従います。

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

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

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

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

5. 統合バリアントについては、[SignalFX Legacy] を選択します。

組み込みの通知サービスを使用する場合は、[SignalFX] を選択します。SignalFX との統合方法をご確認ください

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

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

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

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

SignalFx で統合を設定する

SignalFx で統合を設定するには、次の手順に従います。

  1. SignalFx で「組織の概要」ページを開きます。

  2. アラートを作成するメトリックを選択し、右上隅にあるベル アイコンを選択します。

  3. [チャートからの新しい検出機能] を選択します。

  4. [Detector Name (検出機能名)] に値を入力して、[アラート ルールを作成] を選択します。

  5. [アラート] 画面で、アラート信号、条件、設定、メッセージの値を入力します。

  6. [アラート受信者] で [受信者を追加] > [Webhook] の順に選択します。

  7. [カスタム] を選択します。

  8. 先ほど Jira Service Management からコピーした API URL を [URL] に貼り付けます。

  9. [Activate Alert Rule (アラート ルールを有効化)] を選択します。

  10. [保存] を選択します。

SignalFx から Jira Service Management に送信されたペイロードの例

次のスニペットの "Sources" フィールドは、JSON オブジェクトを文字列で表現したもので、内容は異なる場合があります。Sources オブジェクト全体がドラッグ可能な (動的) フィールドに追加されるため、必要に応じてカスタム フィールドを抽出できます。たとえば、アラートに Sources オブジェクトの "dsname" フィールドを追加するには、{{sources.dsname}} を使用します。

アラートのペイロードを作成する

(JSON 形式)

{ "severity": "Critical", "sources": "{\"AWSUniqueId\":\"i-274xxxx1_us-west-2_97xxxxxxxx\",\"dsname\":\"value\",\"host\":\"ip-172.us-west-2.compute.internal\",\"plugin\":\"signalfx-metadata\",\"plugin_instance\":\"utilization\",\"sf_metric\":\"memory.utilization\"}", "rule": "Create Jira Service Management Alert", "alertTimestamp": 1463567930000, "eventType": "_SF_PLOT_KEY_Ciu5eDlAgAc_9_3", "incidentId": "CiYI3ipAgnA", "detector": "Memory Used % Detector", "detectorUrl": "https://app.signalfx.com/#/detector/Ciu5eDlAgAc/edit", "currentValue": "4.07361626150254", "status": "too high" }

アラートのペイロードをクローズする

(JSON 形式)

{ "severity": "Critical", "sources": "{\"AWSUniqueId\":\"i-2xxx1_us-west-2_974xxxxxxx\",\"dsname\":\"value\",\"host\":\"ip-172-x.us-west-2.compute.internal\",\"plugin\":\"signalfx-metadata\",\"plugin_instance\":\"utilization\",\"sf_metric\":\"memory.utilization\"}", "rule": "Create Jira Service Management Alert", "alertTimestamp": 1463568222190, "eventType": "_SF_PLOT_KEY_Ciu5eDlAgAc_9_3", "incidentId": "CiYI3ipAgnA", "detector": "Memory Used % Detector", "detectorUrl": "https://app.signalfx.com/#/detector/Ciu5eDlAgAc/edit", "currentValue": "4.07361626150254", "status": "ok" }

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

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