Zabbix Documentation 3.4

3.04.04.45.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


manual:config:items:userparameters

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:items:userparameters [2015/11/23 06:38]
martins-v link to command execution page
manual:config:items:userparameters [2018/01/25 12:57] (current)
martins-v text value that can be eventually stored in database is limited to 64KB on MySQL
Line 1: Line 1:
-==== - #4 User parameters ====+==== 4 User parameters ====
  
 === Overview === === Overview ===
Line 15: Line 15:
 Then, when [[item|configuring an item]], enter the key to reference the command from the user parameter you want executed. Then, when [[item|configuring an item]], enter the key to reference the command from the user parameter you want executed.
  
-User parameters are commands executed by Zabbix agent. Up to 512KB of data can be returned. **/bin/sh** is used as a command line interpreter under UNIX operating systems. User parameters obey the agent check timeout; if timeout is reached the forked user parameter process is terminated.+User parameters are commands executed by Zabbix agent. Up to 512KB of data can be returned ​before item preprocessing stepsNote, however, that the text value that can be eventually stored in database is limited to 64KB on MySQL (see info on other databases in the [[:​manual/​config/​notifications/​action/​operation/​remote_command#​overview|table]]).  
 + 
 +**/bin/sh** is used as a command line interpreter under UNIX operating systems. User parameters obey the agent check timeout; if timeout is reached the forked user parameter process is terminated.
  
 See also: See also:
Line 85: Line 87:
 === Command result === === Command result ===
  
-The return value of the command is standard output together with standard error.+The return value of the command is standard output together with standard error. ​
  
 <note important>​A text (character, log or text type of information) item will not become unsupported in case of standard error output.</​note>​ <note important>​A text (character, log or text type of information) item will not become unsupported in case of standard error output.</​note>​
  
-User parameters ​that return text (character, log, text type of information) can return whitespaceIn case of invalid ​result item will become unsupported.+The exit code is not checked. 
 + 
 +Note that in Zabbix versions 3.4.0-3.4.2 the exit code is checked for execution ​result. In these versions, the item will become unsupported ​if the execution exit code does not match 0 (zero).
  
 +User parameters that return text (character, log, text type of information) can return whitespace. In case of invalid result the item will become unsupported.