个人工具

“ZabbixManual1.4/ZabbixProcesses”的版本间的差异

来自Ubuntu中文

跳转至： 导航, 搜索
（→‎ZABBIX Agent (UNIX, standalone daemon)）
 
（未显示同一用户的13个中间版本）
第1行： 第1行：
 +
{{Copyedit translation|from=[[ZabbixManual1.4/ZabbixProcesses]] }}
 +
 +
{{Translator|FireHare}} {{Languages|ZabbixManual1.4/ZabbixProcesses}}
 +
 
== ZABBIX Processes ==
 
== ZABBIX Processes ==
−
=== ZABBIX Server ===
+
 
 +
=== ZABBIX Server<br> ===
 +
 
 
ZABBIX Server is a central process of ZABBIX software. ZABBIX Server can be started by executing:
 
ZABBIX Server is a central process of ZABBIX software. ZABBIX Server can be started by executing:
  
−
  shell> cd bin
+
  shell&gt; cd bin
−
  shell> ./zabbix_server
+
  shell&gt; ./zabbix_server
  
 
ZABBIX Server runs as a daemon process.
 
ZABBIX Server runs as a daemon process.
第10行： 第16行：
 
ZABBIX Server accepts the following command line parameters:
 
ZABBIX Server accepts the following command line parameters:
  
−
  -c --config <file>    specify configuration file, default is /etc/zabbix/zabbix_server.conf
+
  -c --config &lt;file&gt; specify configuration file, default is /etc/zabbix/zabbix_server.conf
−
  -h --help             give this help
+
  -h --help give this help
−
  -v --version         display version number
+
  -v --version display version number
  
 
In order to get this help run:
 
In order to get this help run:
  
−
  shell> zabbix_server -h
+
  shell&gt; zabbix_server -h
  
 
Example of command line parameters:
 
Example of command line parameters:
  
−
  shell> zabbix_server –c /usr/local/etc/zabbix_server.conf
+
  shell&gt; zabbix_server –c /usr/local/etc/zabbix_server.conf
−
  shell> zabbix_server --help
+
  shell&gt; zabbix_server --help
−
  shell> zabbix_server -v
+
  shell&gt; zabbix_server -v
  
 
The configuration file contains parameters for zabbix_server. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:
 
The configuration file contains parameters for zabbix_server. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:
−
{|border='1' cellpadding="1" cellspacing="0" width="100%"
+
 
−
|Parameter||Mandatory||Default value||Description
+
{| width="100%" cellspacing="0" cellpadding="1" border="1"
 
|-
 
|-
−
|AlertScriptsPath||No||/home/zabbix/bin||Location of scripts for user-defined media types.
+
| Parameter
 +
| Mandatory
 +
| Default value
 +
| Description
 
|-
 
|-
−
|DBHost||Yes|| - ||Database name. Usually ‘zabbix’.
+
| AlertScriptsPath
 +
| No
 +
| /home/zabbix/bin
 +
| Location of scripts for user-defined media types.
 
|-
 
|-
−
|DBName||Yes|| - ||Database name. Usually ‘zabbix’.
+
| DBHost
 +
| Yes
 +
| -
 +
| Database name. Usually ‘zabbix’.
 
|-
 
|-
−
|DBSocket|| No || - ||DB socket name. Used for non-TCP connection to MySQL database. Example: /tmp/mysql.sock
+
| DBName
 +
| Yes
 +
| -
 +
| Database name. Usually ‘zabbix’.
 
|-
 
|-
−
|DBPassword||No||NULL||Database password. If password is not used, then this parameter must be commented.
+
| DBSocket
 +
| No
 +
| -
 +
| DB socket name. Used for non-TCP connection to MySQL database. Example: /tmp/mysql.sock
 
|-
 
|-
−
|DBUser||No||NULL||User name for connecting to  the database.
+
| DBPassword
 +
| No
 +
| NULL
 +
| Database password. If password is not used, then this parameter must be commented.
 
|-
 
|-
−
|DebugLevel
+
| DBUser
−
|No
+
| No
−
|3
+
| NULL
−
|Debug level, one of
+
| User name for connecting to the database.
−
0 – none
+
−
1 – critical
+
−
2 – errors
+
−
3 – warnings
+
−
4 – debug
+
 
|-
 
|-
−
|DisableHousekeeping||No||0||If set to 1, housekeeper will be disabled.
+
| DebugLevel
 +
| No
 +
| 3
 +
| Debug level, one of
 +
0 – none 1 – critical 2 – errors 3 – warnings 4 – debug
 +
 
 
|-
 
|-
−
|ExternalScripts||No|| /etc/zabbix/exter||Location of scripts for external checks.
+
| DisableHousekeeping
 +
| No
 +
| 0
 +
| If set to 1, housekeeper will be disabled.
 
|-
 
|-
−
|FpingLocation||No||/usr/sbin/fping||Location of ICMP pinger. It must have setuid flag set.
+
| ExternalScripts
 +
| No
 +
| /etc/zabbix/exter
 +
| Location of scripts for external checks.
 
|-
 
|-
−
|HousekkepingFrequency
+
| FpingLocation
−
|No
+
| No
−
|1
+
| /usr/sbin/fping
−
|The parameter defines how often the daemon must perform housekeeping  procedure (in hours). If PostgreSQL is used set the value to 24 as it will perform command VACUUM.
+
| Location of ICMP pinger. It must have setuid flag set.
 
|-
 
|-
−
|Include
+
| HousekkepingFrequency
−
|No
+
| No
−
| -
+
| 1
−
|Use this parameter to include a file into the configuration file. Number of parameters Include is not limited.
+
| The parameter defines how often the daemon must perform housekeeping procedure (in hours). If PostgreSQL is used set the value to 24 as it will perform command VACUUM.
−
For example:
+
−
Include=/etc/zabbix/db_conn.conf
+
 
|-
 
|-
−
|ListenIP||No|| - ||Interface to listen by trapper processes. Trapper will listen to all interfaces if this parameter is not set.
+
| Include
 +
| No
 +
| -
 +
| Use this parameter to include a file into the configuration file. Number of parameters Include is not limited.
 +
For example: Include=/etc/zabbix/db_conn.conf
 +
 
 
|-
 
|-
−
|ListenPort||No||10051||Port number to listen by trapper processes.
+
| ListenIP
 +
| No
 +
| -
 +
| Interface to listen by trapper processes. Trapper will listen to all interfaces if this parameter is not set.
 
|-
 
|-
−
| LogFile||No|| - ||Name of log file. If not set, syslog is used.
+
| ListenPort
 +
| No
 +
| 10051
 +
| Port number to listen by trapper processes.
 
|-
 
|-
−
|LogFileSize||No||1||This parameter controls log rotation setting for LogFile.By default, ZABBIX automatically roatates log file when it reaches 1MB.This parameter is in MB.If set to 0, no log rotation will be performed.
+
| LogFile
 +
| No
 +
| -
 +
| Name of log file. If not set, syslog is used.
 
|-
 
|-
−
|NodeID||No||0||Unique NodeID (0-999). Must be ‘0’ or missing for standalone ZABBIX Server.
+
| LogFileSize
 +
| No
 +
| 1
 +
| This parameter controls log rotation setting for LogFile.By default, ZABBIX automatically roatates log file when it reaches 1MB.This parameter is in MB.If set to 0, no log rotation will be performed.
 
|-
 
|-
−
|PidFile||No||/tmp/zabbix_server.pid||Name of file to store PID
+
| NodeID
 +
| No
 +
| 0
 +
| Unique NodeID (0-999). Must be ‘0’ or missing for standalone ZABBIX Server.
 
|-
 
|-
−
|PingerFrequency||No||30||ZABBIX server ping serversonce per PingerFrequency seconds (1-3600).
+
| PidFile
 +
| No
 +
| /tmp/zabbix_server.pid
 +
| Name of file to store PID
 
|-
 
|-
−
|SenderFrequency||No||30||The parameter defines how often the daemon must try to send alerts (in seconds)
+
| PingerFrequency
 +
| No
 +
| 30
 +
| ZABBIX server ping serversonce per PingerFrequency seconds (1-3600).
 
|-
 
|-
−
|StartDiscoverers||No||1||Number of discoverers to start (0-255).
+
| SenderFrequency
 +
| No
 +
| 30
 +
| The parameter defines how often the daemon must try to send alerts (in seconds)
 
|-
 
|-
−
|StartHTTPPollers||No||5||Number of HTTP pollers to start (0-255).
+
| StartDiscoverers
 +
| No
 +
| 1
 +
| Number of discoverers to start (0-255).
 
|-
 
|-
−
|StartPollers||No||5||Number of pollers to start (0-255).
+
| StartHTTPPollers
 +
| No
 +
| 5
 +
| Number of HTTP pollers to start (0-255).
 
|-
 
|-
−
|StartPollersUnreachable||No||1||Number of pollers forunreachable hosts to start (0-255).
+
| StartPollers
 +
| No
 +
| 5
 +
| Number of pollers to start (0-255).
 
|-
 
|-
−
|StartTrappers||No||5||Number of trappers to start (0-255)
+
| StartPollersUnreachable
 +
| No
 +
| 1
 +
| Number of pollers forunreachable hosts to start (0-255).
 
|-
 
|-
−
|Timeout||No||5||Do not spend more than Timeout seconds on retrieving requested value (1-255) Note: Example of the configuration file can be found at misc/conf/zabbix_server.conf
+
| StartTrappers
 +
| No
 +
| 5
 +
| Number of trappers to start (0-255)
 
|-
 
|-
−
|TrapperTimeout||No||5||Do not spend more than Timeout seconds on processing of traps (1-255)
+
| Timeout
 +
| No
 +
| 5
 +
| Do not spend more than Timeout seconds on retrieving requested value (1-255) Note: Example of the configuration file can be found at misc/conf/zabbix_server.conf
 
|-
 
|-
−
|UnavailableDelay||No||60||How ofter try to connect to unavailable host
+
| TrapperTimeout
 +
| No
 +
| 5
 +
| Do not spend more than Timeout seconds on processing of traps (1-255)
 
|-
 
|-
−
|UnreachableDelay||No||15||How often try to connect to unreachable host
+
| UnavailableDelay
 +
| No
 +
| 60
 +
| How ofter try to connect to unavailable host
 
|-
 
|-
−
|UnreachablePeriod||No||45||If a host was unreachable for more than UnreachablePeriod seconds,change host status to Unavailable
+
| UnreachableDelay
 +
| No
 +
| 15
 +
| How often try to connect to unreachable host
 +
|-
 +
| UnreachablePeriod
 +
| No
 +
| 45
 +
| If a host was unreachable for more than UnreachablePeriod seconds,change host status to Unavailable
 
|}
 
|}
  
 
=== ZABBIX Agent (UNIX, standalone daemon) ===
 
=== ZABBIX Agent (UNIX, standalone daemon) ===
 +
 
ZABBIX UNIX Agent runs on a host being monitored. The agent provides host's performance and availability information for ZABBIX Server.
 
ZABBIX UNIX Agent runs on a host being monitored. The agent provides host's performance and availability information for ZABBIX Server.
  
第111行： 第201行：
  
 
ZABBIX Agent can be started by executing:
 
ZABBIX Agent can be started by executing:
−
  shell> cd bin
+
 
−
  shell> ./zabbix_agentd
+
  shell&gt; cd bin
 +
  shell&gt; ./zabbix_agentd
  
 
ZABBIX Agent runs as a daemon process.
 
ZABBIX Agent runs as a daemon process.
第118行： 第209行：
 
ZABBIX Agent accepts the following command line parameters:
 
ZABBIX Agent accepts the following command line parameters:
  
−
  -c --config <file>  specify configuration file, default is /etc/zabbix/zabbix_agentd.conf
+
  -c --config &lt;file&gt; specify configuration file, default is /etc/zabbix/zabbix_agentd.conf
−
  -h --help           give this help
+
  -h --help give this help
−
  -v --version       display version number
+
  -v --version display version number
−
  -p --print         print supported metrics and exit
+
  -p --print print supported metrics and exit
−
  -t --test <metric>  test specified metric and exit
+
  -t --test &lt;metric&gt; test specified metric and exit
  
 
In order to get this help run:
 
In order to get this help run:
  
−
  shell> zabbix_agentd –h
+
  shell&gt; zabbix_agentd –h
  
 
Example of command line parameters:
 
Example of command line parameters:
  
−
  shell> zabbix_agentd –c /usr/local/etc/zabbix_agentd.conf
+
  shell&gt; zabbix_agentd –c /usr/local/etc/zabbix_agentd.conf
−
  shell> zabbix_agentd –help
+
  shell&gt; zabbix_agentd –help
−
  shell> zabbix_agentd –print
+
  shell&gt; zabbix_agentd –print
−
  shell> zabbix_agentd –t “system.cpu.load[all,avg1]”
+
  shell&gt; zabbix_agentd –t “system.cpu.load[all,avg1]”
  
 
The configuration file contains configuration parameters for zabbix_agentd. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:
 
The configuration file contains configuration parameters for zabbix_agentd. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:
−
{|
+
 
−
|Parameter||Mandatory||Default value||Description
+
{| width="100%" cellspacing="0" cellpadding="1" border="1"
−
|DebugLevel
+
−
|No
+
−
|3
+
−
|Debug level:
+
−
0 – none
+
−
1 – critical
+
−
2 – errors
+
−
3 – warnings
+
−
4 – debug
+
 
|-
 
|-
−
|DisableActive|| No|| 0 ||Disable processing of active checks. The agent will not connect to ZABBIX server to get list of active items.
+
| Parameter
 +
| Mandatory
 +
| Default value
 +
| Description
 
|-
 
|-
−
|EnableRemoteCommands||No||0||Enable remote commands. ZABBIX server will be able to send commands for execution by the agent.
+
| DebugLevel
 +
| No
 +
| 3
 +
| Debug level:
 +
0 – none 1 – critical 2 – errors 3 – warnings 4 – debug
 +
 
 
|-
 
|-
−
|Hostname||No||System’s Unique host name.||The hostname. hostname is used for active checks only.
+
| DisableActive
 +
| No
 +
| 0
 +
| Disable processing of active checks. The agent will not connect to ZABBIX server to get list of active items.
 
|-
 
|-
−
|Include||No|| - ||Use this parameter to include a file into the configuration file. Number of parameters Include is not limited.For example: Include=/etc/zabbix/user_parameters.conf
+
| EnableRemoteCommands
 +
| No
 +
| 0
 +
| Enable remote commands. ZABBIX server will be able to send commands for execution by the agent.
 
|-
 
|-
−
|ListenIP||No|| - || IP address to bind agent to. Useful if the host has multiple interfaces.
+
| Hostname
 +
| No
 +
| System’s Unique host name.
 +
| The hostname. hostname is used for active checks only.
 
|-
 
|-
−
|ListenPort||No||10050||Port number to listen.
+
| Include
 +
| No
 +
| -
 +
| Use this parameter to include a file into the configuration file. Number of parameters Include is not limited.For example: Include=/etc/zabbix/user_parameters.conf
 
|-
 
|-
−
|LogFile||No|| - ||Name of log file. If not set, syslog is used.
+
| ListenIP
 +
| No
 +
| -
 +
| IP address to bind agent to. Useful if the host has multiple interfaces.
 
|-
 
|-
−
|LogFileSize||No||1||This parameter controls log rotation setting for LogFile.By default,        ZABBIX automatically roatates log file when it reaches 1MB. This parameter is in MB. If set to 0, no log rotation will be performed.
+
| ListenPort
 +
| No
 +
| 10050
 +
| Port number to listen.
 
|-
 
|-
−
|PidFile||No|/tmp/zabbix_agentd.pid||Name of PID file.
+
| LogFile
 +
| No
 +
| -
 +
| Name of log file. If not set, syslog is used.
 
|-
 
|-
−
|RefreshActiveChecks||No||120||The agent will refresh list of active checks once per 120 (default) seconds.
+
| LogFileSize
 +
| No
 +
| 1
 +
| This parameter controls log rotation setting for LogFile.By default, ZABBIX automatically roatates log file when it reaches 1MB. This parameter is in MB. If set to 0, no log rotation will be performed.
 
|-
 
|-
−
|Server||Yes|| - ||Comma-delimited list of IP addresses of  ZABBIX servers. Connections from other IP addresses will be rejected.
+
| PidFile
 +
| /tmp/zabbix_agentd.pid
 +
| Name of PID file.
 
|-
 
|-
−
|ServerPort||No||10051||The agent will connect to this server port for processing active checks.
+
| RefreshActiveChecks
 +
| No
 +
| 120
 +
| The agent will refresh list of active checks once per 120 (default) seconds.
 
|-
 
|-
−
|StartAgents||No||5||Number of agents to start.
+
| Server
 +
| Yes
 +
| -
 +
| Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected.
 
|-
 
|-
−
|Timeout||No||3||Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes!
+
| ServerPort
 +
| No
 +
| 10051
 +
| The agent will connect to this server port for processing active checks.
 
|-
 
|-
−
|UserParameter|| No || - ||User-defined parameter to monitor. There can be several            user-defined parameters. Value has form , Example:UserParameter=users, who|wc -l Note: Example of the configuration file can be found at misc/conf/zabbix_agentd.conf.
+
| StartAgents
 +
| No
 +
| 5
 +
| Number of agents to start.
 +
|-
 +
| Timeout
 +
| No
 +
| 3
 +
| Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes!
 +
|-
 +
| UserParameter
 +
| No
 +
| -
 +
| wc -l Note: Example of the configuration file can be found at misc/conf/zabbix_agentd.conf.
 
|}
 
|}
  
 
=== ZABBIX Agent (UNIX, Inetd version) ===
 
=== ZABBIX Agent (UNIX, Inetd version) ===
−
              The file contains configuration parameters for zabbix_agent. The file must exist
+
 
−
              and it should have read permissions for user ‘zabbix’. Supported parameters:
+
The file contains configuration parameters for zabbix_agent. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:
−
                Parameter             Mandatory   Default value     Description
+
 
−
                                      Yes         -                 Comma-delimited list of IP
+
{| width="100%" cellspacing="1" cellpadding="1" border="1"
−
                Server
+
|-
−
                                                                      addresses     of     ZABBIX
+
| Parameter
−
                                                                      servers. Connections from
+
| Mandatory
−
                                                                      other IP addresses will be
+
| Default value
−
                                                                      rejected.
+
| Description
−
                                      No           3                 Do not spend more that
+
|-
−
                Timeout
+
| Server
−
                                                                      Timeout seconds on getting
+
| Yes
−
                                                                      requested value (1-255). The
+
| -
−
                                                                      agent does not kill timeouted
+
| Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected.
−
                                                                      User Parameters processes!
+
|-
−
                                      No           -                 User-defined parameter to
+
| Timeout
−
                UserParameter
+
| No
−
                                                                      monitor. There can be
+
| 3
−
                                                                      several           user-defined
+
| Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes!
−
                                                                      parameters.
+
|-
−
                                                                      Example:UserParameter=use
+
| UserParameter
−
                                                                      rs,who|wc -l
+
| No
−
                      Example     of   the   configuration   file   can   be   found       at
+
| -
−
              Note:
+
| User-defined parameter to monitor. There can be several user-defined parameters.  
−
                      misc/conf/zabbix_agent.conf
+
Example:UserParameter=use rs,who&#124;wc -l
 +
 
 +
|}
 +
 
 +
Note: Example of the configuration file can be found at misc/conf/zabbix_agent.conf
 +
 
 
=== ZABBIX Agent (Windows) ===
 
=== ZABBIX Agent (Windows) ===
−
              ZabbixW32 is ZABBIX agent for Win32 systems. It will work on Windows NT 4.0,
+
 
−
              Windows 2000, Windows XP, and Windows Vista.
+
ZabbixW32 is ZABBIX agent for Win32 systems. It will work on Windows NT 4.0, Windows 2000, Windows XP, and Windows Vista.
 +
 
 
==== Installation ====
 
==== Installation ====
−
              Installation is very simple and includes 3 steps:
+
 
−
                            Create configuration file.
+
Installation is very simple and includes 3 steps:
−
                Step 1
+
 
−
              Create configuration file c:/zabbix_agentd.conf (it has the same syntax as UNIX
+
'''Step 1 Create configuration file.'''
−
              agent).
+
 
−
                            Install agent as a Windows service.
+
Create configuration file c:/zabbix_agentd.conf (it has the same syntax as UNIX agent).
−
                Step 2
+
 
−
              ZabbixW32.exe install
+
'''Step 2 Install agent as a Windows service.'''
−
              If you wish to use configuration file other that c:\zabbix_agentd.conf, you should
+
 
−
              use the following command for service installation:
+
ZabbixW32.exe --install
−
              ZabbixW32.exe --config <your_configuration_file> install
+
 
−
              Full path to configuration file should be specified.
+
If you wish to use configuration file other that c:\zabbix_agentd.conf, you should use the following command for service installation:
−
                            Run agent.
+
 
−
                Step 2
+
ZabbixW32.exe --config &lt;your_configuration_file&gt; install
−
              Now you can use Control Panel to start agent's service or run:
+
 
−
              ZabbixW32.exe start
+
Full path to configuration file should be specified.
−
                      Windows NT 4.0 note. ZabbixW32 uses PDH (Performance Data Helper)
+
 
−
              Note:
+
'''Step 3 Run agent.'''
−
                      API to gather various system information, so PDH.DLL is needed. This
+
 
−
                      DLL is not supplied with Windows NT 4.0, so you need to download and
+
Now you can use Control Panel to start agent's service or run:
−
                      install it by yourself. Microsoft Knowledge Base article number 284996
+
 
−
                      describes this in detail and contains a download link. You can find this
+
ZabbixW32.exe start
−
                      article at http://support.microsoft.com/default.aspx?scid=kb;en-us;284996
+
 
 +
Windows NT 4.0 note. ZabbixW32 uses PDH (Performance Data Helper)
 +
 
 +
Note:
 +
  API to gather various system information, so PDH.DLL is needed. This DLL is not supplied with Windows NT 4.0, so you need to download and
 +
  install it by yourself. Microsoft Knowledge Base article number 284996 describes this in detail and contains a download link. You can find this
 +
  article at http://support.microsoft.com/default.aspx?scid=kb;en-us;284996
 +
 
 
==== Usage ====
 
==== Usage ====
−
              zabbixw32 [options] [command]
 
−
              ZABBIX Windows Agent accepts the following command line parameters:
 
−
                check-config        Check configuration file and exit.
 
−
                help                Display help information.
 
−
                install            Install ZABBIX Win32 Agent as a service.
 
−
                install-events      Install ZABBIX Win32 Agent as event source
 
−
                                    for Event Log. This is done automatically
 
−
                                    when service is being installed.
 
−
                remove              Remove previously installed ZABBIX Win32
 
−
                                    Agent service.
 
−
                remove-events      Remove ZABBIX Win32 Agent event source.
 
−
                                    This is done automatically when service is
 
−
                                    being removed.
 
−
                standalone          Run in standalone mode.
 
−
                start              Start ZABBIX Agent service.
 
−
                stop                Stop ZABBIX Agent service.
 
−
                version            Display version information.
 
−
              And possible options are:
 
−
                --config <file>    Specify alternate configuration file (default is
 
−
                                    c:\zabbix_agentd.conf).
 
−
              The file contains    configuration    parameters  for    ZabbixW32.    Supported
 
−
              parameters:
 
−
                Parameter          Mandatory      Default value      Description
 
−
                                    No            -                  Sets the alias for parameter.
 
−
                Alias
 
−
                                                                      It can be useful to substitute
 
−
                                                                      long and complex parameter
 
−
                                                                      name with a smaller and
 
−
                                                                      simpler one. For example, if
 
−
                                                                      you wish to retrieve paging
 
−
                                                                      file usage in percents from
 
−
                                                                      the server, you may use
 
−
                                                                      parameter
 
  
−
                                                        "perf_counter[\Paging
+
Command line syntax:
−
                                                        File(_Total)\% Usage]", or
+
 
−
                                                        you may define an alias by
+
zabbix_agentd.exe [-Vhp] [-idsx] [-c &lt;file&gt;] [-t &lt;metric&gt;]
−
                                                        adding the following line to
+
 
−
                                                        configuration file: Alias =
+
ZABBIX Windows Agent accepts the following command line parameters:
−
                                                        pg_usage:perf_counter[\Pagi
+
 
−
                                                        ng File(_Total)\% Usage]
+
'''Options:'''
−
                                                        After that you can use
+
 
−
                                                        parameter name "pg_usage"
+
-c --config &lt;file&gt; Specify alternate configuration file (default is c:\zabbix_agentd.conf).
−
                                                        to     retrieve     the     same
+
-h --help Display help information.
−
                                                        information. You can specify
+
-V --version Display version number.
−
                                                        as many "Alias" records as
+
-p --print Print list of supported checks (metrics) and exit.
−
                                                        you wish. Please note that
+
-t --test &lt;metric&gt; Test single check (metric) and exit.
−
                                                        aliases cannot be used for
+
 
−
                                                        parameters         defined     in
+
'''Functions:'''
−
                                                        "PerfCounter" configuration
+
 
−
                                                        file records.
+
-I --install Install ZABBIX agent as a service.
−
                                No        -             The parameter has no effect.
+
-d --uninstall Uninstall ZABBIX agent service.
−
                DebugLevel
+
-s --start Start ZABBIX agent service.
−
                                No       -             Use this parameter to include
+
-x --stop Stop ZABBIX agent service.
−
                Include
+
 
−
                                                        a file into the configuration
+
The file contains configuration parameters for Zabbix_agentd.exe. Supported parameters: <br>
−
                                                        file. Number of parameters
+
 
−
                                                        Include is not limited.
+
<br>
−
                                                        For example:
+
 
−
                                                        Include=c:\user_parameters.
+
{| width="100%" cellspacing="1" cellpadding="1" border="1"
−
                                                        conf
+
|-
−
                                No       10050         Port number to listen.
+
| Parameter
−
                ListenPort
+
| Mandatory
−
                                No       -             Name of log file. If not set,
+
| Default value
−
                LogFile
+
| Description
−
                                                        syslog is used.
+
|-
−
                                No       -             Controls         logging       of
+
| Alias
−
                LogUnresolvedS
+
| No
−
                                                        unresolved symbols during
+
| -<br>
−
                ymbols
+
| Sets the alias for parameter. It can be useful to substitute long and complex parameter name with a smaller and simpler one. For example, if you wish to retrieve paging file usage in percents from the server, you may use parameter "perf_counter[\Paging File(_Total)\% Usage]", or you may define an alias by adding the following line to configuration file: Alias = pg_usage:perf_counter[\Pagi ng File(_Total)\% Usage] After that you can use parameter name "pg_usage" to retrieve the same information. You can specify as many "Alias" records as you wish. Please note that aliases cannot be used for parameters defined in "PerfCounter" configuration file records.
−
                                                        agent startup. Values can be
+
|-
−
                                                        strings ‘yes’ or ‘no’ (without
+
| DebugLevel
−
                                                        quotes).
+
| No<br>
−
                                No       100           Sets maximum acceptable
+
| 3<br>
−
                MaxCollectorPro
+
|
−
                                                        processing time of one data
+
Debug level, one of
−
                cessingTime
+
 
−
                                                        sample by collector thread (in
+
0 – none
−
                                                        milliseconds). If processing
+
 
−
                                                        time will exceed specified
+
1 – critical
−
                                                        value, warning message will
+
 
−
                                                        be written to the log file.
+
2 – errors
−
                                No       -             The parameter has no effect.
+
 
−
                NoTimeWait
+
3 – warnings
−
                                No       -             <parameter_name>,"<perf_c
+
 
−
                PerfCounter
+
4 – debug
−
                                                        ounter_path>",<period>
+
 
−
                                                        Defines       new     parameter
+
|-
−
                                                        <parameter_name> which is
+
| Include
−
                Parameter          Mandatory  Default value    Description
+
| No
−
                                                                an average value for system
+
| -
−
                                                                performance               counter
+
| Use this parameter to include a file into the configuration file. Number of parameters Include is not limited. For example: Include=c:\user_parameters. conf
−
                                                                <perf_counter_path> for the
+
|-
−
                                                                specified       time       period
+
| ListenPort
−
                                                                <period> (in seconds).
+
| No
−
                                                                For example, if you wish to
+
| 10050
−
                                                                receive average number of
+
| Port number to listen.
−
                                                                processor     interrupts     per
+
|-
−
                                                                second for last minute, you
+
| LogFile
−
                                                                can define new parameter
+
| No
−
                                                                "interrupts" as following:
+
| -
−
                                                                PerfCounter                     =
+
| Name of log file. If not set, syslog is used.
−
                                                                interrupts,"\Processor(0)\Inter
+
|-
−
                                                                rupts/sec",60
+
| LogUnresolvedSymbols
−
                                                                Please note double quotes
+
| No
−
                                                                around performance counter
+
| -
−
                                                                path. Samples for calculating
+
| Controls logging of unresolved symbols during agent startup. Values can be strings ‘yes’ or ‘no’ (without quotes).
−
                                                                average value will be taken
+
|-
−
                                                                every second.
+
| MaxCollectorProcessingTime
−
                                  No         -               The parameter has no effect.
+
| No
−
                PidFile
+
| 100
−
                                  Yes         -               Comma-delimited list of IP
+
| Sets maximum acceptable processing time of one data sample by collector thread (in milliseconds). If processing time will exceed specified value, warning message will be written to the log file.
−
                Server
+
|-
−
                                                                addresses         of     ZABBIX
+
| NoTimeWait
−
                                                                servers. Connections from
+
| No
−
                                                                other IP addresses will be
+
| -
−
                                                                rejected.
+
| The parameter has no effect.
−
                                  No         -               The parameter has no effect.
+
|-
−
                StartAgents
+
| PerfCounter
−
                                  No          -               User-defined parameter to
+
| No
−
                UserParameter
+
| -
−
                                                                monitor. There can be
+
|
−
                                                                several              user-defined
+
&lt;parameter_name&gt;,"&lt;perf_c ounter_path&gt;",&lt;period&gt; Defines new parameter &lt;parameter_name&gt; which is an average value for system performance counter &lt;perf_counter_path&gt; for the specified time period &lt;period&gt; (in seconds).
−
                                                                parameters. Value has form
+
 
−
                                                                <key>,<shell command>. Do
+
For example, if you wish to receive average number of processor interrupts per second for last minute, you can define new parameter "interrupts" as following:
−
                                                                not use spaces around pipe
+
 
−
                                                                ('|') characters!
+
PerfCounter = interrupts,"\Processor(0)\Inter rupts/sec",60
−
                                                                Example:UserParameter=test
+
 
−
                                                                ,echo 1
+
Please note double quotes around performance counter path. Samples for calculating average value will be taken every second.
 +
 
 +
You may run typeperf –qx to get list of all performance counters available in Windows.
 +
 
 +
|-
 +
| PidFile
 +
| No
 +
| -
 +
| The parameter has no effect.
 +
|-
 +
| Server
 +
| Yes
 +
| -
 +
| Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected.
 +
|-
 +
| StartAgents
 +
| No
 +
| -
 +
| The parameter has no effect.
 +
|-
 +
| UserParameter
 +
| No
 +
| -
 +
| ') characters! Example:UserParameter=test ,echo 1
 +
|}
 +
 
 
=== ZABBIX Sender (UNIX) ===
 
=== ZABBIX Sender (UNIX) ===
−
              ZABBIX UNIX Sender is a command line utility which may be used to send
 
−
              performance data to ZABBIX Server for processing.
 
  
−
              The utility is usually used in long running user scripts for periodical sending of
+
ZABBIX UNIX Sender is a command line utility which may be used to send performance data to ZABBIX Server for processing.
−
              availability and performance data.
+
 
−
              ZABBIX Sender can be started by executing:
+
The utility is usually used in long running user scripts for periodical sending of availability and performance data.
−
              shell> cd bin
+
 
−
              shell> ./zabbix_sender –z zabbix –p 10051 –h LinuxDB3 –k db.connections –o 43
+
ZABBIX Sender can be started by executing:
−
              ZABBIX Sender accepts the following command line parameters:
+
 
−
                -z –zabbix-server Hostname or IP address of ZABBIX Server.
+
shell&gt; cd bin
−
                <zabbix server>
+
  shell&gt; ./zabbix_sender –z zabbix –p 10051 –h LinuxDB3 –k db.connections –o 43
−
                -p --port <zabbix Specify port number of server trapper
+
 
−
                server port>          running on the server. Default is 10051.
+
ZABBIX Sender accepts the following command line parameters:
−
                -s –host <host Specify host name or IP address of a host.
+
 
−
                name or IP>
+
-z --zabbix-server &lt;zabbix server&gt; Hostname or IP address of ZABBIX Server.
−
                -k –key <key of Specify metric name (key) we want to send.
+
-p --port &lt;zabbix server port&gt; Specify port number of server trapper running on the server. Default is 10051.
−
                metric>
+
-s --host &lt;host name or IP&gt; Specify host name or IP address of a host.
−
                -o –value <value>      Specify value of the key.
+
-k --key &lt;key of metric&gt; Specify metric name (key) we want to send.
−
                -i       –input-file Load values from input file.
+
-o --value &lt;value&gt; Specify value of the key.
−
                <input file>
+
-i --input-file &lt;input file&gt; Load values from input file.
−
                -h –help               Give this help.
+
-h –help Give this help.
−
                -v –version           Display version number.
+
-v –version Display version number.
−
              In order to get this help run:
+
 
−
              shell> zabbix_sender -h
+
In order to get this help run:
 +
 
 +
shell&gt; zabbix_sender -h
 +
 
 
=== ZABBIX Get (UNIX) ===
 
=== ZABBIX Get (UNIX) ===
−
              ZABBIX UNIX Get is a process which communicates with ZABBIX Agent and
 
−
              retrieves required information.
 
−
              The utility is usually used for troubleshooting of ZABBIX Agents.
 
−
              ZABBIX Get can be started by executing:
 
−
              shell> cd bin
 
  
−
shell> ./zabbix_get -s127.0.0.1 -p10050 -k"system.cpu.load[all,avg1]"
+
ZABBIX UNIX Get is a process which communicates with ZABBIX Agent and retrieves required information.
 +
 
 +
The utility is usually used for troubleshooting of ZABBIX Agents.
 +
 
 +
ZABBIX Get can be started by executing:
 +
 
 +
shell&gt; cd bin
 +
shell&gt; ./zabbix_get -s127.0.0.1 -p10050 -k"system.cpu.load[all,avg1]"
 +
 
 
ZABBIX Get accepts the following command line parameters:
 
ZABBIX Get accepts the following command line parameters:
−
  -p --port     <port Specify port number of agent running on the
+
 
−
  number>              host. Default is 10050.
+
-p --port &lt;port number&gt; Specify port number of agent running on the host, Default is 10050
−
   -s –host <host Specify host name or IP address of a host.
+
   -s --host &lt;host name or IP&gt; Specify host name or IP address of a host.  
−
  name or IP>
+
   -k --key &lt;key of metric&gt; Specify metric name (key) we want to retrieve.
−
   -k –key <key of Specify metric name (key) we want to
+
   -h --help Give this help.
−
  metric>              retrieve.
+
   -v --version Display version number.
−
   -h --help             Give this help.
+
 
−
   -v --version         Display version number.
+
 
In order to get this help run:
 
In order to get this help run:
−
shell> zabbix_get -h
+
 
 +
shell&gt; zabbix_get -h

2008年4月3日 (四) 14:41的最新版本

翻译标记 ZabbixManual1.4/ZabbixProcesses正在校对翻译。
欢迎您积极参与校对与修订。


Geographylogo.png 翻译人员: 

FireHare

Geographylogo.png 点击翻译: 

English  • 中文


ZABBIX Processes

ZABBIX Server

ZABBIX Server is a central process of ZABBIX software. ZABBIX Server can be started by executing: 

shell> cd bin
shell> ./zabbix_server

ZABBIX Server runs as a daemon process.

ZABBIX Server accepts the following command line parameters: 

-c --config <file> specify configuration file, default is /etc/zabbix/zabbix_server.conf
-h --help give this help
-v --version display version number

In order to get this help run: 

shell> zabbix_server -h

Example of command line parameters: 

shell> zabbix_server –c /usr/local/etc/zabbix_server.conf
shell> zabbix_server --help
shell> zabbix_server -v

The configuration file contains parameters for zabbix_server. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:

Parameter Mandatory Default value Description
AlertScriptsPath No /home/zabbix/bin Location of scripts for user-defined media types.
DBHost Yes - Database name. Usually ‘zabbix’.
DBName Yes - Database name. Usually ‘zabbix’.
DBSocket No - DB socket name. Used for non-TCP connection to MySQL database. Example: /tmp/mysql.sock
DBPassword No NULL Database password. If password is not used, then this parameter must be commented.
DBUser No NULL User name for connecting to the database.
DebugLevel No 3 Debug level, one of

0 – none 1 – critical 2 – errors 3 – warnings 4 – debug

DisableHousekeeping No 0 If set to 1, housekeeper will be disabled.
ExternalScripts No /etc/zabbix/exter Location of scripts for external checks.
FpingLocation No /usr/sbin/fping Location of ICMP pinger. It must have setuid flag set.
HousekkepingFrequency No 1 The parameter defines how often the daemon must perform housekeeping procedure (in hours). If PostgreSQL is used set the value to 24 as it will perform command VACUUM.
Include No - Use this parameter to include a file into the configuration file. Number of parameters Include is not limited.

For example: Include=/etc/zabbix/db_conn.conf

ListenIP No - Interface to listen by trapper processes. Trapper will listen to all interfaces if this parameter is not set.
ListenPort No 10051 Port number to listen by trapper processes.
LogFile No - Name of log file. If not set, syslog is used.
LogFileSize No 1 This parameter controls log rotation setting for LogFile.By default, ZABBIX automatically roatates log file when it reaches 1MB.This parameter is in MB.If set to 0, no log rotation will be performed.
NodeID No 0 Unique NodeID (0-999). Must be ‘0’ or missing for standalone ZABBIX Server.
PidFile No /tmp/zabbix_server.pid Name of file to store PID
PingerFrequency No 30 ZABBIX server ping serversonce per PingerFrequency seconds (1-3600).
SenderFrequency No 30 The parameter defines how often the daemon must try to send alerts (in seconds)
StartDiscoverers No 1 Number of discoverers to start (0-255).
StartHTTPPollers No 5 Number of HTTP pollers to start (0-255).
StartPollers No 5 Number of pollers to start (0-255).
StartPollersUnreachable No 1 Number of pollers forunreachable hosts to start (0-255).
StartTrappers No 5 Number of trappers to start (0-255)
Timeout No 5 Do not spend more than Timeout seconds on retrieving requested value (1-255) Note: Example of the configuration file can be found at misc/conf/zabbix_server.conf
TrapperTimeout No 5 Do not spend more than Timeout seconds on processing of traps (1-255)
UnavailableDelay No 60 How ofter try to connect to unavailable host
UnreachableDelay No 15 How often try to connect to unreachable host
UnreachablePeriod No 45 If a host was unreachable for more than UnreachablePeriod seconds,change host status to Unavailable

ZABBIX Agent (UNIX, standalone daemon)

ZABBIX UNIX Agent runs on a host being monitored. The agent provides host's performance and availability information for ZABBIX Server.

ZABBIX Agent processes items of type ‘ZABBIX Agent’ or ‘ZABBIX Agent (active)’.

ZABBIX Agent can be started by executing: 

shell> cd bin
shell> ./zabbix_agentd

ZABBIX Agent runs as a daemon process.

ZABBIX Agent accepts the following command line parameters: 

-c --config <file> specify configuration file, default is /etc/zabbix/zabbix_agentd.conf
-h --help give this help
-v --version display version number
-p --print print supported metrics and exit
-t --test <metric> test specified metric and exit

In order to get this help run: 

shell> zabbix_agentd –h

Example of command line parameters: 

shell> zabbix_agentd –c /usr/local/etc/zabbix_agentd.conf
shell> zabbix_agentd –help
shell> zabbix_agentd –print
shell> zabbix_agentd –t “system.cpu.load[all,avg1]”

The configuration file contains configuration parameters for zabbix_agentd. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:

Parameter Mandatory Default value Description
DebugLevel No 3 Debug level:

0 – none 1 – critical 2 – errors 3 – warnings 4 – debug

DisableActive No 0 Disable processing of active checks. The agent will not connect to ZABBIX server to get list of active items.
EnableRemoteCommands No 0 Enable remote commands. ZABBIX server will be able to send commands for execution by the agent.
Hostname No System’s Unique host name. The hostname. hostname is used for active checks only.
Include No - Use this parameter to include a file into the configuration file. Number of parameters Include is not limited.For example: Include=/etc/zabbix/user_parameters.conf
ListenIP No - IP address to bind agent to. Useful if the host has multiple interfaces.
ListenPort No 10050 Port number to listen.
LogFile No - Name of log file. If not set, syslog is used.
LogFileSize No 1 This parameter controls log rotation setting for LogFile.By default, ZABBIX automatically roatates log file when it reaches 1MB. This parameter is in MB. If set to 0, no log rotation will be performed.
PidFile /tmp/zabbix_agentd.pid Name of PID file.
RefreshActiveChecks No 120 The agent will refresh list of active checks once per 120 (default) seconds.
Server Yes - Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected.
ServerPort No 10051 The agent will connect to this server port for processing active checks.
StartAgents No 5 Number of agents to start.
Timeout No 3 Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes!
UserParameter No - wc -l Note: Example of the configuration file can be found at misc/conf/zabbix_agentd.conf.

ZABBIX Agent (UNIX, Inetd version)

The file contains configuration parameters for zabbix_agent. The file must exist and it should have read permissions for user ‘zabbix’. Supported parameters:

Parameter Mandatory Default value Description
Server Yes - Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected.
Timeout No 3 Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes!
UserParameter No - User-defined parameter to monitor. There can be several user-defined parameters.

Example:UserParameter=use rs,who|wc -l 

Note: Example of the configuration file can be found at misc/conf/zabbix_agent.conf

ZABBIX Agent (Windows)

ZabbixW32 is ZABBIX agent for Win32 systems. It will work on Windows NT 4.0, Windows 2000, Windows XP, and Windows Vista.

Installation

Installation is very simple and includes 3 steps:

Step 1 Create configuration file.

Create configuration file c:/zabbix_agentd.conf (it has the same syntax as UNIX agent).

Step 2 Install agent as a Windows service. 

ZabbixW32.exe --install

If you wish to use configuration file other that c:\zabbix_agentd.conf, you should use the following command for service installation: 

ZabbixW32.exe --config <your_configuration_file> install

Full path to configuration file should be specified.

Step 3 Run agent.

Now you can use Control Panel to start agent's service or run: 

ZabbixW32.exe start

Windows NT 4.0 note. ZabbixW32 uses PDH (Performance Data Helper) 

Note:
 API to gather various system information, so PDH.DLL is needed. This DLL is not supplied with Windows NT 4.0, so you need to download and
 install it by yourself. Microsoft Knowledge Base article number 284996 describes this in detail and contains a download link. You can find this
 article at http://support.microsoft.com/default.aspx?scid=kb;en-us;284996

Usage

Command line syntax: 

zabbix_agentd.exe [-Vhp] [-idsx] [-c <file>] [-t <metric>]

ZABBIX Windows Agent accepts the following command line parameters:

Options: 

-c --config <file> Specify alternate configuration file (default is c:\zabbix_agentd.conf).
-h --help Display help information.
-V --version Display version number.
-p --print Print list of supported checks (metrics) and exit.
-t --test <metric> Test single check (metric) and exit.

Functions: 

-I --install Install ZABBIX agent as a service.
-d --uninstall Uninstall ZABBIX agent service.
-s --start Start ZABBIX agent service.
-x --stop Stop ZABBIX agent service.

The file contains configuration parameters for Zabbix_agentd.exe. Supported parameters:


Parameter Mandatory Default value Description
Alias No -
 Sets the alias for parameter. It can be useful to substitute long and complex parameter name with a smaller and simpler one. For example, if you wish to retrieve paging file usage in percents from the server, you may use parameter "perf_counter[\Paging File(_Total)\% Usage]", or you may define an alias by adding the following line to configuration file: Alias = pg_usage:perf_counter[\Pagi ng File(_Total)\% Usage] After that you can use parameter name "pg_usage" to retrieve the same information. You can specify as many "Alias" records as you wish. Please note that aliases cannot be used for parameters defined in "PerfCounter" configuration file records.
DebugLevel No
 3

Debug level, one of

0 – none

1 – critical

2 – errors

3 – warnings

4 – debug

Include No - Use this parameter to include a file into the configuration file. Number of parameters Include is not limited. For example: Include=c:\user_parameters. conf
ListenPort No 10050 Port number to listen.
LogFile No - Name of log file. If not set, syslog is used.
LogUnresolvedSymbols No - Controls logging of unresolved symbols during agent startup. Values can be strings ‘yes’ or ‘no’ (without quotes).
MaxCollectorProcessingTime No 100 Sets maximum acceptable processing time of one data sample by collector thread (in milliseconds). If processing time will exceed specified value, warning message will be written to the log file.
NoTimeWait No - The parameter has no effect.
PerfCounter No -

<parameter_name>,"<perf_c ounter_path>",<period> Defines new parameter <parameter_name> which is an average value for system performance counter <perf_counter_path> for the specified time period <period> (in seconds).

For example, if you wish to receive average number of processor interrupts per second for last minute, you can define new parameter "interrupts" as following:

PerfCounter = interrupts,"\Processor(0)\Inter rupts/sec",60

Please note double quotes around performance counter path. Samples for calculating average value will be taken every second.

You may run typeperf –qx to get list of all performance counters available in Windows.

PidFile No - The parameter has no effect.
Server Yes - Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected.
StartAgents No - The parameter has no effect.
UserParameter No - ') characters! Example:UserParameter=test ,echo 1

ZABBIX Sender (UNIX)

ZABBIX UNIX Sender is a command line utility which may be used to send performance data to ZABBIX Server for processing.

The utility is usually used in long running user scripts for periodical sending of availability and performance data.

ZABBIX Sender can be started by executing: 

shell> cd bin
 shell> ./zabbix_sender –z zabbix –p 10051 –h LinuxDB3 –k db.connections –o 43

ZABBIX Sender accepts the following command line parameters: 

-z --zabbix-server <zabbix server> Hostname or IP address of ZABBIX Server.
-p --port <zabbix server port> Specify port number of server trapper running on the server. Default is 10051.
-s --host <host name or IP> Specify host name or IP address of a host.
-k --key <key of metric> Specify metric name (key) we want to send.
-o --value <value> Specify value of the key.
-i --input-file <input file> Load values from input file.
-h –help Give this help.
-v –version Display version number.

In order to get this help run: 

shell> zabbix_sender -h

ZABBIX Get (UNIX)

ZABBIX UNIX Get is a process which communicates with ZABBIX Agent and retrieves required information.

The utility is usually used for troubleshooting of ZABBIX Agents.

ZABBIX Get can be started by executing: 

shell> cd bin
shell> ./zabbix_get -s127.0.0.1 -p10050 -k"system.cpu.load[all,avg1]"

ZABBIX Get accepts the following command line parameters: 

-p --port <port number> Specify port number of agent running on the host, Default is 10050
 -s --host <host name or IP> Specify host name or IP address of a host. 
 -k --key <key of metric> Specify metric name (key) we want to retrieve.
 -h --help Give this help.
 -v --version Display version number.

In order to get this help run: 

shell> zabbix_get -h
取自“https://wiki.ubuntu.org.cn/index.php?title=ZabbixManual1.4/ZabbixProcesses&oldid=77951”