# Zabbix-cli
[](https://pypi.org/project/zabbix-cli-uio/)
[](<https://pypi.org/project/zabbix-cli-uio/>)
[](<https://pypi.org/project/zabbix-cli-uio/>)
<p align="center">
<table>
<tr>
<td>
<img width="100%" src="https://github.com/unioslo/zabbix-cli/blob/master/resources/help.png?raw=true">
</td>
<td>
<img width="100%" src="https://github.com/unioslo/zabbix-cli/blob/master/resources/hosts.png?raw=true">
</td>
</tr>
<tr>
<td>
<img width="100%" src="https://github.com/unioslo/zabbix-cli/blob/master/resources/host-inventory.png?raw=true">
</td>
<td>
<img width="100%" src="https://github.com/unioslo/zabbix-cli/blob/master/resources/proxies.png?raw=true">
</td>
</tr>
</table>
</p>
**Zabbix-CLI v3 has been completely rewritten from the ground up. The old version can be found [here](https://github.com/unioslo/zabbix-cli/tree/2.3.2).**
## About
Zabbix-cli is a command line interface for performing common administrative tasks tasks in [Zabbix monitoring system](https://www.zabbix.com/) via the [Zabbix API](https://www.zabbix.com/documentation/current/en/manual/api).
The zabbix-cli code is written in [Python](https://www.python.org/) and distributed under the GNU General Public License v3. It has been developed and tested by [University Center for Information Technology](https://www.usit.uio.no/) at [the University of Oslo, Norway](https://www.uio.no/).
The project home page is on [GitHub](https://github.com/unioslo/zabbix-cli). Please report any issues or improvements there.
The manual is available online at <https://unioslo.github.io/zabbix-cli/>.
## Install
### From source
> [!NOTE]
> We are in the process of acquiring the name `zabbix-cli` on PyPI. Until then, installation must be done via the mirror package `zabbix-cli-uio`.
#### [uv](https://docs.astral.sh/uv/getting-started/installation/)
```bash
uv tool install zabbix-cli-uio
```
#### [uvx](https://docs.astral.sh/uv/#tool-management)
```bash
uvx --from zabbix-cli-uio zabbix-cli
```
#### [pipx](https://pipx.pypa.io/stable/)
```bash
pipx install zabbix-cli-uio
```
### Homebrew
A homebrew package exists, but it is maintained by a third party. It can be installed with:
```bash
brew install zabbix-cli
```
### Binary
Binaries built with PyInstaller can be found on the [releases page](https://github.com/unioslo/zabbix-cli/releases). We build binaries for Linux (x86), macOS (ARM & x86) and Windows (x86) for each release.
## Quick start
Running `zabbix-cli` for the first time will prompt for a Zabbix URL, username and password. The URL should be the URL of the Zabbix web server without the `/api_jsonrpc.php` path.
Running without arguments will start the REPL:
```bash
zabbix-cli
```
<img width="60%" src="https://github.com/unioslo/zabbix-cli/blob/master/resources/open-autocomplete.png?raw=true">
## Usage
Zabbix-cli is a command line interface for Zabbix. It can be used in three ways:
1. **Interactive mode**: Start the REPL by running `zabbix-cli`. This will start a shell where you can run multiple commands in a persistent session.
2. **Single command**: Run a single command by running `zabbix-cli COMMAND`. This will run the command and print the output.
3. **Batch mode**: Run multiple commands from a file by running `zabbix-cli -f FILE`. The file should contain one command per line.
Command reference can be found in the [online user guide](https://unioslo.github.io/zabbix-cli/commands/) or by running `zabbix-cli --help`.
### Authentication
By default, the application will prompt for a username and password. Once authenticated, the application stores the session token in a file for future use.
For more information about the various authentication methods, see the [authentication guide](https://unioslo.github.io/zabbix-cli/guide/authentication/).
### Configuration
Zabbix-cli needs a config file. It is created when the application is started for the first time. The config file can be created manually with the `init` command:
```bash
zabbix-cli init --zabbix-url https://zabbix.example.com/
```
For more detailed information about the configuration file, see the [configuration guide](https://unioslo.github.io/zabbix-cli/guide/configuration/).
### Formats
Zabbix-cli supports two output formats: table and JSON. The default format is table, but it can be changed with the `--format` parameter:
```bash
# Show hosts in table format (default)
zabbix-cli show_hosts
# Show hosts in JSON format
zabbix-cli --format json show_hosts
# Set format in REPL mode
> --format json show_hosts
```
The default format can be configured with the `app.output.format` config option:
```toml
[app.output]
format = "json"
```
#### Table
<img width="60%" alt="format-table" src="https://github.com/user-attachments/assets/207fa12b-39c6-45b9-9f0e-7f217c723461">
The default rendering mode is a [Rich](https://github.com/Textualize/rich) table that adapts to the width of the terminal.
#### JSON
<img width="60%" alt="format-json" src="https://github.com/user-attachments/assets/680f507b-dc2a-41b2-87c4-c3a443d83979">
The JSON output format is always in this format, where `ResultT` is the expected result type:
```json
{
"message": "",
"errors": [],
"return_code": "Done",
"result": ResultT
}
```
The type of the `result` field varies based on the command run. For `show_host` it is a single Host object, while for `show_hosts` it is an _array_ of Host objects.
<details>
<summary><code>show_host foo.example.com*</code></summary>
```json
{
"message": "",
"errors": [],
"return_code": "Done",
"result": {
"hostid": "10648",
"host": "foo.example.com",
"description": "",
"groups": [
{
"groupid": "22",
"name": "All-hosts",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "46",
"name": "Source-foosource",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "47",
"name": "Hostgroup-bob-hosts",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "48",
"name": "Importance-X",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "49",
"name": "Hostgroup-alice-hosts",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
}
],
"templates": [],
"inventory": {},
"monitored_by": "proxy",
"proxyid": "2",
"proxy_groupid": "0",
"maintenance_status": "0",
"active_available": "0",
"status": "0",
"macros": [],
"interfaces": [
{
"type": 1,
"ip": "",
"dns": "foo.example.com",
"port": "10050",
"useip": 0,
"main": 1,
"interfaceid": "49",
"available": 0,
"hostid": "10648",
"bulk": null,
"connection_mode": "Dns",
"type_str": "Agent"
}
],
"proxy": {
"proxyid": "2",
"name": "proxy-prod02.example.com",
"hosts": [],
"status": null,
"operating_mode": 0,
"address": "127.0.0.1",
"proxy_groupid": "1",
"compatibility": 0,
"version": 0,
"local_address": "192.168.0.1",
"local_port": "10051",
"mode": "Active",
"compatibility_str": "Undefined"
},
"zabbix_agent": "Unknown"
}
}
```
</details>
<details>
<summary><code>show_hosts foo.*</code></summary>
```json
{
"message": "",
"errors": [],
"return_code": "Done",
"result": [
{
"hostid": "10648",
"host": "foo.example.com",
"description": "",
"groups": [
{
"groupid": "22",
"name": "All-hosts",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "46",
"name": "Source-foosource",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "47",
"name": "Hostgroup-bob-hosts",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "48",
"name": "Importance-X",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
},
{
"groupid": "49",
"name": "Hostgroup-alice-hosts",
"hosts": [],
"flags": 0,
"internal": null,
"templates": []
}
],
"templates": [],
"inventory": {},
"monitored_by": "proxy",
"proxyid": "2",
"proxy_groupid": "0",
"maintenance_status": "0",
"active_available": "0",
"status": "0",
"macros": [],
"interfaces": [],
"proxy": {
"proxyid": "2",
"name": "proxy-prod02.example.com",
"hosts": [],
"status": null,
"operating_mode": 0,
"address": "127.0.0.1",
"proxy_groupid": "1",
"compatibility": 0,
"version": 0,
"local_address": "192.168.0.1",
"local_port": "10051",
"mode": "Active",
"compatibility_str": "Undefined"
},
"zabbix_agent": "Unknown"
}
]
}
```
</details>
## Development
Zabbix-cli currently uses [uv](https://docs.astral.sh/uv/) and [Hatch](https://hatch.pypa.io/latest/) for project management and packaging. To start off, clone the repository:
```bash
git clone https://github.com/unioslo/zabbix-cli.git
```
Then make a virtual environment using uv:
```bash
uv venv
```
This will create a new virtual environment, install the required dependencies and enter the environment.
### Testing
Run unit tests (without coverage):
```bash
hatch run test
```
Generate coverage report:
```bash
hatch run cov
```
### Documentation
To serve the documentation locally:
```bash
hatch run docs:serve
```
This will start a local web server on `http://localhost:8001` that is automatically refreshed when you make changes to the documentation. However, some hooks are only run on startup, such as the creation of pages for each command. Changes to command examples or docstrings will require a restart.
Raw data
{
"_id": null,
"home_page": null,
"name": "zabbix-cli-uio",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Peder Hovdan Andresen <pederhan@uio.no>",
"keywords": null,
"author": "Others (see AUTHORS)",
"author_email": "Rafael Martinez Guerrero <rafael@postgresql.org.es>, Paal Braathen <paal.braathen@usit.uio.no>, Marius Bakke <marius.bakke@usit.uio.no>",
"download_url": "https://files.pythonhosted.org/packages/db/43/d8a4b4c7ac56098397065d5ea12d1eed594886dc836483ff7a6a310ce96c/zabbix_cli_uio-3.4.1.tar.gz",
"platform": null,
"description": "# Zabbix-cli\n\n[](https://pypi.org/project/zabbix-cli-uio/)\n[](<https://pypi.org/project/zabbix-cli-uio/>)\n[](<https://pypi.org/project/zabbix-cli-uio/>)\n\n\n<p align=\"center\">\n <table>\n <tr>\n <td>\n <img width=\"100%\" src=\"https://github.com/unioslo/zabbix-cli/blob/master/resources/help.png?raw=true\">\n </td>\n <td>\n <img width=\"100%\" src=\"https://github.com/unioslo/zabbix-cli/blob/master/resources/hosts.png?raw=true\">\n </td>\n </tr>\n <tr>\n <td>\n <img width=\"100%\" src=\"https://github.com/unioslo/zabbix-cli/blob/master/resources/host-inventory.png?raw=true\">\n </td>\n <td>\n <img width=\"100%\" src=\"https://github.com/unioslo/zabbix-cli/blob/master/resources/proxies.png?raw=true\">\n </td>\n </tr>\n </table>\n</p>\n\n**Zabbix-CLI v3 has been completely rewritten from the ground up. The old version can be found [here](https://github.com/unioslo/zabbix-cli/tree/2.3.2).**\n\n## About\n\nZabbix-cli is a command line interface for performing common administrative tasks tasks in [Zabbix monitoring system](https://www.zabbix.com/) via the [Zabbix API](https://www.zabbix.com/documentation/current/en/manual/api).\n\nThe zabbix-cli code is written in [Python](https://www.python.org/) and distributed under the GNU General Public License v3. It has been developed and tested by [University Center for Information Technology](https://www.usit.uio.no/) at [the University of Oslo, Norway](https://www.uio.no/).\n\nThe project home page is on [GitHub](https://github.com/unioslo/zabbix-cli). Please report any issues or improvements there.\n\nThe manual is available online at <https://unioslo.github.io/zabbix-cli/>.\n\n## Install\n\n### From source\n\n> [!NOTE]\n> We are in the process of acquiring the name `zabbix-cli` on PyPI. Until then, installation must be done via the mirror package `zabbix-cli-uio`.\n\n#### [uv](https://docs.astral.sh/uv/getting-started/installation/)\n\n```bash\nuv tool install zabbix-cli-uio\n```\n\n#### [uvx](https://docs.astral.sh/uv/#tool-management)\n\n```bash\n\nuvx --from zabbix-cli-uio zabbix-cli\n```\n\n#### [pipx](https://pipx.pypa.io/stable/)\n\n```bash\npipx install zabbix-cli-uio\n```\n\n### Homebrew\n\nA homebrew package exists, but it is maintained by a third party. It can be installed with:\n\n```bash\nbrew install zabbix-cli\n```\n\n### Binary\n\nBinaries built with PyInstaller can be found on the [releases page](https://github.com/unioslo/zabbix-cli/releases). We build binaries for Linux (x86), macOS (ARM & x86) and Windows (x86) for each release.\n\n## Quick start\n\nRunning `zabbix-cli` for the first time will prompt for a Zabbix URL, username and password. The URL should be the URL of the Zabbix web server without the `/api_jsonrpc.php` path.\n\nRunning without arguments will start the REPL:\n\n```bash\nzabbix-cli\n```\n\n<img width=\"60%\" src=\"https://github.com/unioslo/zabbix-cli/blob/master/resources/open-autocomplete.png?raw=true\">\n\n## Usage\n\nZabbix-cli is a command line interface for Zabbix. It can be used in three ways:\n\n1. **Interactive mode**: Start the REPL by running `zabbix-cli`. This will start a shell where you can run multiple commands in a persistent session.\n2. **Single command**: Run a single command by running `zabbix-cli COMMAND`. This will run the command and print the output.\n3. **Batch mode**: Run multiple commands from a file by running `zabbix-cli -f FILE`. The file should contain one command per line.\n\nCommand reference can be found in the [online user guide](https://unioslo.github.io/zabbix-cli/commands/) or by running `zabbix-cli --help`.\n\n### Authentication\n\nBy default, the application will prompt for a username and password. Once authenticated, the application stores the session token in a file for future use.\n\nFor more information about the various authentication methods, see the [authentication guide](https://unioslo.github.io/zabbix-cli/guide/authentication/).\n\n### Configuration\n\nZabbix-cli needs a config file. It is created when the application is started for the first time. The config file can be created manually with the `init` command:\n\n```bash\nzabbix-cli init --zabbix-url https://zabbix.example.com/\n```\n\nFor more detailed information about the configuration file, see the [configuration guide](https://unioslo.github.io/zabbix-cli/guide/configuration/).\n\n### Formats\n\nZabbix-cli supports two output formats: table and JSON. The default format is table, but it can be changed with the `--format` parameter:\n\n```bash\n# Show hosts in table format (default)\nzabbix-cli show_hosts\n\n# Show hosts in JSON format\nzabbix-cli --format json show_hosts\n\n# Set format in REPL mode\n> --format json show_hosts\n```\n\nThe default format can be configured with the `app.output.format` config option:\n\n```toml\n[app.output]\nformat = \"json\"\n```\n\n#### Table\n\n<img width=\"60%\" alt=\"format-table\" src=\"https://github.com/user-attachments/assets/207fa12b-39c6-45b9-9f0e-7f217c723461\">\n\nThe default rendering mode is a [Rich](https://github.com/Textualize/rich) table that adapts to the width of the terminal.\n\n#### JSON\n\n<img width=\"60%\" alt=\"format-json\" src=\"https://github.com/user-attachments/assets/680f507b-dc2a-41b2-87c4-c3a443d83979\">\n\nThe JSON output format is always in this format, where `ResultT` is the expected result type:\n\n```json\n{\n \"message\": \"\",\n \"errors\": [],\n \"return_code\": \"Done\",\n \"result\": ResultT\n}\n```\n\nThe type of the `result` field varies based on the command run. For `show_host` it is a single Host object, while for `show_hosts` it is an _array_ of Host objects.\n\n<details>\n <summary><code>show_host foo.example.com*</code></summary>\n\n ```json\n{\n \"message\": \"\",\n \"errors\": [],\n \"return_code\": \"Done\",\n \"result\": {\n \"hostid\": \"10648\",\n \"host\": \"foo.example.com\",\n \"description\": \"\",\n \"groups\": [\n {\n \"groupid\": \"22\",\n \"name\": \"All-hosts\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"46\",\n \"name\": \"Source-foosource\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"47\",\n \"name\": \"Hostgroup-bob-hosts\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"48\",\n \"name\": \"Importance-X\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"49\",\n \"name\": \"Hostgroup-alice-hosts\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n }\n ],\n \"templates\": [],\n \"inventory\": {},\n \"monitored_by\": \"proxy\",\n \"proxyid\": \"2\",\n \"proxy_groupid\": \"0\",\n \"maintenance_status\": \"0\",\n \"active_available\": \"0\",\n \"status\": \"0\",\n \"macros\": [],\n \"interfaces\": [\n {\n \"type\": 1,\n \"ip\": \"\",\n \"dns\": \"foo.example.com\",\n \"port\": \"10050\",\n \"useip\": 0,\n \"main\": 1,\n \"interfaceid\": \"49\",\n \"available\": 0,\n \"hostid\": \"10648\",\n \"bulk\": null,\n \"connection_mode\": \"Dns\",\n \"type_str\": \"Agent\"\n }\n ],\n \"proxy\": {\n \"proxyid\": \"2\",\n \"name\": \"proxy-prod02.example.com\",\n \"hosts\": [],\n \"status\": null,\n \"operating_mode\": 0,\n \"address\": \"127.0.0.1\",\n \"proxy_groupid\": \"1\",\n \"compatibility\": 0,\n \"version\": 0,\n \"local_address\": \"192.168.0.1\",\n \"local_port\": \"10051\",\n \"mode\": \"Active\",\n \"compatibility_str\": \"Undefined\"\n },\n \"zabbix_agent\": \"Unknown\"\n }\n}\n ```\n\n</details>\n\n<details>\n <summary><code>show_hosts foo.*</code></summary>\n\n ```json\n{\n \"message\": \"\",\n \"errors\": [],\n \"return_code\": \"Done\",\n \"result\": [\n {\n \"hostid\": \"10648\",\n \"host\": \"foo.example.com\",\n \"description\": \"\",\n \"groups\": [\n {\n \"groupid\": \"22\",\n \"name\": \"All-hosts\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"46\",\n \"name\": \"Source-foosource\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"47\",\n \"name\": \"Hostgroup-bob-hosts\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"48\",\n \"name\": \"Importance-X\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n },\n {\n \"groupid\": \"49\",\n \"name\": \"Hostgroup-alice-hosts\",\n \"hosts\": [],\n \"flags\": 0,\n \"internal\": null,\n \"templates\": []\n }\n ],\n \"templates\": [],\n \"inventory\": {},\n \"monitored_by\": \"proxy\",\n \"proxyid\": \"2\",\n \"proxy_groupid\": \"0\",\n \"maintenance_status\": \"0\",\n \"active_available\": \"0\",\n \"status\": \"0\",\n \"macros\": [],\n \"interfaces\": [],\n \"proxy\": {\n \"proxyid\": \"2\",\n \"name\": \"proxy-prod02.example.com\",\n \"hosts\": [],\n \"status\": null,\n \"operating_mode\": 0,\n \"address\": \"127.0.0.1\",\n \"proxy_groupid\": \"1\",\n \"compatibility\": 0,\n \"version\": 0,\n \"local_address\": \"192.168.0.1\",\n \"local_port\": \"10051\",\n \"mode\": \"Active\",\n \"compatibility_str\": \"Undefined\"\n },\n \"zabbix_agent\": \"Unknown\"\n }\n ]\n}\n ```\n\n</details>\n\n## Development\n\nZabbix-cli currently uses [uv](https://docs.astral.sh/uv/) and [Hatch](https://hatch.pypa.io/latest/) for project management and packaging. To start off, clone the repository:\n\n```bash\ngit clone https://github.com/unioslo/zabbix-cli.git\n```\n\nThen make a virtual environment using uv:\n\n```bash\nuv venv\n```\n\nThis will create a new virtual environment, install the required dependencies and enter the environment.\n\n### Testing\n\nRun unit tests (without coverage):\n\n```bash\nhatch run test\n```\n\nGenerate coverage report:\n\n```bash\nhatch run cov\n```\n\n### Documentation\n\nTo serve the documentation locally:\n\n```bash\nhatch run docs:serve\n```\n\nThis will start a local web server on `http://localhost:8001` that is automatically refreshed when you make changes to the documentation. However, some hooks are only run on startup, such as the creation of pages for each command. Changes to command examples or docstrings will require a restart.\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "ZABBIX-CLI - Zabbix terminal client",
"version": "3.4.1",
"project_urls": {
"Documentation": "https://github.com/unioslo/zabbix-cli#readme",
"Issues": "https://github.com/unioslo/zabbix-cli/issues",
"Source": "https://github.com/unioslo/zabbix-cli"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "287f923ab48d49b899feafd4c94ce88b97f6ba9854580b8dc659748bb9ecc63c",
"md5": "e434769f1a44eae7d8fa5273a582d798",
"sha256": "a2d4caa98f9e99a3d79bd2fdc1bf53d23941d39b52735fc1ea0a0ebc7387cb0b"
},
"downloads": -1,
"filename": "zabbix_cli_uio-3.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e434769f1a44eae7d8fa5273a582d798",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 203846,
"upload_time": "2024-12-04T14:00:44",
"upload_time_iso_8601": "2024-12-04T14:00:44.571763Z",
"url": "https://files.pythonhosted.org/packages/28/7f/923ab48d49b899feafd4c94ce88b97f6ba9854580b8dc659748bb9ecc63c/zabbix_cli_uio-3.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "db43d8a4b4c7ac56098397065d5ea12d1eed594886dc836483ff7a6a310ce96c",
"md5": "2d40a98b4fc0103198e43f402b1010b0",
"sha256": "815291edd021feec3c4e6cd018c22bafe5f74fc4c70cd3afd47028a73e74bd2b"
},
"downloads": -1,
"filename": "zabbix_cli_uio-3.4.1.tar.gz",
"has_sig": false,
"md5_digest": "2d40a98b4fc0103198e43f402b1010b0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 166218,
"upload_time": "2024-12-04T14:00:45",
"upload_time_iso_8601": "2024-12-04T14:00:45.898213Z",
"url": "https://files.pythonhosted.org/packages/db/43/d8a4b4c7ac56098397065d5ea12d1eed594886dc836483ff7a6a310ce96c/zabbix_cli_uio-3.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-04 14:00:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "unioslo",
"github_project": "zabbix-cli#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "zabbix-cli-uio"
}
JSON
