Recent disruptions to two undersea internet cables in the Baltic Sea have yet again...
4.12 Notification and events
4.12.1 pushd.email.from #
Defines the From email address used for sending email notifications.
- Possible values:
valid email address - Default value:
root@localhost
4.12.2 pushd.email.host #
Defines the IPv4, IPv6 address or email server host name used to send emails.
- Possible values:
Hostname or IPv4/IPv6 address - Default value:
127.0.0.1
4.12.3 pushd.email.port #
Defines the TCP port used for sending emails.
- Possible values:
1-65535 - Default value:
25 - Recommended value:
25
4.12.4 pushd.listen.port #
Defines the TCP listen port of irppushd service.
- Possible values:
1-65535 - Default value:
10499
4.12.5 pushd.log #
Defines the complete path to the irppushd log file
- Possible values:
full path to log file - Default value:
/var/log/irp/irppushd.log
4.12.6 pushd.log.level #
Defines the logging level for the irppushd service.
- Possible values:
emerg, fatal, alert, crit, error, warn, notice, info, debug, trace - Default value:
info - Recommended value:
info
4.12.7 pushd.sms.account_sid #
Defines the public account identifier issued to user by the SMS gateway. Usually this is a random string.
- Possible values:
random string
4.12.8 pushd.sms.auth_token #
Defines the secret authentication token issued by the SMS gateway to the account holder. Usually this is a longer random string.
- Possible values:
random string
4.12.9 pushd.sms.gateway #
Defines the SMS gateway preferred by the user. A valid account with this SMS gateway is required to send SMS.
- Possible values:
twilio, plivo - Default value:
none
4.12.10 pushd.sms.message_size #
Defines the maximum size of SMS texts. Texts that are longer than this limit will be trimmed and a … will be added. The SMS gateway will split the SMS text into multiple messages if the request includes a longer than supported SMS message.
The SMS gateway enforces its own text size limits. In case the notification exceeds SMS gateway limits the SMS message can be either trimmed or rejected.- Possible values:
150-6000 - Default value:
150
4.12.11 pushd.sms.phone_number #
Defines the From phone number used for sending SMS notifications.
SMS gateways might have policies regarding the valid phone numbers that they will accept. Check with your SMS gateways if there are any restrictions and if yes what phone numbers can be provided in this configuration parameter.- Possible values: valid phone number
4.12.12 pushd.sms.uri.plivo #
Defines the URL of the Plivo SMS API.
Do not change this parameter unless Plivo SMS API URL has changed.- Possible values:
valid URL - Default value:
https://api.plivo.com/v1/Account/%1%/Message/ - Recommended value:
https://api.plivo.com/v1/Account/%1%/Message/
4.12.13 pushd.sms.uri.twilio #
Defines the URL of the Twilio SMS API.
Do not change this parameter unless Twilio SMS API URL has changed.- Possible values:
valid URL - Default value:
https://api.twilio.com/2010-04-01/Accounts/%1%/Messages.json - Recommended value:
https://api.twilio.com/2010-04-01/Accounts/%1%/Messages.json
4.12.14 pushd.templates.datadir #
Defines the directory for notification templates used by irppushd service to format email and sms messages.
- Possible values:
full path to notification templates - Default value:
/etc/noction/templates
4.12.15 pushd.webhook.avatar_emoji #
Defines an emoji to be used as the IRP bot’s avatar image. The emoji is expected to be in the “:robot-face:” notation.
The avatar emoji is used if an avatar icon in pushd.webhook.avatar_url is not specified.- Possible values:
valid emoji in :colon: notation - Default value:
:robot-face:
4.12.16 pushd.webhook.avatar_url #
Defines the URL of the IRP bot’s avatar image. URL should be a publicly accessible PNG or JPEG image that the webhook provider is able to retrieve and use.
This is the default avatar image. The avatar icon will be used instead of an emoji if both are specified. Refer to pushd.webhook.avatar_emoji.- Possible values:
valid URL - Default value:
http://www.noction.com/round-logo.png - Recommended value:
http://www.noction.com/round-logo.png
4.12.17 pushd.webhook.botname #
Defines the name assigned to IRP bot.
- Possible values:
text - Default value:
IRP - Recommended value:
IRP
4.12.18 pushd.webhook.url #
Defines the URL assigned to Web Hooks user/team. Web Hooks work by POST-ing JSON content to this designated URL for example
POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXThis parameter is required in order for any subscription to web hooks channels to work. Currently only the Slack.com web hooks API has been tested and confirmed to work.- Possible values:
valid URL
4.12.19 trap.bgpd_announced_rate_low.limit_pct #
Defines the announcements rate limit percentage.
- Possible values:
1-100 - Default value:
60 - Recommended value:
60
4.12.20 trap.core_cc_improvements_spike.diff_pct #
Defines the size (in percent) of the spike in the number of improvement compared to preceeding period average defined in trap.core_cc_improvements_spike.period_sec.
- Possible values:
1-100 - Default value:
50
4.12.21 trap.core_cc_improvements_spike.period_sec #
Defines the time interval preceeding a spike. The number of improvements is averaged over this time and a spike event is triggered when the subsequent measurement exceeds the size (in percent) defined by trap.core_cc_improvements_spike.diff_pct.
- Possible values:
30-86400 - Default value:
300
4.12.22 trap.core_cc_overload.inbound_limit_mbps #
Defines the overall overload limit in Mbps for the Inbound Commit Control overload by X Mbps event. The event is raised if the overall inbound traffic of the network exceeds the configured value (sum of peer.X.95th for all providers) by this limit.
- Possible values:
1-100000 - Default value:
100
4.12.23 trap.core_cc_overload.inbound_limit_pct #
Defines the overall overload limit in percent for the Inbound Commit Control overload by X% event. The event is raised if the overall inbound traffic of the network exceeds the configured value (sum of peer.X.95th for all providers) by this limit.
- Possible values:
1-1000 - Default value:
10
4.12.24 trap.core_cc_overload.limit_mbps #
Defines the overall overload limit in Mbps for the Outbound Commit Control overload by X Mbps event. The event is raised if the overall outbound traffic of the network exceeds the configured value (sum of peer.X.95th for all providers) by this limit.
- Possible values:
1-100000 - Default value:
100
4.12.25 trap.core_cc_overload.limit_pct #
Defines the overall overload limit in percent for the Outbound Commit Control overload by X% event. The event is raised if the overall outbound traffic of the network exceeds the configured value (sum of peer.X.95th for all providers) by this limit.
- Possible values:
1-1000 - Default value:
10 - Recommended value:
10
4.12.26 trap.core_cc_provider_overload.inbound_limit_mbps #
Defines the per provider overload limit in Mbps for the Inbound Commit Control provider X overloaded by Y Mbps event. The event is raised if the inbound traffic for a provider exceeds the configured value (refer peer.X.95th) by more than this limit.
- Possible values:
1-100000 - Default value:
100
4.12.27 trap.core_cc_provider_overload.inbound_limit_pct #
Defines the per provider overload limit in percent for the Inbound Commit Control provider X overloaded by Y% event. The event is raised if the inbound traffic for a provider exceeds the configured value (refer peer.X.95th) by more than this limit.
- Possible values:
1-1000 - Default value:
10
4.12.28 trap.core_cc_provider_overload.limit_mbps #
Defines the per provider overload limit in Mbps for the Outbound Commit Control provider X overloaded by Y Mbps event. The event is raised if the outbound traffic for a provider exceeds the configured value (refer peer.X.95th) by more than this limit.
- Possible values:
1-100000 - Default value:
100
4.12.29 trap.core_cc_provider_overload.limit_pct #
Defines the per provider overload limit in percent for the Outbound Commit Control provider X overloaded by Y% event. The event is raised if the outbound traffic for a provider exceeds the configured value (refer peer.X.95th) by more than this limit.
- Possible values:
1-1000 - Default value:
10 - Recommended value:
10
4.12.30 trap.core_excessive.prefixes #
Defines list of prefixes to restrict events prefixExcessiveLatency & prefixExcessiveLoss.
Events would be generated if the list is empty or aggregate from the list contains a prefix from event.
- Possible values:
list of valid IPv4/IPv6 prefixes - Default value:
300 - Recommended value:
300
4.12.31 trap.core_excessive_latency.limit #
Defines the packet latency limit in milliseconds.
- Possible values:
1-10000 - Default value:
300 - Recommended value:
300
4.12.32 trap.core_excessive_loss.limit #
Defines the packet loss percentage limit.
- Possible values:
1-100 - Default value:
50 - Recommended value:
50
4.12.33 trap.destination.auth_password #
SNMP user’s password for IRP generated traps. Applicable only when SNMP v3 with authentication is used. Refer to trap.destination.version, trap.destination.seclevel, trap.destination.auth_username.
- Possible values:
text
4.12.34 trap.destination.auth_protocol #
SNMP authentication protocol for IRP generated traps. Applicable only when SNMP v3 with authentication is used. Refer to trap.destination.version, trap.destination.seclevel.
0 – MD5
1 – SHA
- Possible values:
0, 1 - Default value:
1
4.12.35 trap.destination.auth_username #
SNMP user name for IRP generated traps. Applicable only when SNMP v3 with authentication is used. Refer to trap.destination.version, trap.destination.seclevel.
- Possible values:
text
4.12.36 trap.destination.community #
Defines the SNMP community used for sending SNMP traps.
- Possible values: textual SNMP v2c community name
- Default value:
public
4.12.37 trap.destination.port #
Defines the UDP port used for sending SNMP traps.
- Possible values:
1-65535 - Default value:
162
4.12.38 trap.destination.priv_password #
SNMP password for IRP generated traps. Applicable only when SNMP v3 with privacy is used. Refer to trap.destination.version, trap.destination.seclevel.
- Possible values:
text
4.12.39 trap.destination.priv_protocol #
SNMP encryption protocol for IRP generated traps. Applicable only when SNMP v3 with privacy is used. Refer to trap.destination.version, trap.destination.seclevel.
DES isn’t supported in RedHat Enterprise Linux 90 – DES
1 – AES
- Possible values:
0, 1 - Default value:
1
4.12.40 trap.destination.seclevel #
SNMP security services for IRP generated traps.
IRP supports either No security, Authentication only or both Authentication and Privacy.
Applicable only when SNMP v3 is used (trap.destination.version).
Depending on security services used further parameters should be configured, for example: trap.destination.auth_username, trap.destination.auth_password, trap.destination.auth_protocol, trap.destination.priv_password, trap.destination.priv_protocol.
0 – Neither Authentication nor Privacy
1 – Authentication only
2 – Authentication and Privacy
- Possible values:
0, 1, 2 - Default value:
0
4.12.41 trap.destination.version #
SNMP version for IRP generated traps.
2 – SNMP v2c
3 – SNMP v3
- Possible values:
2, 3 - Default value:
2