# Channels

Common
Types
- Slack
- Telegram
- Syslog
- Notify
- Email
- Discord
- Webhook
- Alertmanager
- Alertmanager Receiver
- Twilio Voice

# Common

An example

HCL
Yaml

channels {
  slack "slack-notification" {
    token = "SLACK-APPLICATION-TOKEN"
    channel = "notification"
    ignore = false
  }
  telegram "tg1" {
    token = "TELEGRAM-BOT-TOKEN"
    chatId = 100500
    timeout = 5000
    proxy {
      address = "10.20.30.40:5060"
      auth {
        username = "username"
        password = "password"
      }
    }
    ignore = false
  }
  syslog "default" {
    tag = "balerter"
    network = "tcp"
    address = "127.0.0.1:10515"
    priority = "EMERG|DAEMON"
    ignore = false
  }
  notify "default" {
    icons {
      success = "/path/to/logo-success.png"
      error = "/path/to/logo-error.png"
      warning = "/path/to/logo-warning.png"
    }
    ignore = false
  }
  email "default" {
    from = "[email protected]"
    to = "[email protected]"
    cc = "[email protected]"
    host = "bar.com"
    port = 1234
    username = "user"
    password = "secret"
    secure = "ssl"
    timeout = 10
    ignore = false
  }
  discord "default" {
    token = "ABCD"
    channelId = 1234
    ignore = false
  }
  webhook "wh1" {
    settings {
      url = "http://domain.com"
      method = "POST"
      auth {
        type = "basic"
        login = "user"
        password = "secret"
      }
      payload {
        queryParams {
          foo = "bar"
        }
        body = "body content"
      }
      timeout = 5000
      headers {
        X-Foo = "Bar"
      }
    }
    ignore = false
  }
  
  alertmanager "am1" {
    settings {
      // webhook settings
    }
    ignore = false
  }

  alertmanager_receiver "am2" {
    settings {
      // webhook settings
    }
    ignore = false
  }
  
  twilioVoice "tw1" {
    sid = "ABCD"
    token = "ABCD"
    from = "+11111111111"
    to = "+11111111111"
    twiml = "<Response><Say>{TEXT}</Say></Response>"
    ignore = false
    timeout = 5000
  }
}

# Type `Slack`

HCL
Yaml

slack "slack-notification" {
  token = "SLACK-APPLICATION-TOKEN"
  channel = "notification"
  ignore = false
}

# name (string)

Required, Unique

Channel name

# token (string)

Required

Slack application token

# channel (string)

Required

Slack channel

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `Telegram`

HCL
Yaml

telegram "tg1" {
  token = "TELEGRAM-BOT-TOKEN"
  chatId = 100500
  timeout = 5000
  proxy {
    address = "10.20.30.40:5060"
    auth {
      username = "username"
      password = "password"
    }
  }
  ignore = false
}

# name (string)

Required, Unique

Channel name

# token (string)

Required

Telegram bot API token

# chatId (int)

Required

Chat ID

# timeout (time interval)

By default: 5000

timeout in milliseconds

# proxy

Default: empty, not use

Socks5 proxy settings

If auth section is defined, it will use for authentication

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `Syslog`

JSON marshalled messaged will be send to syslog server

HCL
Yaml

syslog "default" {
  tag = "balerter"
  network = "tcp"
  address = "127.0.0.1:10515"
  priority = "EMERG|DAEMON"
  ignore = false
}

# name (string)

Required, Unique

Channel name

# tag (string)

Default: empty string

Syslog tag

# network (string)

Default: empty string

Network type

udp
tcp
empty string for use local syslog server

# address (string)

Default: empty string

Server address

# priority (string)

Default: EMERG

Message priority

Format: <SEVERITY>[|<FACILITI>]

Severity:

EMERG
ALERT
CRIT
ERR
WARNING
NOTICE
INFO
DEBUG

Facility:

KERN
USER
MAIL
DAEMON
AUTH
SYSLOG
LPR
NEWS
UUCP
CRON
AUTHPRIV
FTP
LOCAL0
LOCAL1
LOCAL2
LOCAL3
LOCAL4
LOCAL5
LOCAL6

For example:

priority: 'ALERT'
priority: 'ALERT|USER'
priority: 'INFO|LOCAL0'

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `Notify`

Send standard OS GUI notification

HCL
Yaml

notify "default" {
  icons {
    success = "/path/to/logo-success.png"
    error = "/path/to/logo-error.png"
    warning = "/path/to/logo-warning.png"
  }
  ignore = false
}

# name (string)

Required, Unique

Channel name

# icons.success (string)

# icons.error (string)

# icons.warning (string)

By default: empty string

Path to images (use as notification icons)

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `Email`

HCL
Yaml

email "default" {
  from = "[email protected]"
  to = "[email protected]"
  cc = "[email protected]"
  host = "bar.com"
  port = 1234
  username = "user"
  password = "secret"
  secure = "ssl"
  timeout = 10
  ignore = false
}

# name (string)

Required, Unique

Channel name

# from (string)

Field 'from'

# to (string)

Field 'to'

# cc (string)

Field 'cc'

# host (string)

Hostname

# port (int)

Port

If Port equals to '465' and Secure field is empty, Secure filed will be set to 'ssl'

# username (string)

Username

# password (string)

Password

# secure (string)

none, ssl, tls or empty string

# timeout (time interval)

timeout in seconds. By default - 10 sec.

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `Discord`

HCL
Yaml

discord "default" {
  token = "ABCD"
  channelId = 1234
  ignore = false
}

# name (string)

Required, Unique

Channel name

# token (string)

Token

# channelID (int)

Channel ID

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `webhook`

HCL
Yaml

webhook "wh1" {
  settings {
    url = "http://domain.com"
    method = "POST"
    auth {
      type = "basic"
      login = "user"
      password = "secret"
    }
    payload {
      queryParams {
        foo = "bar"
      }
      body = "body content"
    }
    timeout = 5000
    headers {
      X-Foo = "Bar"
    }
  }
  ignore = false
}

# name (string)

Required, Unique

# settings.url

Required, URL

Webhook URL

# settings.method

By default: POST

HTTP method

# settings.auth

Type must be none, basic, bearer or custom. By default: none (empty string)

Authentication data. Depending on the type:

# type: basic

Should be not empty:

settings.auth.login
settings.auth.password

# type: bearer

Should be not empty:

settings.auth.token

# settings.payload.body

POST body. Must be defined with method=POST

# settings.payload.queryParams

String=String pairs for set query params

# settings.timeout (time interval)

By default: 3000

Timeout in milliseconds

# settings.headers

String=String pairs for set HTTP request headers

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `alertmanager`

TODO: links to

alertmanager docs

manual for balerter-alertmanager communications

HCL
Yaml

alertmanager "am1" {
  settings {
    // webhook settings
  }
  ignore = false
}

# name (string)

Required, Unique

# settings

See webhook settings

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `alertmanager_receiver`

TODO: links to

alertmanager-receiver docs

manual for balerter-alertmanager_receiver communications

HCL
Yaml

alertmanager_receiver "am2" {
  settings {
    // webhook settings
  }
  ignore = false
}

# name (string)

Required, Unique

# settings

See webhook settings

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# Type `twilioVoice`

TwilioVoice channel allows you to make voice calls on change alert status

https://www.twilio.com/

HCL
Yaml

twilioVoice "tw1" {
  sid = "ABCD"
  token = "ABCD"
  from = "+11111111111"
  to = "+11111111111"
  twiml = "<Response><Say>{TEXT}</Say></Response>"
  ignore = false
  timeout = 5000
}

# name (string)

Required, Unique

# sid (string)

Required

Your SID from the Twilio console

# token (string)

Your Token from the Twilio console

# from (string)

Sender phone number

# to (string)

Your phone number

# twiml (string)

TwiML template.

You can to specify the macros {TEXT}, which will be replaced to alert text. If this option is empty, alert text will be placed as TwiML template

# ignore (bool)

If this option is True, this channel will be ignored by default. This option will be ignored if you explicitly define the channel in your script meta-tags or alert options

# timeout (millisecond)

Default: 30000 (30s)

HTTP request timeout

← Data Sources Storages →

# Channels

# Common

# Type Slack

# name (string)

# token (string)

# channel (string)

# ignore (bool)

# Type Telegram

# name (string)

# token (string)

# chatId (int)

# timeout (time interval)

# proxy

# ignore (bool)

# Type Syslog

# name (string)

# tag (string)

# network (string)

# address (string)

# priority (string)

# ignore (bool)

# Type Notify

# name (string)

# icons.success (string)

# icons.error (string)

# icons.warning (string)

# ignore (bool)

# Type Email

# name (string)

# from (string)

# to (string)

# cc (string)

# host (string)

# port (int)

# username (string)

# password (string)

# secure (string)

# timeout (time interval)

# ignore (bool)

# Type Discord

# name (string)

# token (string)

# channelID (int)

# ignore (bool)

# Type webhook

# name (string)

# settings.url

# settings.method

# settings.auth

# type: basic

# type: bearer

# settings.payload.body

# settings.payload.queryParams

# settings.timeout (time interval)

# settings.headers

# ignore (bool)

# Type alertmanager

# name (string)

# settings

# ignore (bool)

# Type alertmanager_receiver

# name (string)

# settings

# ignore (bool)

# Type twilioVoice

# name (string)

# sid (string)

# token (string)

# from (string)

# to (string)

# twiml (string)

# ignore (bool)

# timeout (millisecond)

# Type `Slack`

# Type `Telegram`

# Type `Syslog`

# Type `Notify`

# Type `Email`

# Type `Discord`

# Type `webhook`

# Type `alertmanager`

# Type `alertmanager_receiver`

# Type `twilioVoice`