elonen / slack-zabbix-action-bot

Simple interactive Slack bot for Zabbix. Activate maintenance periods and list issues.

Slack Zabbix Action Bot

A simple, interactive Slack bot integrating with the Zabbix monitoring system. List active problems and activate maintenance periods using socket mode and Zabbix jsonrpc API. For real-time notifications, use incoming webhooks. Runs as a systemd service.

Usage

1. Create Slack app, install to workspace using the manifest below:

   display_information:
   name: Zabbix bot
   description: Sysops Zabbix monitoring bot
   background_color: "#7a1600"
   features:
   bot_user:
       display_name: Zabbix
       always_online: false
   oauth_config:
   scopes:
       bot:
       - app_mentions:read
       - chat:write
       - chat:write.customize
       - commands
       - im:write
       - incoming-webhook
       - reactions:write
       - reactions:read
   settings:
   event_subscriptions:
       bot_events:
       - app_mention
   interactivity:
       is_enabled: true
   org_deploy_enabled: false
   socket_mode_enabled: true
   token_rotation_enabled: false

2. Create Zabbix user with API token. Needs permissions to update maintenance periods and list active problems.

3. Configure bot in config.ini (Slack app token, Zabbix API URL/token, bot mention name and allowed channel IDs).

4. Install with install.sh or manually.

5. Test bot with commands (e.g. @zabbix_bot list).

The bot can be installed as a systemd service using the install.sh script.

Bot Commands

• list or problems: List active problems
• mute or maintenance: Show a form to activate a maintenance period

Trigger command by mentioning the bot with a keyword: @zabbix mute. Shows usage if no keyword is given.

License

Copyright 2023 by Jarno Elonen.

Licensed under the MIT License.