README ¶
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
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
Show only not acknowledged triggers.
Specify minimum trigger severity. Once for information, twice for warning, three for disaster, four for high, five for disaster.
Show triggers that have a problem state.
Show triggers that have recently been in a problem state.
Show triggers that have changed their state after the given time, default: 7 days ago
Show triggers that have changed their state before the given time.
Show hosts in maintenance.
Show triggers sorted by specified fields, default: lastchange,priority.
Show triggers in specified order, default: DESC.
Show specified amount of triggers.
Acknowledge all retrieved triggers.
Do not prompt acknowledge confirmation dialog.
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
Show links on graph pages.
Search and operate on configuration of users groups.
Show list users in specified users group.
Add specified to specified users group.
Remove specified from speicifed users group.
Do not prompt confirmation dialog.
Returns single link which points to the stacked or normal graph for matched items.
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
Add new specified with timeperiod type once.
Remove specified .
Search and operate with host.
zabbixctl -H dbnode-*
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
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.
Source Files ¶
- config.go
- docs.go
- function.go
- group.go
- handle_hosts.go
- handle_latest_data.go
- handle_maintenances.go
- handle_triggers.go
- handle_users_groups.go
- history.go
- host.go
- httptest.go
- item.go
- item_type.go
- log.go
- main.go
- maintenance.go
- parse_date_linux.go
- responses.go
- search.go
- severity.go
- spinner.go
- timeperiod.go
- trigger.go
- users.go
- zabbix.go