zabbix客户端配置文件详解

Posted 2020-07-28

############ GENERAL PARAMETERS #################

 

### Option: PidFile

#   Name of PID file.

#

# Mandatory: no

# Default:

#pidFile=PID路径

#说明：指定程程序PIDFILE路径，可修改到其它路径，但SNC不建议修改

 PidFile=/smp/sncmon/zabbix_agentd.pid

 

### Option: LogFile

#   Name of log file.

#   If not set, syslog is used.

#

# Mandatory: no

# Default:

# LogFile=

#LogFile=路径

#说明：客户端AGENT运行产生的日志文件路径，可修改到其它路径，如/var/log/zabbix_agnetd.log，视具体情况修改，也可保持默认

LogFile=/smp/sncmon/zabbix_agentd.log

 

### Option: LogFileSize

#   Maximum size of log file in MB.

#   0 - disable automatic log rotation.

#

# Mandatory: no

# Range: 0-1024

# Default:

#LogFileSize=数字

#说明：AGENT产生日志大小控制，默认1M，若为0，则表示不产生任何日志，数字范围（1-1024M）不建议关闭日志功能，建议保持默认

LogFileSize=1

 

### Option: DebugLevel

#   Specifies debug level

#   0 - no debug  无日志级别

#   1 - critical information 灾难信息级别

#   2 - error information   一般错误信息级别

#   3 - warnings  警告级别

#   4 - for debugging (produces lots of information)  调试级别

#说明：0~4级别，日志产生量在相同单位时间，生成的日志量为递增，即0级别日志量最少，4级别最多，默认3级别，建议视具体情况，自行把握

#

# Mandatory: no

# Range: 0-4

# Default:

DebugLevel=3

 

### Option: SourceIP

#   Source IP address for outgoing connections.

#

# Mandatory: no

# Default:

#SourceIP=IP地址

#说明：当系统设置有多个IP时，需要指定一个IP与二级代理或服务端通信，若系统只有一个IP，也建议指定一个IP

SourceIP=192.168.1.3

 

### Option: EnableRemoteCommands

#   Whether remote commands from Zabbix server are allowed.

#   0 - not allowed 不允许

#   1 - allowed 允许

#

# Mandatory: no

# Default:

#EnableRemoteCommands=0或1

#说明：是否允许在本地执行远程命令，建议设置为“允许”，因为SNC对命令下发功能进行了二次开发，功能强大，极大的方便日志运维工作

EnableRemoteCommands=1

 

### Option: LogRemoteCommands

#   Enable logging of executed shell commands as warnings.

#   0 - disabled 不产生日志

#   1 - enabled  产生日志

#

# Mandatory: no

# Default:

#LogRemoteCommands=1或0

#说明:在参数EnableRemoteCommands=1的情况下，执行远程命令是否保存操作日志，若已设置EnableRemoteCommands=1

#建议LogRemoteCommands=1，以便 日后查证。若EnableRemoteCommands=0，此参数不生效

LogRemoteCommands=1

 

##### Passive checks related

#与被动模式有关的参数设置

#什么是被动模式？

#被动模式下，由二级代理或服务端主动请求AGENT，去获取所采集到的监控数据

### Option: Server

#   List of comma delimited IP addresses (or hostnames) of Zabbix servers.

#   Incoming connections will be accepted only from the hosts listed here.

#   If IPv6 support is enabled then ‘127.0.0.1‘, ‘::127.0.0.1‘, ‘::ffff:127.0.0.1‘ are treated equally.

#

# Mandatory: no

# Default:

# Server=

#Server=IP地址或主机名，建议IP地址

#说明：在有二级代理情况下，此IP地址应该填写二级代理服务器的IP，反之，若无二级代理服务器，则此IP应设置为服务端#IP

Server=192.168.1.14

 

### Option: ListenPort

#   Agent will listen on this port for connections from the server.

#

# Mandatory: no

# Range: 1024-32767 （监控端口范围）

# Default:

# ListenPort=数字

#说明：此AGENT端以本地服务的形式运行，需要监听端口，强烈建议设置为10050，以便移动整个系统统一规划管理，当然，特殊情况下可修改为1024-32767 未使用的端口

ListenPort=10050

 

### Option: ListenIP

#   List of comma delimited IP addresses that the agent should listen on.

#   First IP address is sent to Zabbix server if connecting to it to retrieve list of active checks.

#

# Mandatory: no

# Default:

## ListenIP=IP地址

#说明：对应的ListenPort监听到哪个IP上面，建议指定IP时，不用0.0.0.0

# ListenIP=192.168.1.6

 

### Option: StartAgents

#   Number of pre-forked instances of zabbix_agentd that process passive checks.

#   If set to 0, disables passive checks and the agent will not listen on any TCP port.

#

# Mandatory: no

# Range: 0-100 数字范围（0-100）

# Default:

#StartAgents=数字

#说明：在被动模式下，此参数用于设置控制监听进程可启用的子进程的数量，若监控项较多且采集很频繁，建议加大此数值

；若此数值为0，则禁止使用被动模式。另外，一般情况，不建议修改此数值，当且仅当某些监控项无法采集到数据，或数据采集数据有延迟现象时，可调整。第四，启用线程越多，则相对越耗系统资源

StartAgents=5

 

##### Active checks related

#主动模式相关参数设置

#什么时主动模式？

#在主动模式下，AGENT端（即采集客户端）将所采集的结果，主动提交给二级代理服务器或服务器，而此种情况下，二级代理服务器或服务器将被动接收采集信息

### Option: ServerActive

#   List of comma delimited IP:port (or hostname:port) pairs of Zabbix servers for active checks.

#   If port is not specified, default port is used.

#   IPv6 addresses must be enclosed in square brackets if port for that host is specified.

#   If port is not specified, square brackets for IPv6 addresses are optional.

#   If this parameter is not specified, active checks are disabled.

#   Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

#

# Mandatory: no

# Default:

# ServerActive=

#ServerActive=IP地址或IP地址：端口号

#说明：在主动模式下，ServerActive为二级代理服务器或服务器，默认端口为10051，若需更改端口，则为#ServerActive=IP:port,非特殊情况下，不建议修改。

ServerActive=192.168.1.14

 

### Option: Hostname

#   Unique, case sensitive hostname.

#   Required for active checks and must match hostname as configured on the server.

#   Value is acquired from HostnameItem if undefined.

#

# Mandatory: no

# Default:

# Hostname=

# Hostname=主机名

#说明：手工自定义一个主机名，可以和系统的主机名一样，也可以不一样，此参数可根据实际情况启用或关闭，建议关闭此参数，并启用HostnameItem参数

#Hostname=Zabbix server

 

### Option: HostnameItem

#   Item used for generating Hostname if it is undefined.

#   Ignored if Hostname is defined.

#

# Mandatory: no

# Default:

#HostnameItem：自动获取主机名

#说明：system.hostname是ZABBIX内置的一个自动获取主机名的方法，为了方便配置，建议打开此参数而关闭Hostname参数#。注意：HostnameItem的优化级低于Hostname，当两个参数都启用且配置的情况下，ZABBIX获取的主机名，将以Hostname为#准

HostnameItem=system.hostname

 

### Option: HostMetadata

#   Optional parameter that defines host metadata.

#   Host metadata is used at host auto-registration process.

#   An agent will issue an error and not start if the value is over limit of 255 characters.

#   If not defined, value will be acquired from HostMetadataItem.

#

# Mandatory: no

# Range: 0-255 characters 0-255个字符

# Default:

#  HostMetadata=字符串

#说明：用于定义当前主机唯一标识符，最大长度255个，仅适用于自动发现情况下，默认不定义，建议不定义

# HostMetadata=

 

### Option: HostMetadataItem

#   Optional parameter that defines an item used for getting host metadata.

#   Host metadata is used at host auto-registration process.

#   During an auto-registration request an agent will log a warning message if

#   the value returned by specified item is over limit of 255 characters.

#   This option is only used when HostMetadata is not defined.

#

# Mandatory: no

# Default:

#说明；用于获取主机的HostMetadata，建议保持默认

# HostMetadataItem=

 

### Option: RefreshActiveChecks

#   How often list of active checks is refreshed, in seconds.

#

# Mandatory: no

# Range: 60-3600

# Default:

#RefreshActiveChecks=数字

#说明：被监控的主机多久（秒）重新请求二级代理或服务端刷新一监控列表。范围为60-3600秒。ZABBIX运行原理为：，zabbix客户端启动后，在等待RefreshActiveChecks秒后，开始从二级代理或服务端请求并下载监控项信息，保存在本地专门的buffersend中，再过RefreshActiveChecks秒后，重新获取监控项信息。这就是为什么当配置监控项，要过一会才能生效的原因。这个数值，就是等待时间。建议，不要将此数值设置过小，以免加大AGENT端和服务端及数据库的压力，建议为120秒。

 RefreshActiveChecks=120

 

### Option: BufferSend

#   Do not keep data longer than N seconds in buffer.

#

# Mandatory: no

# Range: 1-3600

# Default:

#BufferSend=数字

#