Zabbix Documentation 4.4

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

ru:manual:config:items:item:key

1 Формат ключа элемента данных

Следуйте правилам синтаксиса в формате ключа элемента данных, включая параметры ключа. На рисунках изображен поддерживаемый синтаксис. Допустимые элементы и символы в каждой позиции можно определить следуя линиям - если в каком то блоке может быть достигнута линия, в таком случае разрешено, если линия не может быть достигнута - тогда не разрешено.

Для построения правильного ключа элемента данных, вы должны начать с указания имени ключа, то есть выбрать имеет ли ключ параметры или нет - о чем свидетельствуют две линии, которые вы можете достичь.

Имя ключа

Имя ключа имеет ограниченный диапазон разрешенных символов, которые просто следуют друг за другом. Разрешенные символы:

0-9a-zA-Z_-.

Что означает:

  • все цифры;
  • все буквы в нижнем регистре;
  • все буквы в верхнем регистре;
  • подчеркивание;
  • дефис;
  • точка.

Параметры ключа

Ключ элемента данных может принимать множество параметров, которые должны быть разделены запятой.

Каждый параметр ключа может быть одним из: строка заключенная в кавычки, строка без кавычек, массив.

Параметр можно оставить пустым и тогда будет использоваться значение по умолчанию. В этом случае Вы должны добавить соответствующее количество запятых, если какой-то из дальнейших параметров все же нужно задать. Например, ключ элемента данных icmpping[,,200,,500] будет указывать на то, что период проверки ping 200 миллисекунд, время ожидания - 500 миллисекунд, а все остальные параметры будут заполнены значениями по умолчанию.

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

Если параметр ключа это строка, заключенная в кавычки, тогда разрешен любой символ в Юникоде, и если требуется включение двойных кавычек, то они должны быть экранированы обратной наклонной чертой.

Чтобы заключить параметры ключа элемента данных в кавычки, используйте только двойные кавычки. Одинарные кавычки не поддерживаются.

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

Если параметр ключа это строка без кавычек, тогда разрешен любой символ в Юникоде, за исключением запятой и правой квадратной скобки (]). Параметр, который не заключен в кавычки, не может начинаться с левой квадратной скобки ([).

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

Если параметр ключа это массив, тогда он должен быть заключен в квадратные скобки, в которых каждый индивидуальный параметр следует один за другим, согласно правилам и синтаксису.

Многоуровневые массивы параметров, например [a,[b,[c,d]],e], недопускаются.