アラート プロパティを使用する

Jira Service Management はデータを解析して、豊富で有益なアラートを作成します。カスタム アラート プロパティを使用して、アラートとアラート条件を調整できます。

ドラッグ可能なアラート プロパティ

ドラッグ可能なアラート プロパティは、十分な情報に基づくアラートを作成/管理するための重要なデータを提供します。統合フレームワークは、統合アプリ固有のさまざまなアラート プロパティを提供します。カスタム アラート プロパティは、アラート フィールドだけでなく、統合アクションのフィルターにも使用できます。フィルターでは、条件のドロップダウンでカスタム アラート プロパティを選択できます。アラートのプロパティでは、カスタム アラート プロパティを適切なアラート フィールドにドラッグできます。

Jira Service Management interprets the expressions within the double-curly braces as custom alert properties. Custom data populates at every notification that's sent to Jira Service Management. For example, someone creates a work item in Jira and enters "This is the summary" for the summary. Using Jira Service Management’s Jira integration, "[Jira] {{summary}}" for Message in a ‘Create alert' Action creates an alert with the message "[Jira] This is the summary". It will then notify the users. All we needed to do is drag {{summary}} to the message. When the work item is created, Jira Service Management gets notified automatically. It creates an alert with the work item’s summary in the message.

静的テキストとカスタム アラート プロパティは混在可能です。上記の例では、「[Jira] {summary}」の「[Jira]」は静的であり、新しいアラートが作成されるたびにメッセージの先頭に表示されます。"{summary}" はアラートごとに異なる可能性があります。

Add or edit alert rules

• ルール タイプ：ルールの実行時に、このルールが実行するアクションを選択します。

• Rule name: Name your rule to easily identify it later.

Add filter conditions: You can add alert filters to set the conditions that the alert must match for the rule to run. Filter types:

• All the alerts (no conditions in use): No conditions are in effect, so all alerts will cause this rule to run. This is the default setting. Here are the alert filters:

• Alerts that match at least one condition: When there are alerts that match one or more conditions, the rule will run and execute the selected action.

• Alerts that match all the conditions: When there are alerts that match all the conditions, the rule will run and execute the selected action.

アラート プロパティ

• Drag and drop the alert properties available in the Alert properties section to Alert details fields and .

• Click + to create a new property. You can also create a custom alert property by typing this syntax directly in the alert detail fields: {{_payload.customField}}, {{_headers.customField}} or {{_url.customField}

• ルールをただちにオンにする場合は、[Turn on now（今すぐ有効）] > [追加] の順に選択して続行します。

• You can edit, turn off, and duplicate the rule from More actions.

Webhook URL、ペイロード、ヘッダーの生のパラメーターを使用する

Webhook から URL パラメーターまたは http ペイロード パラメーターをアラートに直接挿入できます。たとえば、統合アプリの Webhook ペイロードで timestamp という名前の変数を Jira Service Management に送信するとします。しかし、設定ページでは timestamp をドラッグ可能なプロパティとして利用できません。それでも timestamp をアラートに使用する必要がある場合は、入力フィールドに {{_payload.timestamp}} を追加します。

ネストされたペイロード変数にもアクセスできます。次の例のように、_payload.issue.fields.environment を使用して Webhook の http 本文にある次の値にアクセスすることもできます。

Webhook の URL クエリ パラメーターには、{{_url.param}} を介してアクセスできます (param はパラメーター キーです)。Webhook URL にカスタム パラメーターを追加して、アラートに挿入できます。たとえば、Jira Service Management の Google Cloud Operations Suite 統合を使用していると仮定します。ここでは、ご自身が多くのプロジェクトを監視しており、すべてのアラートに対して 1 つの統合を使用したいと考えているとしましょう。どのアラートがどのドメインに属しているかを区別する必要がある場合は、projects.alert ごとにカスタム パラメーターを使用できます。

Google Cloud Operations Suite 統合の Webhook URL にカスタム パラメーターを追加できます (例: m1=val1、統合設定で {{_url.param1}} を挿入するとアクセス可能)。{{_headers.param}} を介して Webhook リクエストのヘッダーも利用できます (param はヘッダーの名前)。アラート フィールドでは、リクエストのすべてのヘッダーを使用できます。

アラート フィールドをさらに制御するために、アラート プロパティで文字列処理メソッドを使用できます。たとえば、統合に「メモの追加」アクションがあり、メモが「note: {comment_body.substringAfter("is")}」として設定されているとします。

Now when someone in the integrated application adds "This is the comment" as a comment to the work item, a note is added to the corresponding alert, with the text "note: the comment". Read more about string processing methods.

アラート プロパティをサポートしない統合

• API

• Apica

• appsignal-v2

• Atatus

• blue-matador

• CircleCI

• cloudspoint

• Consul

• Detectify

• DNSCheck

• DripStat

• Dynatrace

• grafana-v2

• Graylog

• Humio

• Instana

• jec

• Kapacitor

• Logstash

• Loom

• nagios-legacy

• nagios-xi-legacy

• OEC

• OpsDash

• Prometheus

• Riemann

• Rigor

• sematext-spm

• Sensu

• Sentry

• servicenow-legacy-v1

• signal-sciences

• signalfx-v2

• solarwinds-db-performance-monitor

• stack-storm

• Thundra

• Tideways

• trace-by-risingstack

• track-it

• uptime-project

• whatsup-gold

• Workato

• xl-release

• Xmpp

• Zapier