ENTERPRISE: Built-in integrations are available for Sensu Enterprise users only.

IRC Integration

Overview

Send notifications to an Internet Relay Chat (IRC) channel for events.

Configuration

Example(s)

The following is an example global configuration for the irc enterprise event handler (integration).

{
  "irc": {
    "uri": "irc://nick:pass@example.com:6697/#ops",
    "ssl": true,
    "nickserv_password": "NICKSERV_PASSWORD",
    "channel_password": "CHANNEL_PASSWORD",
    "join": false,
    "timeout": 10
  }
}

Integration Specification

irc attributes

The following attributes are configured within the {"irc": {} } configuration scope.

uri
description
The IRC URI; including the nick, password, address, port, and channel.
required
true
type
String
example
"uri": "irc://nick:pass@example.com:6697/#ops"
ssl
description
If SSL encryption is used for the IRC connection.
required
false
type
Boolean
default
false
example
"ssl": true
channel_password
description
The IRC channel password (if required).
required
false
type
String
example
"channel_password": "secret"
nickserv_password
description
Identify with NickServ (if required).
required
false
type
String
example
"nickserv_password": "secret"
join
description
If the handler must join the IRC channel before messaging.
required
false
type
Boolean
default
false
example
"join": true
timeout
description
The handler execution duration timeout in seconds (hard stop).
required
false
type
Integer
default
10
example
"timeout": 30

Start your FREE trial today.

Already using Sensu Core? Upgrade to Sensu Enterprise today to take advantage of its enterprise console, added-value features, built-in integrations, FREE annual training, and enterprise-class support.