rundeck-zabbix is a Runbook automation tool, that integrates Zabbix trigger-based actions into Rundeck. It is based on https://kosyfrances.github.io/rundeck-zabbix/ and built with Zabbix API v4.2 and Rundeck API v30.
Basic flow:
- A service stops running
- Zabbix fires trigger
- Zabbix action calls rundeck-zabbix
- rundeck-zabbix executes job on Rundeck
- rundeck-zabbix sends acknowledgement to Zabbix
- Zabbix receives acknowledgement
- Ops continues partying, nothing left for them to do
Get the latest release, unarchive and build with:
# For build specific to your machine's OS
make build
# For Linux OS
make build-linux
There is more information here on how to compile Go packages and dependencies.
Run rundeck-zabbix help
to get list of available commands.
You'd need the following information:
- Zabbix Server URL in the form of
https://ZABBIX_URL/api_jsonrpc.php
- Zabbix username and password (required to generate Zabbix API key)
- Rundeck URL
- Rundeck API key (usually gotten from
https://RUNDECK_URL:4440/user/profile
)
rundeck-zabbix setup --config=/path/to/dir/.config.json
where /path/to/dir
already exists.
Logs can be found in /tmp/rundeck-zabbix.log
.
Rundeck uses a resource document to declare the resource models used by a project to define the set of Nodes that are available. This file is usually found in /etc/rundeck/projects/project_name/
or /var/rundeck/projects/project_name
in the Rundeck server.
To map Zabbix hosts to Rundeck nodes, run the following to generate a resources.yml
template and modify as appropriate. You can read more about node entries here and format yours appropriately.
rundeck-zabbix generate resources --config=/path/to/dir/.config.json
Do not forget to add the existing Rundeck’s localhost
resource definition gotten from the original resource document file in the server. The localhost resource definition looks like this:
localhost:
description: Rundeck server
hostname: localhost
nodename: localhost
osArch: amd64
osFamily: unix
osName: Linux
osVersion: 4.4.0-66-generic
tags: 'localhost'
username: rundeck
Copy the file over to /etc/rundeck/projects/project_name/resources.yml
or /var/rundeck/projects/project_name/resources.yml
on Rundeck’s server.
To map Zabbix triggers to Rundeck jobs, run the following to generate a jobs.yml
template and modify as appropriate. Update the commands
section with the appropriate command you want Rundeck to execute. You can read more about job entries here and format yours appropriately.
rundeck-zabbix generate jobs --config=/path/to/dir/.config.json
Next, load the jobs file to Rundeck.
The remote command for Zabbix action will be
rundeck-zabbix run job --project=RUNDECK-PROJECT --trigger={TRIGGER.NAME} --event={EVENT.ID} --config="/path/to/.config.json"
Refer to the dev setup guide.
Refer to the contributing guide.
We use SemVer for versioning. For the versions available, see the tags on this repository.
See the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE file for details
Special thanks to Femi and Oscar for helping out with code reviews.