Формат ключа

Ключ элемента должен быть оформлен в соответствии с синтаксическими правилами. Ниже приведены примеры допустимого синтаксиса (Рисунок 1).

Рисунок 1 — Схема ключа

На схеме показаны разрешённые элементы и символы в каждой позиции. Если можно добраться до блока по линии, это разрешено, если нет — запрещено. Чтобы создать корректный ключ элемента, необходимо указать имя ключа. Затем нужно выбрать, будут ли у ключа параметры или нет. Это можно сделать, следуя двум строкам на схеме.

Название и ключевые параметры ключа

Формат ключа элемента данных в Zabbix включает в себя несколько ключевых компонентов:

Имя ключа. Ограниченный набор разрешённых символов: 0-9, a-zA-Z, _-. Это означает, что в имени ключа могут использоваться все цифры, буквы в нижнем и верхнем регистре, а также подчёркивания, дефисы и точки.
Параметры ключа. Они могут быть разделены запятой. Каждый параметр ключа может быть представлен в трёх вариантах: заключённая в кавычки строка, строка без кавычек или массив. Параметр можно оставить пустым, и тогда будет использоваться значение по умолчанию.

Например, ключ элемента данных icmppping[,,200,,500] будет означать, что период проверки ping составляет 200 миллисекунд, время ожидания — 500 миллисекунд, а остальные параметры будут заполнены значениями по умолчанию.

Параметр — строка, заключенная в кавычки

В случае, если в качестве ключевого параметра выступает строка, заключённая в кавычки, допустимо использовать любой символ из набора символов Unicode (Рисунок 2).

net.tcp.service[http,"{HOST.CONN}","{$APACHE.STATUS.PORT}"]
jmx["kafka.server:type=BrokerTopicMetrics,name=BytesInPerSec","Count"]
cisco.ucs.if.out[ifHCOutOctets.{#SNMPINDEX}]

Рисунок 2 — Схема строки с кавычками

Параметр — строка без кавычек

В случае, если в качестве основного параметра выступает строка без кавычек, можно использовать любой символ из набора Unicode, за исключением запятой и правой квадратной скобки (]). Важно отметить, что строка без кавычек не может начинаться с левой квадратной скобки (Рисунок 3).

system.cpu.util[,iowait]

Рисунок 3 — Схема без кавычек

Параметр — массив

В случае, если основным элементом является массив, он опять обрамляется квадратными скобками, а каждый элемент в нём соответствует правилам и синтаксису указания нескольких значений (Рисунок 4).

zabbix[host,agent,available]
net.tcp.service[http,"{$APACHE.STATUS.HOST}","{$APACHE.STATUS.PORT}"]
vmware.hv.network.out[{$VMWARE.URL},{$VMWARE.HV.UUID},bps]

item_key [значение1, значение2, ...]`

В этом примере item_key - это имя ключа элемента данных, а [значение1, значение2, ...] - это массив значений параметров, заключённый в квадратные скобки. Значения в массиве разделяются запятыми. Важно отметить, что многоуровневые массивы параметров, такие как [a,[b,[c,d]],e], не поддерживаются.

Рисунок 4 — Схема массива