]> git.ipfire.org Git - ipfire-2.x.git/blame - config/zabbix_agentd/zabbix_agentd.conf
freeradius: handle special LDFLAGS to configure
[ipfire-2.x.git] / config / zabbix_agentd / zabbix_agentd.conf
CommitLineData
06fc6170
AK
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
13PidFile=/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
32LogFile=/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
43LogFileSize=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
98Server=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
139ServerActive=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
266Include=/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
304LoadModulePath=/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=