Skip to main content

IRC

This is what you will get:

IRCCloud web client:\ image

Irssi terminal client: image

You need:

  1. The nc utility. If you do not set the path, Netdata will search for it in your system $PATH.

Set the path for nc in /etc/netdata/health_alarm_notify.conf (to edit it on your system run /etc/netdata/edit-config health_alarm_notify.conf), like this:

#------------------------------------------------------------------------------
# external commands
#
# The full path of the nc command.
# If empty, the system $PATH will be searched for it.
# If not found, irc notifications will be silently disabled.
nc="/usr/bin/nc"
  1. Αn IRC_NETWORK to which your preferred channels belong to.
  2. One or more channels ( DEFAULT_RECIPIENT_IRC ) to post the messages to.
  3. An IRC_NICKNAME and an IRC_REALNAME to identify in IRC.

Set them in /etc/netdata/health_alarm_notify.conf (to edit it on your system run /etc/netdata/edit-config health_alarm_notify.conf), like this:

#------------------------------------------------------------------------------
# irc notification options
#
# irc notifications require only the nc utility to be installed.
# multiple recipients can be given like this:
# "<irc_channel_1> <irc_channel_2> ..."
# enable/disable sending irc notifications
SEND_IRC="YES"
# if a role's recipients are not configured, a notification will not be sent.
# (empty = do not send a notification for unconfigured roles):
DEFAULT_RECIPIENT_IRC="#system-alarms"
# The irc network to which the recipients belong. It must be the full network.
IRC_NETWORK="irc.freenode.net"
# The irc nickname which is required to send the notification. It must not be
# an already registered name as the connection's MODE is defined as a 'guest'.
IRC_NICKNAME="netdata-alarm-user"
# The irc realname which is required in order to make the connection and is an
# extra identifier.
IRC_REALNAME="netdata-user"

You can define multiple channels like this: #system-alarms #networking-alarms.\ You can also filter the notifications like this: #system-alarms|critical.\ You can give different channels per role using these (at the same file):

role_recipients_irc[sysadmin]="#user-alarms #networking-alarms #system-alarms"
role_recipients_irc[dba]="#databases-alarms"
role_recipients_irc[webmaster]="#networking-alarms"

The keywords #user-alarms, #networking-alarms, #system-alarms, #databases-alarms are irc channels which belong to the specified IRC network.

Did you find this document helpful?

Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.

Documentation

Community

Last updated on