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 - 月 (トレンド関数のみ);
y - 年 (トレンド関数のみ)。
時間サフィックスは整数値に対してのみサポートされます。 たとえば、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)。
- 単位が0で、かつ2つの非ゼロ単位の間にある場合は省略されます (例: 10d 0h 56m ではなく 10d 56m)。
Units を使用すると、次の倍率サフィックスがアイテム値に自動的に適用されます:
K, M, G, T - kilo, mega, giga, tera;
P, E, Z, Y - peta, exa, zetta, yotta (これらは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 より前は、ms、rpm、RPM、% からなるハードコードされた単位の停止リストがありました。
この停止リストは非推奨となっているため、そのような単位の変換を防ぐ正しい方法は !ms、!rpm、!RPM、!% です。