Skip to content

IRC notifications

Valentin Hilbig edited this page Mar 25, 2021 · 8 revisions

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 preffered 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.

General


Running Netdata

Special Uses

Notes on memory management


Database Replication and Mirroring


Backends
archiving netdata collected metrics to a time-series database


Health monitoring - Alarms
alarms and alarm notifications in netdata


Netdata Registry


Monitoring Info


Netdata Badges


Data Collection

Binary Modules

Python Modules

Node.js Modules

BASH Modules

Active BASH Modules

Obsolete BASH Modules


API Documentation


Web Dashboards


Running behind another web server


Package Maintainers


Donations


Blog


Other monitoring tools

Clone this wiki locally