TrueNASTrueNAS Development Documentation
This content follows experimental development changes in TrueNAS 27, a future version of TrueNAS.
Use the Product and Version selectors above to view content specific to a stable software release.

Alert Settings Screens

The Alert Settings screen displays options to create and edit alert services and to configure warning levels and frequencies. To access this screen, click the notifications icon, then click the settings icon and select Alert Settings on the dropdown list.

AlertServicesScreen

Use Columns to change the information displayed in the list of alert services. Options are Unselect All, Type, Level, Enabled and Reset to Defaults.

Add/Edit Alert Service Screen

The Add Alert Service and Edit Alert Service screens show the same settings.

Use Add to create a new alert service using the Add Alert Service screen. The Type settings for AWS SNS display by default. To add an alert service for another option, use the Type dropdown list. Only the Authentication Settings change for each option.

AddAlertServiceScreen

Name and Type Settings

SettingDescription
NameEnter a name for the new alert service.
EnabledClear the checkmark to disable this service without deleting it.
TypeSelect an option from the dropdown list for an alert service to display options for that service. Options are AWS SNS which is the default type displayed, E-Mail, InfluxDB, Mattermost, OpsGenie, PagerDuty, Slack, SNMP Trap, Telegram or Splunk On-Call.
LevelSelect the severity from the dropdown list. Options are Info, Notice, Warning, Error, Critical, Alert or Emergency.
TrueNAS sends alert notifications for all warnings matching and above the selected level. For example, a warning level set to Critical triggers notifications for Critical, Alert, and Emergency level warnings.

Use SEND TEST ALERT to generate a test alert to confirm the alert service works.

Click Cancel to exit the Alert Services screen without saving.

Use Save to add the new service with the settings you specify to the list of alert services.

Use the Edit Alert Service screen to modify settings for a service. Select the edit icon for the service to display the Edit Alert Service screen.

Alert Service Types

AWS SNS

Click here for more information

Select AWS SNS from the Type dropdown list to display AWS SNS authentication settings.

AddAlertServiceScreen

Settings

SettingDescription
AWS RegionEnter the AWS account region.
ARNTopic Amazon Resource Name (ARN) for publishing. For example, arn:aws:sns:us-west-2:111122223333:MyTopic.
Key IDEnter the access key ID for the linked AWS account.
Secret KeySecret access key for the linked AWS account.

Email

Click here for more information

Select E-Mail from the Type dropdown list to display email authentication settings.

AddAlertServiceEmailScreen

Settings

SettingDescription
Override Admin EmailSets an email address to override the default email address for the admin account. When left blank, the email address for the admin account is used.

InfluxDB

Click here for more information

Select InfluxDB from the Type dropdown list to display InfluxDB authentication settings.

AddAlertServiceInfluxDBScreen

Settings

SettingDescription
HostEnter the InfluxDB host name.
UsernameEnter the user name for this service.
PasswordEnter the password for the user on this service
DatabaseEnter the name of the InfluxDB database.
SeriesEnter the InfluxDB time series name for collected points.

MatterMost

Click here for more information

Select Mattermost from the Type dropdown list to display Mattermost authentication settings.

AddAlertServiceMattermostScreen

Settings

SettingDescription
Webhook URLEnter or past the incoming webhook URL associated with this service.
UsernameEnter the Mattermost user name.
ChannelEnter the name of the channel to receive notifications. Entering a channel overrides the default channel in the incoming webhook settings.
Icon URLEnter the icon file to use as the profile picture for new messages. For example, https://mattermost.org/wp-content/uploads/2016/04/icon.png. Requires configuring Mattermost to override profile picture icons.

OpsGenie

Click here for more information

Select OpsGenie from the Type dropdown list to display OpsGenie authentication settings.

AddAlertServiceOpsGenieScreen

Settings

SettingDescription
API KeyEnter 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 URLLeave empty for default (OpsGenie API).

PagerDuty

Click here for more information

Select PagerDuty from the Type dropdown list to display PagerDuty authentication settings.

AddAlertServicePagerDutyScreen

Settings

SettingDescription
Service KeyEnter or paste the integration/service key for this system to access the PagerDuty API.
Client NameEnter the PagerDuty client name.

Slack

Click here for more information

Select Slack from the Type dropdown list to display Slack authentication settings.

AddAlertServiceSlackScreen

Settings

SettingDescription
Webhook URLPaste the incoming webhook URL associated with this service.

SNMP Trap

Click here for more information

Select SNMP Trap from the Type dropdown list to display SNMP trap authentication settings.

AddAlertServiceSNMPTrapScreen

Settings

SettingDescription
HostnameEnter the hostname or IP address of the system to receive SNMP trap notifications.
PortEnter the UDP port number on the system receiving SNMP trap notifications. The default is 162.
SNMPv3 Security ModelSelect to enable the SNMPv3 security model.
SNMP CommunityEnter the network community string. The community string acts like a user ID or password. A user with the correct community string can access network information. The default is public. For more information, see What is an SNMP Community String?.

Telegram

Click here for more information

Select Telegram from the Type dropdown list to display Telegram authentication settings.

AddAlertServiceTelegramScreen

Settings

SettingDescription
Bot API TokenEnter the Telegram Bot API Token How to create a Telegram Bot.
List of chat IDsEnter a list of chat IDs separated by a space ( ), comma (,), or semicolon (;). To find your chat ID, send a message to the bot, group, or channel and visit https://core.telegram.org/bots/api#getting-updates.

Splunk On-Call

Click here for more information

Select Splunk On-Call from the Type dropdown list to display Splunk On-Call authentication settings.

AddAlertServiceSplunkOnCallScreen

Settings

SettingDescription
API KeyEnter or paste the Splunk On-Call API key.
Routing KeyEnter or past the Splunk On-Call routing key.

Alert Categories

Use the Category dropdown list to display alert settings for each category.

Applications

Applications alert settings display by default. These alerts apply to the third-party applications you deploy on your TrueNAS system.

Click here for more information

AlertSettingsApplications

You can customize alert settings for when available applications have updates, catalog is not healthy, the system cannot configure or start applications, and the system cannot sync the catalog.

Audit

Audit alert settings apply to the audit and verification services on your TrueNAS system.

Click here for more information

AlertSettingsAudit

You can customize alert settings for when the audit service backend fails, the audit service has a health failure, and when the TrueNAS verify service detects changes in the root file system.

Certificates

Certificates alert settings apply to certificates you add through the Credentials > Certificates screen.

Click here for more information

AlertSettingsCertificates

You can customize alert settings for when a certificate has expired, is expiring, or is expiring soon, when a certificate parsing fails, and when the web UI HTTPS certificate setup fails.

Directory Service

Directory Service alert settings apply to the directory services configured on your TrueNAS.

Click here for more information

AlertSettingsDirectoryServices

You can customize alert settings for when the directory service bind is not healthy and when a directory service DNS update fails.

High Availability Settings

TrueNAS Enterprise

This section only applies to TrueNAS Enterprise hardware.

High Availability alert settings apply to TrueNAS Enterprise HA systems and only display on the list of alerts for dual-controller High-Availability systems with an Enterprise license applied.

Click here for more information

AlertSettingsHA1

AlertSettingsHA2

You can customize alert settings for when an automatic sync to peer fails, disks are missing on the active and/or standby controller, the system fails to check failover status with the other controller, syncing operations fail, such as encryption keys to peer and KMIP keys to peer, the failover interface is not found, and when a failover action fails.

Hardware

Hardware alert settings apply to the IPMI network connections and disk health monitoring on your TrueNAS system.

Click here for more information

AlertSettingsHardware

You can customize alert settings for when disk temperature is too hot, disk(s) format with the data integrity feature, a selftest fails, erase cycle count is high, IPMI has system events, the IPMI system event log space is low, JBOF removal requires reboot, spare block reserve is low, and uncorrected errors are detected.

The IPMI System Event Log (SEL) stores system events and can assist with debugging hardware issues. Review IPMI SEL alerts and resolve any underlying hardware issues before clearing space in the SEL. Consult manufacturer documentation for your motherboard to learn how to review IPMI system events and clear the log.

Key Management Interoperability Protocol (KMIP)

Key Management Interoperability Protocol (KMIP) alert settings only apply to KMIP configured on a TrueNAS Enterprise system.

Click here for more information

AlertSettingsKMIP

You can customize alert settings for when the system fails to communicate with the KMIP server, sync the SED global password, sync SED keys, or sync ZFS keys with the KMIP server.

Network

Network alert settings apply to network interfaces configured on your TrueNAS.

Click here for more information

AlertSettingsNetwork

You can customize alert settings for when a BOND interface references missing ports, when ports are not active on a BOND interface, and when there are no active ports on a BOND interface.

Reporting

Reporting alert settings apply to netdata, database size threshold, and syslog processes on your TrueNAS.

Click here for more information

AlertSettingsReporting

You can customize alert settings for when Netdata has critical alerts and warnings, the reporting database size exceeds the threshold, and syslog-ng is not running.

Sharing

Sharing alert settings apply to iSCSI, NFS, or SMB shares and connections configured on your TrueNAS.

Click here for more information

AlertSettingsSharing1

AlertSettingsSharing2

You can customize alert settings for when a deprecated service configuration is detected or a deprecated service is running, and when Fibre Channel HBAs are added or replaced.

You can also customize alerts for iSCSI issues: IP addresses bound to an iSCSI portal are not found, iSCSI authorized access has invalid characters or leading/trailing whitespace, and iSCSI discovery authorization is set to global, has multiple mutual CHAP, or is merged.

For NFS, you can customize alerts for when NFS services cannot bind to specific IP addresses using 0.0.0.0, an NFS export entry is blocked, host or network lists are excessively long, share references to hosts cannot be resolved, and NFS start is blocked by entries in /etc/exports.d.

For SMB, you can customize alerts for when NTLMv1 authentication is attempted in the last 24 hours, SMB1 connections to the TrueNAS server are performed in the last 24 hours, an SMB share audit configuration contains invalid groups, an SMB share path has unresolvable issues, SMB shares use an incorrect recordsize value for Veeam Fast Clone, and an SMB user is missing a required password hash.

You can also set alerts for when a share is unavailable because it uses a locked dataset.

Storage

Storage alert settings apply to quotas, pools, snapshots, and scrub processes on your TrueNAS.

Click here for more information

AlertSettingsStorage

You can customize alert settings for when a dataset exceeds standard or critical quotas, a pool has new available feature flags, pool space usage exceeds 85, 90, or 95 percent, and pool status is not healthy.

You can also change alert settings for when a scrub pauses, too many snapshots exist on the system or on a specific dataset.

System

System alert settings apply to system processes, the system dataset, TrueCommand API Key, SSH logins, system restarts, updates, and the web interface.

Click here for more information

AlertSettingsSystem1

AlertSettingsSystem2

You can customize alert settings for when an API key is revoked, API or SSH login failures occur, the admin user is overridden, administrator account activity is detected, the boot pool is unhealthy, core files are detected, and the running system version does not match the selected update profile.

You can also change alert settings for when a failover event or fencing causes a system reboot, a Gmail OAuth configuration is discarded, NTP health checks fail, a GPU configuration update requires a reboot, the system is not ready for Kdump, and system mocking endpoints are in use.

For TrueCommand, you can customize alerts for when an API key is pending confirmation or disabled by iX Portal, and when the TrueCommand container or service fails a scheduled health check.

You can also set alerts for when unencrypted datasets are detected within encrypted datasets and when an update is available.

Tasks

Tasks alert settings apply to cloud sync, VMWare snapshots, replication, rsync, scrub, and snapshot tasks scheduled on your TrueNAS.

Click here for more information

AlertSettingsTasks1

AlertSettingsTasks2

You can customize alert settings for when cloud backup or cloud sync tasks fail, a cloud provider is removed, VMWare snapshot creation or deletion fails, VMWare login fails, replication fails or succeeds, rsync tasks fail or succeed, a scrub fails to start or starts, snapshot tasks fail, and when a task is unavailable because it uses a locked dataset.

TrueNAS Connect Service

TrueNAS Connect Service alert settings apply to the TrueNAS Connect service on your TrueNAS system.

Click here for more information

AlertSettingsTNConnect

You can customize alert settings for when TrueNAS Connect is disabled or unconfigured and when the system is unable to connect to the TrueNAS Connect heartbeat service.

UPS

UPS alert settings apply to a UPS connected to your TrueNAS.

Click here for more information

AlertSettingsUPS

You can customize alert settings for when the UPS battery is low or needs replacement, the UPS establishes or loses communication, and the UPS is on battery or line power.

Alert Warning Levels

Use the Set Warning Level dropdown list to customize alert importance. Each warning level has an icon and color to express the level of urgency.

To make the system email you when alerts with a specific warning level trigger, set up an email alert service with that warning level. TrueNAS sends alert notifications for all warnings matching and above the selected level For example, a warning level set to Critical triggers notifications for Critical, Alert, and Emergency level warnings.

LevelIconAlert Notification?
INFOAlertLevelInfoNoticeAlertEmergencyNo
NOTICEAlertLevelInfoNoticeAlertEmergencyYes
WARNINGAlertLevelWarningYes
ERRORAlertLevelErrorCriticalYes
CRITICALAlertLevelErrorCriticalYes
ALERTAlertLevelInfoNoticeAlertEmergencyYes
EMERGENCYAlertLevelInfoNoticeAlertEmergencyYes

Alert Frequency

Use the Set Frequency dropdown list to adjust how often the system sends or displays alert notifications.

Alert frequency options are Immediately (Default), Hourly, Daily or Never. Setting the Frequency to Never prevents that alert from displaying in the Alerts Notification dialog, but it still pops up in the web UI if triggered.