1 # This is a configuration file for Zabbix agent daemon (Unix)
2 # To get more information about Zabbix, visit http://www.zabbix.com
4 ############ GENERAL PARAMETERS #################
11 # PidFile=/tmp/zabbix_agentd.pid
13 PidFile=/var/run/zabbix/zabbix_agentd.pid
16 # Specifies where log messages are written to:
18 # file - file specified with LogFile parameter
19 # console - standard output
26 # Log file name for LogType 'file' parameter.
28 # Mandatory: yes, if LogType is set to file, otherwise no
32 LogFile=/var/log/zabbix/zabbix_agentd.log
34 ### Option: LogFileSize
35 # Maximum size of log file in MB.
36 # 0 - disable automatic log rotation.
45 ### Option: DebugLevel
46 # Specifies debug level:
47 # 0 - basic information about starting and stopping of Zabbix processes
48 # 1 - critical information
49 # 2 - error information
51 # 4 - for debugging (produces lots of information)
52 # 5 - extended debugging (produces even more information)
60 # Source IP address for outgoing connections.
66 ### Option: EnableRemoteCommands
67 # Whether remote commands from Zabbix server are allowed.
73 # EnableRemoteCommands=0
75 ### Option: LogRemoteCommands
76 # Enable logging of executed shell commands as warnings.
84 ##### Passive checks related
87 # List of comma delimited IP addresses, optionally in CIDR notation, or DNS names of Zabbix servers and Zabbix proxies.
88 # Incoming connections will be accepted only from the hosts listed here.
89 # If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally
90 # and '::/0' will allow any IPv4 or IPv6 address.
91 # '0.0.0.0/0' can be used to allow any IPv4 address.
92 # Example: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
94 # Mandatory: yes, if StartAgents is not explicitly set to 0
100 ### Option: ListenPort
101 # Agent will listen on this port for connections from the server.
109 # List of comma delimited IP addresses that the agent should listen on.
110 # First IP address is sent to Zabbix server if connecting to it to retrieve list of active checks.
116 ### Option: StartAgents
117 # Number of pre-forked instances of zabbix_agentd that process passive checks.
118 # If set to 0, disables passive checks and the agent will not listen on any TCP port.
125 ##### Active checks related
127 ### Option: ServerActive
128 # List of comma delimited IP:port (or DNS name:port) pairs of Zabbix servers and Zabbix proxies for active checks.
129 # If port is not specified, default port is used.
130 # IPv6 addresses must be enclosed in square brackets if port for that host is specified.
131 # If port is not specified, square brackets for IPv6 addresses are optional.
132 # If this parameter is not specified, active checks are disabled.
133 # Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
139 ServerActive=127.0.0.1
142 # Unique, case sensitive hostname.
143 # Required for active checks and must match hostname as configured on the server.
144 # Value is acquired from HostnameItem if undefined.
150 ### Option: HostnameItem
151 # Item used for generating Hostname if it is undefined. Ignored if Hostname is defined.
152 # Does not support UserParameters or aliases.
156 # HostnameItem=system.hostname
158 ### Option: HostMetadata
159 # Optional parameter that defines host metadata.
160 # Host metadata is used at host auto-registration process.
161 # An agent will issue an error and not start if the value is over limit of 255 characters.
162 # If not defined, value will be acquired from HostMetadataItem.
165 # Range: 0-255 characters
169 ### Option: HostMetadataItem
170 # Optional parameter that defines an item used for getting host metadata.
171 # Host metadata is used at host auto-registration process.
172 # During an auto-registration request an agent will log a warning message if
173 # the value returned by specified item is over limit of 255 characters.
174 # This option is only used when HostMetadata is not defined.
180 ### Option: RefreshActiveChecks
181 # How often list of active checks is refreshed, in seconds.
186 # RefreshActiveChecks=120
188 ### Option: BufferSend
189 # Do not keep data longer than N seconds in buffer.
196 ### Option: BufferSize
197 # Maximum number of values in a memory buffer. The agent will send
198 # all collected data to Zabbix Server or Proxy if the buffer is full.
205 ### Option: MaxLinesPerSecond
206 # Maximum number of new lines the agent will send per second to Zabbix Server
207 # or Proxy processing 'log' and 'logrt' active checks.
208 # The provided value will be overridden by the parameter 'maxlines',
209 # provided in 'log' or 'logrt' item keys.
214 # MaxLinesPerSecond=20
216 ############ ADVANCED PARAMETERS #################
219 # Sets an alias for an item key. It can be used to substitute long and complex item key with a smaller and simpler one.
220 # Multiple Alias parameters may be present. Multiple parameters with the same Alias key are not allowed.
221 # Different Alias keys may reference the same item key.
222 # For example, to retrieve the ID of user 'zabbix':
223 # Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,^zabbix:.:([0-9]+),,,,\1]
224 # Now shorthand key zabbix.userid may be used to retrieve data.
225 # Aliases can be used in HostMetadataItem but not in HostnameItem parameters.
232 # Spend no more than Timeout seconds on processing
239 ### Option: AllowRoot
240 # Allow the agent to run as 'root'. If disabled and the agent is started by 'root', the agent
241 # will try to switch to the user specified by the User configuration option instead.
242 # Has no effect if started under a regular user.
251 # Drop privileges to a specific, existing user on the system.
252 # Only has effect if run as 'root' and AllowRoot is disabled.
259 # You may include individual files or all files in a directory in the configuration file.
260 # Installing Zabbix will create include directory in /usr/local/etc, unless modified during the compile time.
266 Include=/etc/zabbix_agentd/zabbix_agentd.d/*.conf
269 ####### USER-DEFINED MONITORED PARAMETERS #######
271 ### Option: UnsafeUserParameters
272 # Allow all characters to be passed in arguments to user-defined parameters.
273 # The following characters are not allowed:
274 # \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
275 # Additionally, newline characters are not allowed.
282 # UnsafeUserParameters=0
284 ### Option: UserParameter
285 # User-defined parameter to monitor. There can be several user-defined parameters.
286 # Format: UserParameter=<key>,<shell command>
287 # See 'zabbix_agentd' directory for examples.
293 ####### LOADABLE MODULES #######
295 ### Option: LoadModulePath
296 # Full path to location of agent modules.
297 # Default depends on compilation options.
298 # To see the default path run command "zabbix_agentd --help".
302 # LoadModulePath=/usr/lib/modules
304 LoadModulePath=/usr/lib/zabbix
306 ### Option: LoadModule
307 # Module to load at agent startup. Modules are used to extend functionality of the agent.
309 # LoadModule=<module.so>
310 # LoadModule=<path/module.so>
311 # LoadModule=</abs_path/module.so>
312 # Either the module must be located in directory specified by LoadModulePath or the path must precede the module name.
313 # If the preceding path is absolute (starts with '/') then LoadModulePath is ignored.
314 # It is allowed to include multiple LoadModule parameters.
320 ####### TLS-RELATED PARAMETERS #######
322 ### Option: TLSConnect
323 # How the agent should connect to server or proxy. Used for active checks.
324 # Only one value can be specified:
325 # unencrypted - connect without encryption
326 # psk - connect using TLS and a pre-shared key
327 # cert - connect using TLS and a certificate
329 # Mandatory: yes, if TLS certificate or PSK parameters are defined (even for 'unencrypted' connection)
331 # TLSConnect=unencrypted
333 ### Option: TLSAccept
334 # What incoming connections to accept.
335 # Multiple values can be specified, separated by comma:
336 # unencrypted - accept connections without encryption
337 # psk - accept connections secured with TLS and a pre-shared key
338 # cert - accept connections secured with TLS and a certificate
340 # Mandatory: yes, if TLS certificate or PSK parameters are defined (even for 'unencrypted' connection)
342 # TLSAccept=unencrypted
344 ### Option: TLSCAFile
345 # Full pathname of a file containing the top-level CA(s) certificates for
346 # peer certificate verification.
352 ### Option: TLSCRLFile
353 # Full pathname of a file containing revoked certificates.
359 ### Option: TLSServerCertIssuer
360 # Allowed server certificate issuer.
364 # TLSServerCertIssuer=
366 ### Option: TLSServerCertSubject
367 # Allowed server certificate subject.
371 # TLSServerCertSubject=
373 ### Option: TLSCertFile
374 # Full pathname of a file containing the agent certificate or certificate chain.
380 ### Option: TLSKeyFile
381 # Full pathname of a file containing the agent private key.
387 ### Option: TLSPSKIdentity
388 # Unique, case sensitive string used to identify the pre-shared key.
394 ### Option: TLSPSKFile
395 # Full pathname of a file containing the pre-shared key.