https://github.com/mlabouardy/icinga2-slack-bot

Icinga2 Slack bot
https://github.com/mlabouardy/icinga2-slack-bot

bot icinga icinga2 slack slack-bot slackapi slackbot

Last synced: 6 months ago
JSON representation

Icinga2 Slack bot

• Host: GitHub
• URL: https://github.com/mlabouardy/icinga2-slack-bot
• Owner: mlabouardy
• License: mit
• Created: 2017-07-25T20:42:20.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2017-07-30T13:27:01.000Z (about 8 years ago)
• Last Synced: 2025-04-12T20:52:32.334Z (6 months ago)
• Topics: bot, icinga, icinga2, slack, slack-bot, slackapi, slackbot
• Language: Go
• Size: 227 KB
• Stars: 8
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## Icinga2 Slack Bot [![CircleCI](https://circleci.com/gh/mlabouardy/icinga2-slack-bot/tree/master.svg?style=svg)](https://circleci.com/gh/mlabouardy/icinga2-slack-bot/tree/master) [![Go Report Card](https://goreportcard.com/badge/github.com/mlabouardy/icinga2-slack-bot)](https://goreportcard.com/report/github.com/mlabouardy/icinga2-slack-bot) [![Gitter chat](https://badges.gitter.im/icinga2bot/Lobby.png)](https://gitter.im/icinga2bot/Lobby) [![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)

This bot uses Icinga2 remote API to fetch the status of the services & hosts running in icinga2

## Requirements

* Go >= 1.8.0

* Icinga2 with API feature enabled

## Deploy

To deploy your icinga2 bot to Slack, you need to:

* [Create a new bot user](https://my.slack.com/services/new/bot) integration on Slack and get your token

* Setup icinga2 credentials & slack token in config.toml file

* Execute `go run $(ls -1 *.go | grep -v _test.go)`

## With Docker

```

$ git clone git@github.com:mlabouardy/icinga2-slack-bot.git

$ cd icinga2-slack-bot

$ docker build -t icinga2-bot .

$ docker run -d --name bot icinga2-bot

```

or just use the official DockerHub image:

```

$ docker run -d -v /PATH/TO/config.toml:/go/src/github/config.toml --name bot mlabouardy/icinga2-bot:slack

```

## Available commands

![alt text](https://raw.githubusercontent.com/mlabouardy/icinga2-slack-bot/master/screenshots/help.png)

### Get all hosts

![alt text](https://raw.githubusercontent.com/mlabouardy/icinga2-slack-bot/master/screenshots/hosts.png)

### Filter by host name

![alt text](https://raw.githubusercontent.com/mlabouardy/icinga2-slack-bot/master/screenshots/host.png)

### Get all services

![alt text](https://raw.githubusercontent.com/mlabouardy/icinga2-slack-bot/master/screenshots/services.png)

### Filter by service name

![alt text](https://raw.githubusercontent.com/mlabouardy/icinga2-slack-bot/master/screenshots/service.png)

## Features

- [x] All hosts status

- [x] Single host status

- [x] All services status

- [x] Single service status

- [x] Docker support

## Contributors

- Mohamed Labouardy