3 minute read.Last Modified 2021-07-30 11:34 EDT
The alert system integrates with various third-party services. Tuning alerts also helps personalize TrueNAS to any highly-sensitive issues.
Alert Services are the various methods built into to TrueNAS that can notify you of a system alert.
Some of alert services are third-party integrations that can charge for message or data usage.
To add a new alert service, go to System > Alert Services and click ADD.
Name and Type
|Name||Name of the new alert service.|
|Enabled||Unset to disable this service without deleting it.|
|Type||Choose an alert service to display options for that service.|
|Level||Select the level of severity.|
Choosing a Type adds options specific to that alert service:
|Email Address||Enter a valid email address to receive alerts from this system.|
|Host||Enter the InfluxDB hostname.|
|Username||Username for this service.|
|Database||Name of the InfluxDB database.|
|Series||InfluxDB time series name for collected points.|
|Webhook URL||Enter or paste the incoming webhook URL associated with this service.|
|Channel||Name of the channel to receive notifications. This overrides the default channel in the incoming webhook settings.|
|Icon Url||Icon file to use as the profile picture for new messages. Example: https://mattermost.org/wp-content/uploads/2016/04/icon.png. Requires configuring Mattermost to override profile picture icons.|
|API Key||Enter or paste the API key. Find the API key by signing into the OpsGenie web interface and going to Integrations/Configured Integrations. Click the desired integration, Settings, and read the API Key field.|
|API URL||Leave empty for default OpsGenie API.|
|Service Key||Enter or paste the “integration/service” key for this system to access the PagerDuty API.|
|Client Name||PagerDuty client name.|
|Webhook URL||Paste the incoming webhook URL associated with this service.|
|Hostname||Hostname or IP address of the system to receive SNMP trap notifications.|
|Port||UDP port number on the system receiving SNMP trap notifications. The default is 162.|
|SNMPv3 Security Model||Enable the SNMPv3 security model.|
|SNMP Community||Network community string. The community string acts like a user ID or password. A user with the correct community string has access to network information. The default is public. For more information, see this helpful SNMP Community Strings tutorial.|
Test the service configuration by clicking SEND TEST ALERT.
To modify the default system alerts, go to System > Alert Settings.
The alerts are grouped into sections based on type. For example, alerts that are related to pools appear in the Storage alert section.
|Set Warning Level||Customizes the importance of the alert. Each level of importance has a different icon and color to express the level of importance: Info, Notice, Warning, Error, Critical (Default), Alert, and Emergency.|
|Set Frequency||Adjust how often alert notifications are sent. Setting the Frequency to NEVER prevents that alert from being added to alert notifications, but the alert can still show in the web interface if it is triggered. Options: Immediately (Default), Hourly, Daily, and Never.|
Changing any of these options affects every configured alert service.