アラート フィルターを使用する

フィルターとは、設定された条件のことです。Jira Service Management の多くの機能では、フィルターを使用して、いくつかの条件に基づいてアクションを実行します。特定の受信データとの統合アクションを処理したり、特定のタイプのアラートに対してコールバックを実行したり、特定のアラートにポリシーを適用したりするようにカスタマイズできます。

たとえば、Jira Service Management では、統合からのすべての受信データが処理され、それらが統合のアクションと照合されてから、それに基づいてアクションが実行されます。統合アクションには処理順序があります。1 つの Webhook で実行できるアクションは 1 つまでです。フィルターには条件セットがあります。最初のアラート フィルターが受信 Webhook データと一致しない場合、Jira Service Management は次のアクションに進みます。次に、このアラート フィルターが評価されます。アラート フィルターがデータと一致すると、Jira Service Management でそのアクションが実行されます。次に、その特定の Webhook の処理が終了します。一致するアクションが見つからなければ、何も起こりません。アラート フィルターで条件一致タイプが [Alerts that match at least condition (1 つ以上の条件に一致するアラート)] に設定されていて、受信データで [ステータス メッセージ] 変数が [失敗] または [まだ失敗] である場合、Jira Service Management ではアラート フィールドで指定された設定に従ってアラートが作成されます。処理はそこで終了します。ただし、[ステータス メッセージ] がこれら以外の受信データが Jira Service Management に届いた場合、[アラートを作成] アクションと照合されます。それが一致しない場合、[アラートをクローズ] の次のフィルターが処理されます。

Jira Service Management には、すべての統合に対してフィルターとアラート フィールドを事前に設定した既定のアクションが用意されています。ただし、編集、削除、独自のアクションの追加など、必要に応じてカスタマイズできます。

選択できる「条件一致」には 3 つのタイプがあります。

• All the alerts (no conditions in use) (すべてのアラート (使用条件なし)):統合アクションは評価されたすべてのデータと一致し、実行されます。条件を指定する必要はありません。

• 1 つ以上の条件に一致するアラート: 条件セットで指定された条件の 1 つでも受信データと一致すれば、Jira Service Management でそのアクションが実行されます。

• すべての条件に一致するアラート: Webhook データが、条件セットで指定されたすべての条件と一致する必要があります。いずれかが一致しない場合、アクションは実行されません。次の統合アクションがあれば、そのアクションの処理に進みます。

条件付きのいずれかのオプションを選択する場合は、評価する条件のリストを指定してください。

• 評価する特定の統合の Webhook データ内にある変数。

• 「Is」または「Is Not」の句

• 変数が準拠することが期待される機能操作。選択できる操作のセットは、変数のタイプに応じて変化します。

• 変数の値。

条件を追加する場合は [+ (条件を追加)] を選択し、条件を削除する場合は [X] アイコンを選択します。

条件操作

次に等しい: 文字列、ブール、数値変数の各タイプに適用されます。指定された変数の値と期待値が同じである場合に true を返します。

次を含む: 文字列、リスト、マップの各タイプに適用されます。指定された変数の値に期待される文字列が含まれている場合に true を返します。マップについては、期待値はキーまたは値フィールドで指定できます。

空である: 文字列、リスト、マップの各タイプに適用されます。指定された変数が空である場合に true を返します。文字列については文字数がチェックされ、リストとマップについてはサイズがチェックされます。

Matches (Regex) (一致 (正規表現)): 文字列、リスト、数値の各タイプに適用されます。

• 文字列タイプと数値タイプについては、指定された値が指定された正規表現と一致する場合に true を返します。

• リスト タイプについては、指定された値のいずれかが指定された正規表現と一致する場合に true を返します。

キーを含む: マップ タイプに適用されます。指定された変数に期待値がキーとして含まれている場合に true を返します。

値を含む: マップ タイプに適用されます。指定された変数に期待値が値として含まれている場合に true を返します。

次で始まる: 文字列タイプに適用されます。指定された変数が期待値で始まる場合に true を返します。

次で終わる: 文字列タイプに適用されます。指定された変数が期待値で終わる場合に true を返します。

次より大きい: 数値タイプに適用されます。指定された変数が期待値より大きい場合に true を返します。

次より小さい: 数値タイプに適用されます。指定された変数が期待値より小さい場合に true を返します。

Equals ignore whitespace (空白を無視に等しい): 文字列タイプに適用されます。指定された値と期待値の両方からすべての空白 (スペース、タブ、改行、復帰改行文字) を削除した後、指定された変数が期待値と等しい場合に true を返します。

アラート プロパティ

統合用に設定されたアクションについては、エイリアスを定義して、それと正確に一致した場合に限り、アクションが実行されます。エイリアスは、「オープン」アラートのユーザー定義の一意の ID です。重複除外にも使用されますが、エイリアス フィールドを空白のままにし、アクションが機能しなければ、統合を保存できません。