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

• Zabbix server
• Rundeck server
• Go 1.13.x

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.