---
name: "zabbix_agent2"
section: "8"
platform: "linux"
package: "zabbix-agent2"
version: "7.4.16-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/zabbix_agent2"
---

# zabbix\_agent2(8)

Zabbix agent 2

## NAME

zabbix\_agent2 - Zabbix agent 2

## SYNOPSIS

**zabbix\_agent2** \[**-c** *config-file*\]\
 **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\
 **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\
 **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option* \[*parameters...*\]\
 **zabbix\_agent2** \[**-c** *config-file*\] **-T**\
 **zabbix\_agent2 -h**\
 **zabbix\_agent2 -V**

## DESCRIPTION

**zabbix\_agent2** is an application for monitoring parameters of various services.

## OPTIONS

- **-c**, **--config** *config-file*

  Use the alternate *config-file* instead of the default one.

- **-R**, **--runtime-control** *runtime-option* \[*parameters...*\]

  Perform administrative functions according to *runtime-option* and any parameters it accepts.

### Runtime control options

- **userparameter\_reload**

  Reload user parameters from the configuration file

- **periodic\_prof\_enable**

  Enable periodic profiling

  Periodic CPU data is collected into a hidden temporary file. When an interval ends, the file is published as a CPU profile and the configured number of completed files is retained. The temporary file does not count toward ProfilerMaxFilesPerProfile.

- **periodic\_prof\_disable**

  Disable periodic profiling

- **periodic\_prof\_execute**

  Write profiles after a 5-second sample

  When periodic profiling is enabled, this command finishes the current CPU interval, writes a separate 5-second CPU profile, and starts a new periodic CPU file. Explicitly requested profiles are rotated according to ProfilerMaxFilesPerProfile when the command completes. While this command is collecting profiles, all profiler runtime commands are rejected with "profiler is busy".

- **periodic\_prof\_set\_interval** *seconds*

  Set profiling interval

- **log\_level\_increase**

  Increase log level

- **log\_level\_decrease**

  Decrease log level

- **help**

  List available runtime control options

- **metrics**

  List available metrics

- **version**

  Display version

- **-p**, **--print**

  Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are:

  - d

    Number with a decimal part.

  - m

    Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state.

  - s

    Text. Maximum length not limited.

  - t

    Text. Same as **s**.

  - u

    Unsigned integer.

- **-t**, **--test** *item-key*

  Test single item and exit. See **--print** for output description.

- **-v**, **--verbose**

  Enable verbose output when test item or print known items.

- **-T**, **--test-config**

  Validate configuration file and exit.

- **-h**, **--help**

  Display this help and exit.

- **-V**, **--version**

  Output version information and exit.

## FILES

- */usr/local/etc/zabbix\_agent2.conf*

  Default location of Zabbix agent 2 configuration file (if not modified during compile time).

## SEE ALSO

Documentation

[**zabbix\_agentd**(8)](/zabbix_agentd/8.md), [**zabbix\_get**(1)](/zabbix_get/1.md), [**zabbix\_proxy**(8)](/zabbix_proxy/8.md), [**zabbix\_sender**(1)](/zabbix_sender/1.md), [**zabbix\_server**(8)](/zabbix_server/8.md), **zabbix\_js**(1), [**zabbix\_web\_service**(8)](/zabbix_web_service/8.md)