How to Integrate Humio with Google Chat and Slack


Many software development companies use Slack or G-Suite at a regular basis. Both solutions can be used for knowledge sharing, internal chatter, meetings and for various other communicative purposes within an organisation.

In development situations, real time performance and insight into the app, software or system, is critical. The more feedback developers are able to retrieve from the system, the better. 

From an operation perspective, real time notifications when an error, a warning or certain security related events occur, could become critical.

The faster the developer, operation technician or service desk staff receives these information, the faster incidents, events or errors can be fixed. 

For a more smooth reading, the following is presumed throughout the rest of this guide.

When referred to a room, this could be either a Google Chat room or a Slack channel. 

Humio, a fast growing log management system, has the ability to fulfill the requests mentioned above. Cheap licensing plans and even a flat rate plan, so you’re able to log as much data as needed, without worrying about exceeding your license. Real time searches to monitor system errors, warnings or even system performance metrics.

Besides the amazing features, Humio offers integration to a variety of third party systems, for instance Slack and Google Chat. 

This guide helps with integrations towards both systems, since they both use the webhook option in Humio. The guide is split up into three sections. The first addressing how you should integrate with Slack, and the second concerning how to integrate with Google Chat. The third section deals with how to Configure Humio to use these webhooks. 

Part One: How to integrate with Slack

This first part guides you through the process of sending Humio alerts to a specific channel on Slack.

However, this guide will NOT describe how to create a slack channel. It’s assumed that the channel has been created beforehand. 

First, open your Slack workspace and click on the Apps in the left menu. The highlighted text is “Browse Apps”. 

image-6

In the Browse Apps window, search for webhook and press Install on the Incoming Webhooks app.

image-7
In the next window, press ‘Connect’ at the left side of the screen.

image-8
Then you’ll have to choose which channel you want the Webhook to send data to. (In this example we have chosen # awesomeness )

Press the Add Incoming WebHooks integration button in the middle of the screen.

image-9
Next, you’re able to customize the Webhook a bit, but the most important part is to copy the webhook URL - you’ll need this in Humio.

However, you should notice that it’s in the Integration Settings part of the screen and you have to scroll down a bit, since the first couple of messages are reference guides with some cool features. 

image-10
When done customizing, press Save Settings and you are done. 

Just to verify you could switch to the slack channel you chose and see if there is a new integration:

image-11
Done - Webhook configured. If you aren’t going to use the Google Chat, you might as well go to part three of this guide.


Part Two: How to integrate with Google Chat

First, you will need a chatroom. In this example we’ve chosen the room “Marketplace”. 

Open the chatroom, create the webhook and provide it with a name and press Save. 

image-12
image-13
You can choose to use a custom Avatar, which looks really cool. However, it’s optional. After saving the webhook, copy the URL for later use.

image-14

Easy, right? 

Part Three: How to configure Humio

Log on to your Humio installation and choose the repository (linux_metrics in this example) where your alert is running.

Click on “Alerts” in the top bar after choosing a repository and click on ‘Notifiers’ to the left, then click on ‘New Notifier’ in the upper right hand corner.

image-15
The most important part is the formatting of the message body:

image-16

It’s important to use the { ‘text’ : ‘ ‘ }-format and remember to make sure that you place your message within the last two apostrophes. 

It’s possible to use the variables from the right-hand side of the screen. 

A piece of good advice: Make sure your alert is as specific as possible. Otherwise you might be flooded with messages in the chatroom. Experience has taught me that too many messages can be just as bad as too few, simply because you lose track of things. 

References: https://www.humio.com, https://developers.google.com/hangouts/chat/ for inspiration.  

Share content