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.
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
/ 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
Show triggers that have changed their state after the given time, default: 7
days ago
-u --until
Show triggers that have changed their state before the given time.
-m --maintenance
Show hosts in maintenance.
-i --sort
Show triggers sorted by specified fields, default: lastchange,priority.
-o --order
Show triggers in specified order, default: DESC.
-n --limit
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 / 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 to specified users group.
-r --remove
Remove specified 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 / argument, for example, search maintenance match the
word 'update-kernel':
zabbixctl -M dbnode-* /update-kernel
-a --add
Add new specified with timeperiod type once.
-r --remove
Remove specified .
-H --hosts
Search and operate with host.
zabbixctl -H dbnode-*
-r --remove
Remove specified .
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
zabbixctlp -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.