アラートの検索構文

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

下のテーブルは、アラートを検索するためのフィールド参照を表します。ほとんどのアラート・フィールドで、field:value の組み合わせを使用できます。

条件	説明
createdAt : 1470394841148	ミリ秒形式の UNIX タイムスタンプ。(1470394841148 -> Fri, 05 Aug 2016 11:00:41.148 GMT)
createdAt : 15-05-2020	DD-MM-YYYY の形式。
lastOccurredAt : 1470394841148	ミリ秒形式の UNIX タイムスタンプ。(1470394841148 -> Fri, 05 Aug 2016 11:00:41.148 GMT)
snoozedUntil : 1470394841148	ミリ秒形式の UNIX タイムスタンプ。(1470394841148 -> Fri, 05 Aug 2016 11:00:41.148 GMT)
alertId : b9a2fb13-1b76-4b41-be28-eed2c61978fa	アラートのID。
tinyId : 28	アラートに割り当てられている短い ID。このフィールドは変動するため、使用は推奨されないことに注意してください。
alias : host_down	取得するアラートのエイリアス。エイリアスを使用すると、そのエイリアスを持つオープンアラートのみが取得されます (存在する場合)。
count : 5	いずれかのソースが、指定されたエイリアスを持つオープンアラートがある場合に新しいアラートを作成しようとすると、新しいアラートを作成する代わりに、オープンアラートのカウント値が 1 増加します。
message : Server apollo average	文字列
description : Monitoring tool is reporting that the	文字列
source : john.smith@atlassian.com	文字列
entity : entity1	文字列
status : open	open \| closed
owner : john.smith@atlassian.com	担当者
acknowledgedBy : john.smith@atlassian.com	Jira Service Management ユーザー名
closedBy: john.smith@atlassian.com	Jira Service Management ユーザー名
recipients : john.smith@atlassian.com	Jira Service Management ユーザー名
isSeen : true	true \| false
acknowledged : true	true \| false
snoozed : false	true \| false
teams : team1	チームの名前。
integration.name : "API Integration"	インテグレーションの名前。
integration.type : API	インテグレーションのタイプ。
tag : EC2	文字列
actions : start	文字列
details.key : Impact	文字列
details.value : External	文字列
detailsPair(error : errormessage)	文字列

条件演算子

: 完全一致演算子に加えて、<、<=、>、および >= 演算子も使用できます。

例
count > 5
count <= 4
lastOccurredAt < 1470394841148

論理演算子

AND演算子とOR演算子を使用して、複数の値を組み合わせます。ただし、値は必ず括弧 () で囲んでください。

例	説明
message: (lorem OR ipsum)	"lorem" または "ipsum" を含む message フィールド
description: (lorem AND ipsum)	description フィールドには、"lorem" と "ipsum" の両方が含まれます。

AND演算子とOR演算子を使用して、複数の条件を組み合わせることもできます。

例
message: lorem AND count >= 3
message: (lorem OR ipsum) AND count >= 3
status: open AND (count >= 3 OR entity:lipsum) Expand

特定の値に対する検索結果を不適格にするには、NOT検索クエリを使用します。

例	説明
NOT message: lorem	message フィールドに lorem が含まれません。
NOT status: open	アラート結果の status が open ではありません (つまり、closed または resolved)

アスタリスク (*) をワイルドカードとして使用

ワイルドカードは文字の後にのみ使用でき、文字列の最初にのみ一致するものが検索されます。ワイルドカードで文字列ごとに一致するものを検索するには、文字列がスペースで区切られている必要があります。

例

たとえば、[アラートメッセージ] フィールドで「lorem」で始まることはわかっているが、メッセージの残りの部分は思い出せないアラートを検索する場合を考えます。

検索ボックスには、次のように入力します。

message: lorem*

これによって、[アラートメッセージ] フィールドで「lorem」で始まる文字列が検索され、一致した結果が一覧表示されます。

結果では、ワイルドカードが単独で文字列として表示される場合と、文字列の先頭部分になっている場合があります。

Lorem ipsum dolor
Loremipsum123
qui do Lorem ipsum

ただし、ワイルドカードが文字列の途中にある場合、検索は一致しません。

qui dolorem ipsum

つまり、ワイルドカードは文字列の先頭にあるか、アスタリスクで見つかる部分が区切られている必要があります。

ワイルドカードは、チームとユーザーではサポートされていません。つまり、チーム名またはユーザー名を使用してアラートを検索するときには、アスタリスク (*) を使用できません。正しい結果を得るには、チームまたはユーザーの名前全体を入力します。

Null クエリ

Null クエリを使用して、フィールドを含む、またはフィールドを含まないアラートをリストできます。フィールドが設定されていない場合、または空白の場合、そのフィールドは null と見なされることに注意してください。

NULL クエリがサポートするフィールドには、source、entity、tag、actions、owner、teams、acknowledgedBy、closedBy、recipients、details.key、details.value、integration.name、integration.type があります。

例
owner : null
teams is null
details.key is not null
tag !: null

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問