zabbixctl

zabbixctl is tool for working with zabbix server api using command line interface, it provides effective way for operating on statuses of triggers, hosts latest data and groups of users.

State of the project

I don't use zabbix daily anymore. Therefore, I don't commit into the project. But I'm still here and I'm willing to accept your contributions.

Installation

go get github.com/kovetskiy/zabbixctl

afterwards executable will be placed as $GOPATH/bin/zabbixctl

Configuration

zabbixctl must be configurated before using, configuration file should be placed in ~/.config/zabbixctl.conf and must be written using following syntax:

[server]
  address  = "zabbix.local"
  username = "admin"
  password = "password"

[session]
  path = "~/.cache/zabbixctl.session"

zabbixctl will authorize in 'zabbix.local' server using given user credentials and save a zabbix session to a file ~/.cache/zabbixctl.session and at second run will use saved session instead of new authorization, by the way zabbix sessions have a ttl that by default equals to 15 minutes, so if saved zabbix session is outdated, zabbixctl will repeat authorization and rewrite the session file.

Usage

-T --triggers

Search on zabbix triggers statuses. Triggers could be filtered using /<pattern> argument, for example, search and acknowledge all triggers in a problem state and match the word 'cache':

  zabbixctl -Tp /cache

-y --only-nack

Show only not acknowledged triggers.

-x --severity

Specify minimum trigger severity. Once for information, twice for warning, three for disaster, four for high, five for disaster.

-p --problem

Show triggers that have a problem state.

-r --recent

Show triggers that have recently been in a problem state.

-s --since <date>

Show triggers that have changed their state after the given time, default: 7 days ago

-u --until <date>

Show triggers that have changed their state before the given time.

-m --maintenance

Show hosts in maintenance.

-i --sort <fields>

Show triggers sorted by specified fields, default: lastchange,priority.

-o --order <order>

Show triggers in specified order, default: DESC.

-n --limit <amount>

Show specified amount of triggers.

-k --acknowledge

Acknowledge all retrieved triggers.

-f --noconfirm

Do not prompt acknowledge confirmation dialog.

-L --latest-data

Search and show latest data for specified host(s). Hosts can be searched using wildcard character '*'. Latest data can be filtered using /<pattern> argument, for example retrieve latest data for database nodes and search information about replication:

zabbixctl -L dbnode* /replication

-g --graph

Show links on graph pages.

-G --groups

Search and operate on configuration of users groups.

-l --list

Show list users in specified users group.

-a --add

Add specified <user> to specified users group.

-r --remove

Remove specified <user> from speicifed users group.

-f --noconfirm

Do not prompt confirmation dialog.

-w --stacked | -b --normal

Returns single link which points to the stacked or normal graph for matched items.

-M --maintenances

Search and operate on configuration of maintenance. Maintenance could be filtered using /<pattern> argument, for example, search maintenance match the word 'update-kernel':

zabbixctl -M dbnode-* /update-kernel

-a --add

Add new specified <maintenance> with timeperiod type once.

-r --remove

Remove specified <maintenance>.

-H --hosts

Search and operate with host.

zabbixctl -H dbnode-*

-r --remove

Remove specified <host>.

Examples

Listing triggers in a problem state

zabbixctl -Tp

Listing triggers that have recenty been in a problem state

zabbixctl -Tr

Listing and filtering triggers that contain a word mysql

zabbixctl -T /mysql

Listing and acknowledging triggers that severity level is DISASTER

zabbixctl -T -xxxxx -k

Listing latest data for db nodes and filtering for information about replication lag

zabbixctl -L dbnode* /lag

Opening stacked graph for CPU quote use of selected containers

zabbixctl -L 'container-*' /cpu quota --stacked

Listing users groups that starts with 'HTTP_'

zabbixctl -G HTTP_*

Listing users groups that contain user admin

zabbixctl -G /admin

Adding user admin to groups that contain user guest

zabbixctl -G /guest -a admin

Listing maintenances period

zabbixctl -M

Listing maintenances period with hostname like 'dbnode*'

zabbixctl -M dbnode*

Listing maintenances period with hostname like 'dbnode*' with filter

maintenance name update-kernel

zabbixctl -M dbnode* /update-kernel

Add maintenance period name update-kernel with hostname like 'dbnode*'

zabbixctl -M dbnode* -a update-kernel

Add maintenance period name update-kernel with host from stdin (must be flag -f)

axfr is a tool of your choice for retrieving domain information from your infrastructure DNS.

axfr | grep phpnode | zabbixctl -M -z -a update-kernel -f

Add maintenance period name update-kernel with hostname like 'dbnode*' and read additional

host from stdin (must be flag -f)

axfr is a tool of your choice for retrieving domain information from your infrastructure DNS.

axfr | grep phpnode | zabbixctl -M -z dbnode* -a update-kernel -f

Remove maintenance period name update-kernel

zabbixctl -M -r update-kernel

Search host with hostname like 'dbnode*'

zabbixctl -H dbnode*

Remove host with hostname 'dbnode1' (full uniq name)

zabbixctl -H -r dbnode1

License

MIT.