エンティティには、同じタグ名で異なるタグ値を持つタグを付けることができます（例: component:memory と component:storage）。同様に、エンティティには値のないタグと、同じ名前で値のあるタグを付けることもできます（例: database と database:postgresql）。このようなタグは重複とは見なされません。

ユースケース

タグ付けの一般的なユースケースは次のとおりです。

トリガーイベントを識別する:
- トリガーのタグを定義します（例: scope:performance）。
- このトリガーによって作成された障害には、そのトリガーのタグが付きます。
テンプレート継承された障害を識別する:
- テンプレートのタグを定義します（例: target:mysql）。
- このテンプレートのトリガーによって作成された障害には、そのテンプレートのタグが付きます。
ホストの障害を識別する:
- ホストのタグを定義します（例: service:jira）。
- このホストのトリガーによって作成された障害には、そのホストのタグが付きます。
関連するアイテムをフィルタリングする:
- アイテムのタグを定義します（例: component:cpu）。
- 監視 → 最新データ では、アイテムを component:cpu タグでフィルタリングできます。
アイテム値から抽出した情報をタグ値として使用する:
- タグ値としてマクロを含むタグを定義します（例: tag-name:{{ITEM.VALUE<N>}.regsub()} ）。
- 監視 → 障害では、障害のタグ値はアイテム値から抽出されたデータに解決されます。
ログファイル内の障害を識別し、それぞれ個別にクローズする:
- ログ監視アイテムのトリガーに対して、マクロを使用してアイテム値から値を抽出するトリガーのタグを定義します（例: service:{{ITEM.VALUE<N>}.regsub()} ）。
- トリガー設定で、イベント相関関係を設定します:
  - 障害イベント生成モード を「複数」に設定します。
  - OKイベントでクローズ を「タグ値が一致する場合はすべての障害」に設定します。
  - 一致に使用するタグを設定します。
- ログアイテムのトリガーによって作成された障害にはそのトリガーのタグが付き、個別にクローズされます。
通知をフィルタリングする:
- トリガーのタグを定義します（例: trigger1 には scope:security、trigger2 には scope:availability）。
- アクション条件でタグフィルタリングを使用し、タグデータに一致するイベントの通知のみを受信します。
通知内で障害を識別する:
- トリガーのタグを定義します。
- 障害通知で {EVENT.TAGS} マクロを使用します。
- 障害通知にはトリガーのタグが含まれるため、その通知がどのアプリケーション/サービスに属するかを容易に識別できます。
テンプレートタグを使用して設定作業を簡素化する:
- テンプレートのトリガーのタグを定義します。
- このテンプレートトリガーから作成されたトリガーには、そのタグが付きます。
ローレベルディスカバリ（LLD）からタグ付きトリガーを作成する:
- タグ名またはタグ値にLLDマクロを含むトリガープロトタイプのタグを定義します（例: scope:{#FSNAME}）。
- このトリガープロトタイプから作成されたトリガーには、そのタグが付きます。
サービスタグを使用してサービスを照合する:
- サービスタグを定義します。
- 一致するタグを持つサービスに対してサービスアクションを設定します。
- さらに、SLA計算のために、サービスタグを使用してサービスを SLA に関連付けます。
サービス障害タグを使用してサービスを障害に関連付ける:
- サービス設定で障害タグを定義します（例: target:mysql）。
- 一致するタグを持つ障害は自動的にそのサービスに相関付けられ、設定されたサービスステータス計算ルールに基づいてサービスステータスが変化します。
ホストがメンテナンスモードのときに障害を抑制する:
- メンテナンス期間の設定でタグを定義します。
- 定義されたタグを持つ障害は抑制されます。
ユーザーグループにアクセス権を付与する:
- ユーザーグループ設定でタグを定義します。
- そのユーザーグループのユーザーは、定義されたタグを持つ障害のみを表示できます。

設定

タグは専用のタブで定義できます。たとえば、トリガーの設定です。

マクロのサポート

タグ内の組み込みマクロおよびユーザーマクロは、イベント発生時に展開されます。イベントが発生するまでは、これらのマクロは Zabbix Webインターフェースで未展開のまま表示されます。

ローレベルディスカバリマクロは、ディスカバリ処理中に展開されます。

以下のマクロは、トリガーのタグ名および値で使用できます。

{ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT}, および {HOST.ID} の組み込みマクロ
{INVENTORY.*} の組み込みマクロ（トリガー式内の1つまたは複数のホストからホストインベントリ値を参照するため）
ユーザーマクロおよびコンテキスト付きユーザーマクロ（コンテキストにはローレベルディスカバリマクロを含めることができます）
ローレベルディスカバリマクロ（トリガープロトタイプのタグ内のみ）

以下のマクロは、テンプレート、ホスト、アイテム/Webシナリオのタグ名および値で使用できます。

{HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT}, および {HOST.ID} の組み込みマクロ
{INVENTORY.*} の組み込みマクロ
ユーザーマクロ
ローレベルディスカバリマクロ（ホストプロトタイプおよびアイテムプロトタイプのタグ内のみ）

以下のマクロは、トリガーベースの通知で使用できます。

{EVENT.TAGS} および {EVENT.RECOVERY.TAGS} の組み込みマクロ（これらのマクロは、イベントタグまたは復旧イベントタグのカンマ区切りリストに展開されます）
{EVENT.TAGSJSON} および {EVENT.RECOVERY.TAGSJSON} の組み込みマクロ（これらのマクロは、イベントタグオブジェクトまたは復旧イベントタグオブジェクトを含む JSON 配列に展開されます）

トリガータグでの部分文字列抽出

タグ名またはタグ値の設定では、マクロ関数を使用した部分文字列抽出がサポートされています。この関数は、サポートされているマクロによって取得された値に正規表現を適用します。例えば、次のようになります。

{{ITEM.VALUE}.regsub(pattern, output)}
{{ITEM.VALUE}.iregsub(pattern, output)}

{{#LLDMACRO}.regsub(pattern, output)}
{{#LLDMACRO}.iregsub(pattern, output)}

マクロ解決後のタグ名またはタグ値が255文字を超える場合、255文字に切り詰められます。

関連情報: イベントタグ付けのためのローレベルディスカバリマクロでのマクロ関数の使用も参照してください。

イベントタグの表示

タグが定義されている場合、新しいイベントで次の場所に表示できます。

監視 → 障害
監視 → 障害 → イベントの詳細
ダッシュボード → 障害ウィジェット

表示されるタグの順序と数は、監視 → 障害または障害ダッシュボードウィジェットの タグ表示優先度 および タグの表示 フィルタリングオプションによって決まります。
表示できるタグは最大3つまでであることに注意してください。タグがそれより多い場合は、3つのドットにマウスオーバーすると、ポップアップウィンドウですべてのタグが表示されます。

What’s next?

7 視覚化

Docs

6 タグ付け

概要

ユースケース

設定

マクロのサポート

トリガータグでの部分文字列抽出

イベントタグの表示

What’s next?

Suggest edit

Suggest an example

Thank you!