Zabbix Documentation 3.4

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


ru:manual:appendix:items:activepassive

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
ru:manual:appendix:items:activepassive [2015/12/25 12:06]
dotneft created
ru:manual:appendix:items:activepassive [2018/07/10 08:58] (current)
dotneft
Line 3: Line 3:
 === Обзор === === Обзор ===
  
-Этот раздел описывает детали пассивных и активных проверок,​ которые выполняются Zabbix агентом.+Этот раздел описывает детали пассивных и активных проверок,​ которые выполняются ​[[ru:​manual:​config:​items:​itemtypes:​zabbix_agent|Zabbix агентом]].
  
 Zabbix использует протокол на основе JSON для взаимодействия с Zabbix агентом. Zabbix использует протокол на основе JSON для взаимодействия с Zabbix агентом.
  
-Имеется несколько определений используемых в параметрах ​протокола,​ используемом ​в Zabbix: +Для получения более подробных ​сведений об определении длины заголовка и данных, пожалуйста, ​обратитесь ​к [[ru:​manual:​appendix:​protocols:​header_datalen|деталям ​протокола]].
- +
-<​code>​ +
-<​HEADER>​ - "​ZBXD\x01"​ (5 байт) +
-<​DATALEN>​ - размер данных (8 байт). число 1 отформатируется в 01/​00/​00/​00/​00/​00/​00/​00 (восемь байт в HEX, 64-битное число) +
-</​code>​ +
- +
-Чтобы не израсходовать память полностью (в теории) Zabbix сервер ограничен на прием ​данных ​только 128МБ за одно соединение при использовании Zabbix ​протокола.+
  
 === Пассивные проверки === === Пассивные проверки ===
Line 26: Line 19:
 **Ответ агента** **Ответ агента**
  
-<​code><​HEADER><DATALEN><DATA>[\0<ERROR>​]</​code>​+<​code><​ЗАГОЛОВОК><ДЛИНАДАННЫХ><ДАННЫЕ>[\0<ОШИБКА>​]</​code>​
  
 Часть в квадратных скобках выше опциональна и отправляется только по неподдерживаемым элементам данных. Часть в квадратных скобках выше опциональна и отправляется только по неподдерживаемым элементам данных.
Line 34: Line 27:
   - Сервер открывает TCP соединение   - Сервер открывает TCP соединение
   - Сервер отправляет **agent.ping\n**   - Сервер отправляет **agent.ping\n**
-  - Агент читает запрос и отвечает с **<HEADER><DATALEN>1**+  - Агент читает запрос и отвечает с **<ЗАГОЛОВОК><ДЛИНАДАННЫХ>1**
   - Сервер обрабатывает данные,​ чтобы извлечь значение,​ в нашем случае 1   - Сервер обрабатывает данные,​ чтобы извлечь значение,​ в нашем случае 1
   - TCP соединение закрывается   - TCP соединение закрывается
Line 43: Line 36:
   - Сервер открывает TCP соединение   - Сервер открывает TCP соединение
   - Сервер отправляет **vfs.fs.size[/​nono]\n**   - Сервер отправляет **vfs.fs.size[/​nono]\n**
-  - Agent читает запрос и отвечает с **<HEADER><DATALEN>​ZBX_NOTSUPPORTED\0Cannot obtain filesystem information:​ [2] No such file or directory**+  - Agent читает запрос и отвечает с **<ЗАГОЛОВОК><ДЛИНАДАННЫХ>​ZBX_NOTSUPPORTED\0Cannot obtain filesystem information:​ [2] No such file or directory**
   - Сервер обрабатывает данные,​ меняет состояние элемента данных на неподдерживаемое с указанным сообщением об ошибке   - Сервер обрабатывает данные,​ меняет состояние элемента данных на неподдерживаемое с указанным сообщением об ошибке
   - TCP соединение закрывается   - TCP соединение закрывается
Line 61: Line 54:
  
 <​code>​ <​code>​
-<HEADER><DATALEN>{+<ЗАГОЛОВОК><ДЛИНАДАННЫХ>{
    "​request":"​active checks",​    "​request":"​active checks",​
    "​host":"<​имя хоста>"​    "​host":"<​имя хоста>"​
Line 70: Line 63:
  
 <​code>​ <​code>​
-<HEADER><DATALEN>{+<ЗАГОЛОВОК><ДЛИНАДАННЫХ>{
     "​response":"​success",​     "​response":"​success",​
     "​data":​[     "​data":​[
Line 95: Line 88:
 </​code>​ </​code>​
  
-Сервер должен ответить положительно. У каждого полученного элемента данных обязательно должны быть указаны параметры **key**, **lastlogsize** и **delay**, независимо от того элемент данных является журнальным или нет.+Сервер должен ответить положительно. У каждого полученного элемента данных обязательно должны быть указаны параметры **key**, **delay**, **lastlogsize** и **mtime**, независимо от того элемент данных является журнальным или нет.
  
 Например:​ Например:​
Line 106: Line 99:
   - Агент начинает периодический сбор данных   - Агент начинает периодический сбор данных
  
-<note important>​Возьмите на заметку,​ что (чувствительные) данные конфигурации могут стать доступными лицам, имеющим доступ к порту траппера Zabbix сервера,​ когда используются активные проверки. Это возможно так как любой может претендовать на возможность быть активным агентом и запросить данные конфигурации элементов данных;​ аутентификация не производится.</​note>​+<note important>​Возьмите на заметку,​ что (чувствительные) данные конфигурации могут стать доступными лицам, имеющим доступ к порту траппера Zabbix сервера,​ когда используются активные проверки. Это возможно так как любой может претендовать на возможность быть активным агентом и запросить данные конфигурации элементов данных;​ аутентификация не производится, если вы не используете опции [[:​ru/​manual/​encryption|шифрования]].</​note>​
  
 == Отправка собранных данных == == Отправка собранных данных ==
Line 113: Line 106:
  
 <​code>​ <​code>​
-<HEADER><DATALEN>{+<ЗАГОЛОВОК><ДЛИНАДАННЫХ>{
     "​request":"​agent data",     "​request":"​agent data",
     "​data":​[     "​data":​[
Line 148: Line 141:
  
 <​code>​ <​code>​
-<HEADER><DATALEN>{+<ЗАГОЛОВОК><ДЛИНАДАННЫХ>{
     "​response":"​success",​     "​response":"​success",​
     "​info":"​processed:​ 3; failed: 0; total: 3; seconds spent: 0.003534"​     "​info":"​processed:​ 3; failed: 0; total: 3; seconds spent: 0.003534"​
Line 165: Line 158:
 Обратите внимание на то, как в примере выше указывается неподдерживаемое состояние для vfs.fs.size[/​nono] при помощи значения "​state"​ равного 1 и сообщения об ошибке в свойстве "​value"​. Обратите внимание на то, как в примере выше указывается неподдерживаемое состояние для vfs.fs.size[/​nono] при помощи значения "​state"​ равного 1 и сообщения об ошибке в свойстве "​value"​.
  
-<note important>​Сообщение об ошибке будет ​усечено до 2048 символов на стороне сервера.</​note>​+<note important>​Сообщение об ошибке будет ​обрезано до 2048 символов на стороне сервера.</​note>​
  
 === Более старый XML протокол === === Более старый XML протокол ===
Line 173: Line 166:
 === Смотрите также === === Смотрите также ===
  
-  - [[https://​​www.zabbix.org/​​wiki/​​Docs/​​protocols/​​zabbix_agent/​​2.2| Подробные сведения о протоколе Zabbix агента]]+  - [[https://​​www.zabbix.org/​​wiki/​​Docs/​​protocols/​​zabbix_agent/​​3.4| Подробные сведения о протоколе Zabbix агента]]