7 単位記号

概要

86400、104857600、1000000 のような大きな値を扱うのは難しく、エラーの原因になることがあります。 設定を簡素化し、可読性を向上させるために、Zabbix は値の乗数として機能する単位記号(接尾辞)をサポートしています。

接尾辞なしのトリガー式:

last(/host/system.uptime)<86400
avg(/host/system.cpu.load,600s)<10
last(/host/vm.memory.size[available])<20971520

接尾辞ありのトリガー式:

last(/host/system.uptime)<1d
avg(/host/system.cpu.load,10m)<10
last(/host/vm.memory.size[available])<20M

接尾辞は、アイテム、ウィジェットなど、他のエンティティの設定を簡素化するためにも使用でき、アイテムの値を人間にとって読みやすい形式で表示するのにも役立ちます。

エンティティの設定フィールドが接尾辞をサポートしているかどうかを確認するには、必ず設定対象のエンティティに対応するページを参照してください。

時間のサフィックス

Zabbix Webインターフェースは、エンティティ設定で以下の時間サフィックスをサポートしています。

  • s - 秒 (使用した場合、生の値と同じように機能します)
  • m - 分
  • h - 時間
  • d - 日
  • w - 週
  • M - か月 (trend functions のみ)
  • y - 年 (trend functions のみ)

時間サフィックスは整数値でのみサポートされています。
例えば、1h はサポートされていますが、1,5h や 1.5h はサポートされていません。代わりに 90m を使用してください。

メモリサイズの接尾辞

Zabbixは、以下のメモリサイズの接尾辞をサポートしています。

  • K - キロバイト
  • M - メガバイト
  • G - ギガバイト
  • T - テラバイト

アイテム値のサフィックス

サフィックスは、数値のアイテム値を人間にとって読みやすい形式で表示するためにも使用できます。

これを有効にするには、アイテムの設定時に、Units フィールドで以下のいずれかのサフィックスを使用します。

  • B - バイト
  • Bps - 1秒あたりのバイト数
  • s - 秒。最大3つまでの最も大きい非ゼロの時間単位を使用して表示
  • uptime - hh:mm:ss または N days, hh:mm:ss 形式の経過時間
  • unixtime - Unixタイムスタンプ。yyyy.mm.dd hh:mm:ss 形式で表示

これらのサフィックスの解釈および表示方法には、以下の追加ルールが適用されます。

  • B および Bps については、Zabbix は JEDEC 標準に従い、2進数ベースの変換を使用します(1K = 1024B)。
  • その他の単位(Hz、W など)については、Zabbix は10進数ベースの変換を使用します(1K = 1000)。
  • s(秒)について:
    • 形式には yyy mmm ddd hhh mmm sss ms が含まれ、最大3つまでの最も大きい非ゼロの時間単位のみが表示されます(例: 1M 10d 4h)。
    • ある単位がゼロで、かつ2つの非ゼロ単位の間にある場合は省略されます(例: 10d 0h 56m ではなく 10d 56m)。

Units を使用すると、以下の乗数サフィックスがアイテム値に自動的に適用されます。

  • K, M, G, T - キロ、メガ、ギガ、テラ
  • P, E, Z, Y - ペタ、エクサ、ゼタ、ヨタ (これらはWebインターフェースでのみ適用されます)

単位変換を防ぐには、! プレフィックスを使用します(例: !B または !s)。

以下の例は、受信したアイテム値が指定された単位に基づいてどのように変換されるかを示しています。

1 B → 1 B
1024 B → 1 KB
1536 B → 1.5 KB
881764 B → 881.76 KB
881764 !B → 881764 B

0.0000155 s → 0.016ms
3470400 s → 1M 10d 4h
2606400 s → 1M 4h
2592000 s → 1M
2592001 s → 1M
2592001 !s → 2592001 s

17764 uptime → 04:56:04
86400 uptime → 1 day, 00:00:00
881764 uptime → 10 days, 04:56:04
32417764 uptime → 375 days, 04:56:04
32417764 !uptime → 32417764 uptime

881764 unixtime → 1970-01-11 04:56:04 AM

17764 Hz → 17.76 KHz
86400 Hz → 86.4 KHz
881764 Hz → 881.76 KHz
32417764 Hz → 32.42 MHz

0 ! → 0
0 !! → 0 !

Zabbix 4.0 より前は、msrpmRPM% からなるハードコードされた単位の停止リストがありました。 この停止リストは非推奨となったため、このような単位の変換を防ぐ正しい方法は !ms!rpm!RPM!% です。