config/zabbix_agentd/zabbix_agentd.conf

   1 # This is a configuration file for Zabbix agent daemon (Unix)
   2 # To get more information about Zabbix, visit http://www.zabbix.com
   3
   4 ############ GENERAL PARAMETERS #################
   5
   6 ### Option: PidFile
   7 #       Name of PID file.
   8 #
   9 # Mandatory: no
  10 # Default:
  11 # PidFile=/tmp/zabbix_agentd.pid
  12
  13 PidFile=/var/run/zabbix/zabbix_agentd.pid
  14
  15 ### Option: LogType
  16 #       Specifies where log messages are written to:
  17 #               system  - syslog
  18 #               file    - file specified with LogFile parameter
  19 #               console - standard output
  20 #
  21 # Mandatory: no
  22 # Default:
  23 # LogType=file
  24
  25 ### Option: LogFile
  26 #       Log file name for LogType 'file' parameter.
  27 #
  28 # Mandatory: yes, if LogType is set to file, otherwise no
  29 # Default:
  30 # LogFile=
  31
  32 LogFile=/var/log/zabbix/zabbix_agentd.log
  33
  34 ### Option: LogFileSize
  35 #       Maximum size of log file in MB.
  36 #       0 - disable automatic log rotation.
  37 #
  38 # Mandatory: no
  39 # Range: 0-1024
  40 # Default:
  41 # LogFileSize=1
  42
  43 LogFileSize=0
  44
  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
  50 #       3 - warnings
  51 #       4 - for debugging (produces lots of information)
  52 #       5 - extended debugging (produces even more information)
  53 #
  54 # Mandatory: no
  55 # Range: 0-5
  56 # Default:
  57 # DebugLevel=3
  58
  59 ### Option: SourceIP
  60 #       Source IP address for outgoing connections.
  61 #
  62 # Mandatory: no
  63 # Default:
  64 # SourceIP=
  65
  66 ### Option: EnableRemoteCommands
  67 #       Whether remote commands from Zabbix server are allowed.
  68 #       0 - not allowed
  69 #       1 - allowed
  70 #
  71 # Mandatory: no
  72 # Default:
  73 # EnableRemoteCommands=0
  74
  75 ### Option: LogRemoteCommands
  76 #       Enable logging of executed shell commands as warnings.
  77 #       0 - disabled
  78 #       1 - enabled
  79 #
  80 # Mandatory: no
  81 # Default:
  82 # LogRemoteCommands=0
  83
  84 ##### Passive checks related
  85
  86 ### Option: Server
  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
  93 #
  94 # Mandatory: yes, if StartAgents is not explicitly set to 0
  95 # Default:
  96 # Server=
  97
  98 Server=127.0.0.1
  99
 100 ### Option: ListenPort
 101 #       Agent will listen on this port for connections from the server.
 102 #
 103 # Mandatory: no
 104 # Range: 1024-32767
 105 # Default:
 106 # ListenPort=10050
 107
 108 ### Option: ListenIP
 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.
 111 #
 112 # Mandatory: no
 113 # Default:
 114 # ListenIP=0.0.0.0
 115
 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.
 119 #
 120 # Mandatory: no
 121 # Range: 0-100
 122 # Default:
 123 # StartAgents=3
 124
 125 ##### Active checks related
 126
 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]
 134 #
 135 # Mandatory: no
 136 # Default:
 137 # ServerActive=
 138
 139 ServerActive=127.0.0.1
 140
 141 ### Option: Hostname
 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.
 145 #
 146 # Mandatory: no
 147 # Default:
 148 # Hostname=
 149
 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.
 153 #
 154 # Mandatory: no
 155 # Default:
 156 # HostnameItem=system.hostname
 157
 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.
 163 #
 164 # Mandatory: no
 165 # Range: 0-255 characters
 166 # Default:
 167 # HostMetadata=
 168
 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.
 175 #
 176 # Mandatory: no
 177 # Default:
 178 # HostMetadataItem=
 179
 180 ### Option: RefreshActiveChecks
 181 #       How often list of active checks is refreshed, in seconds.
 182 #
 183 # Mandatory: no
 184 # Range: 60-3600
 185 # Default:
 186 # RefreshActiveChecks=120
 187
 188 ### Option: BufferSend
 189 #       Do not keep data longer than N seconds in buffer.
 190 #
 191 # Mandatory: no
 192 # Range: 1-3600
 193 # Default:
 194 # BufferSend=5
 195
 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.
 199 #
 200 # Mandatory: no
 201 # Range: 2-65535
 202 # Default:
 203 # BufferSize=100
 204
 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.
 210 #
 211 # Mandatory: no
 212 # Range: 1-1000
 213 # Default:
 214 # MaxLinesPerSecond=20
 215
 216 ############ ADVANCED PARAMETERS #################
 217
 218 ### Option: Alias
 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.
 226 #
 227 # Mandatory: no
 228 # Range:
 229 # Default:
 230
 231 ### Option: Timeout
 232 #       Spend no more than Timeout seconds on processing
 233 #
 234 # Mandatory: no
 235 # Range: 1-30
 236 # Default:
 237 # Timeout=3
 238
 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.
 243 #       0 - do not allow
 244 #       1 - allow
 245 #
 246 # Mandatory: no
 247 # Default:
 248 # AllowRoot=0
 249
 250 ### Option: User
 251 #       Drop privileges to a specific, existing user on the system.
 252 #       Only has effect if run as 'root' and AllowRoot is disabled.
 253 #
 254 # Mandatory: no
 255 # Default:
 256 # User=zabbix
 257
 258 ### Option: Include
 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.
 261 #
 262 # Mandatory: no
 263 # Default:
 264 # Include=
 265
 266 Include=/etc/zabbix_agentd/zabbix_agentd.d/*.conf
 267
 268
 269 ####### USER-DEFINED MONITORED PARAMETERS #######
 270
 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.
 276 #       0 - do not allow
 277 #       1 - allow
 278 #
 279 # Mandatory: no
 280 # Range: 0-1
 281 # Default:
 282 # UnsafeUserParameters=0
 283
 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.
 288 #
 289 # Mandatory: no
 290 # Default:
 291 # UserParameter=
 292
 293 ####### LOADABLE MODULES #######
 294
 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".
 299 #
 300 # Mandatory: no
 301 # Default:
 302 # LoadModulePath=/usr/lib/modules
 303
 304 LoadModulePath=/usr/lib/zabbix
 305
 306 ### Option: LoadModule
 307 #       Module to load at agent startup. Modules are used to extend functionality of the agent.
 308 #       Format: LoadModule=<module.so>
 309 #       The modules must be located in directory specified by LoadModulePath.
 310 #       It is allowed to include multiple LoadModule parameters.
 311 #
 312 # Mandatory: no
 313 # Default:
 314 # LoadModule=
 315
 316 ####### TLS-RELATED PARAMETERS #######
 317
 318 ### Option: TLSConnect
 319 #       How the agent should connect to server or proxy. Used for active checks.
 320 #       Only one value can be specified:
 321 #               unencrypted - connect without encryption
 322 #               psk         - connect using TLS and a pre-shared key
 323 #               cert        - connect using TLS and a certificate
 324 #
 325 # Mandatory: yes, if TLS certificate or PSK parameters are defined (even for 'unencrypted' connection)
 326 # Default:
 327 # TLSConnect=unencrypted
 328
 329 ### Option: TLSAccept
 330 #       What incoming connections to accept.
 331 #       Multiple values can be specified, separated by comma:
 332 #               unencrypted - accept connections without encryption
 333 #               psk         - accept connections secured with TLS and a pre-shared key
 334 #               cert        - accept connections secured with TLS and a certificate
 335 #
 336 # Mandatory: yes, if TLS certificate or PSK parameters are defined (even for 'unencrypted' connection)
 337 # Default:
 338 # TLSAccept=unencrypted
 339
 340 ### Option: TLSCAFile
 341 #       Full pathname of a file containing the top-level CA(s) certificates for
 342 #       peer certificate verification.
 343 #
 344 # Mandatory: no
 345 # Default:
 346 # TLSCAFile=
 347
 348 ### Option: TLSCRLFile
 349 #       Full pathname of a file containing revoked certificates.
 350 #
 351 # Mandatory: no
 352 # Default:
 353 # TLSCRLFile=
 354
 355 ### Option: TLSServerCertIssuer
 356 #      Allowed server certificate issuer.
 357 #
 358 # Mandatory: no
 359 # Default:
 360 # TLSServerCertIssuer=
 361
 362 ### Option: TLSServerCertSubject
 363 #      Allowed server certificate subject.
 364 #
 365 # Mandatory: no
 366 # Default:
 367 # TLSServerCertSubject=
 368
 369 ### Option: TLSCertFile
 370 #       Full pathname of a file containing the agent certificate or certificate chain.
 371 #
 372 # Mandatory: no
 373 # Default:
 374 # TLSCertFile=
 375
 376 ### Option: TLSKeyFile
 377 #       Full pathname of a file containing the agent private key.
 378 #
 379 # Mandatory: no
 380 # Default:
 381 # TLSKeyFile=
 382
 383 ### Option: TLSPSKIdentity
 384 #       Unique, case sensitive string used to identify the pre-shared key.
 385 #
 386 # Mandatory: no
 387 # Default:
 388 # TLSPSKIdentity=
 389
 390 ### Option: TLSPSKFile
 391 #       Full pathname of a file containing the pre-shared key.
 392 #
 393 # Mandatory: no
 394 # Default:
 395 # TLSPSKFile=