Table of Contents
1 Ceph plugin
Overview
The configuration file of Zabbix agent 2 is used to configure plugins. These Zabbix agent 2 configuration parameters are supported for operating the Ceph plugin.
It is recommended to specify them in their own configuration file (e.g. ceph.conf) and then use the Include directive for adding this file to the Zabbix agent 2 configuration.
Note that:
- The default values reflect process defaults, not the values in the shipped configuration files;
- Values support environment variables;
- Zabbix supports configuration files only in UTF-8 encoding without BOM;
- Comments starting with "#" are only supported at the beginning of the line.
Parameters
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| Plugins.Ceph.Default.ApiKey | no | Default API key for connecting to Ceph; used if no value is specified in an item key or named session. | ||
| Plugins.Ceph.Default.Mode | no | native / restful | restful (deprecated) | Default mode for connecting to Ceph. The native mode is only supported on Linux and starting with Ceph 16. The restful mode will not work with Ceph version 20 or newer. Note that the user credential set differs for each mode and they are not compatible with each other. |
| Plugins.Ceph.Default.User | no | Default username for connecting to Ceph; used if no value is specified in an item key or named session. | ||
| Plugins.Ceph.Default.Uri | no | https://localhost:8003 | Default URI for connecting to Ceph; used if no value is specified in an item key or named session. Should not include embedded credentials (they will be ignored). Must match the URI format. Only https scheme is supported; a scheme can be omitted.A port can be omitted (default=8003). Examples: https://127.0.0.1:8003localhost |
|
| Plugins.Ceph.InsecureSkipVerify | no | false / true | false | Determines whether an http client should verify the server's certificate chain and host name. If true, TLS accepts any certificate presented by the server and any host name in that certificate. In this mode, TLS is susceptible to man-in-the-middle attacks (should be used only for testing). |
| Plugins.Ceph.KeepAlive | no | 60-900 | 300 | The maximum time of waiting (in seconds) before unused plugin connections are closed. |
| Plugins.Ceph.Sessions.<SessionName>.ApiKey | no | Named session API key. <SessionName> - define name of a session for using in item keys. |
||
| Plugins.Ceph.Sessions.<SessionName>.Mode | no | native / restful | restful (deprecated) | Named session mode for connecting to Ceph. The native mode is only supported on Linux and starting with Ceph 16. The restful mode will not work with Ceph version 20 or newer. Note that the user credential set differs for each mode and they are not compatible with each other. |
| Plugins.Ceph.Sessions.<SessionName>.User | no | Named session username. <SessionName> - define name of a session for using in item keys. |
||
| Plugins.Ceph.Sessions.<SessionName>.Uri | no | Connection string of a named session. <SessionName> - define name of a session for using in item keys. Should not include embedded credentials (they will be ignored). Must match the URI format. Only https scheme is supported; a scheme can be omitted.A port can be omitted (default=8003). Examples: https://127.0.0.1:8003localhost |
||
| Plugins.Ceph.Timeout | no | 1-30 | global timeout | Request execution timeout (the duration, in seconds, to wait for a request to complete before shutting it down). |
See also:
- Description of general Zabbix agent 2 configuration parameters: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instructions for configuring plugins