Configuring email notifications for appliance services

You can configure email notifications so that you are informed whenever an appliance service's health enters a critical or warning state.

By default, notifications are enabled for high-priority appliance services but you can configure notifications for any service by using the CLI.

For instance, you can have email notifications sent to you when the WSAPI service is in a warning or critical state. You can have email notifications sent daily at 14:00 (PST), and you can stop and restart notifications.

Category	Service name	Priority
DTI	Disk Storage	High
	Central Management System Server Connectivity	High
System	Disk Storage	High
	System Load Health	High
	Ethernet Interfaces	High
	WSAPI Service	Low
	Database Service	High

	Service Name	Priority
Network Processing	Network Content Processing Engine	High
	SmartVision Events Per Second (EPS)	High
DTI	Disk Storage	High
	Central Management System Server Connectivity	High
System	Disk Storage	High
	System Load Health	High
	Ethernet Interfaces	High
	WSAPI Service	Low
	Database Service	High
Cloud Detection	Retroactive Detection	High
	Global Cache	High
	Advanced URL Defense (FUME)	High
Metadata Streaming	Tapsender	High
	Commbroker	High
	L7 Metadata Export	High
Analysis	URL Transform	High
	URL Extract	High
	URL Static Analysis	High

Prerequisites

The appliance must have an established connection to the Internet.
You must have Admin or Operator access to the appliance.
Configure email recipients. For details, see the "Configuring Email Recipients" section of the Network Security System Administration Guide.

Configuring appliance health service email notifications

Use the CLI commands in this topic to configure appliance health service email notifications.

To configure event notifications using the CLI:

Enable the CLI configuration mode:

hostname > enable
hostname # configure terminal

Enable email notifications about the health of an appliance service.

hostname (config) # health configuration service <service-name> notify
enable

Configure the failure wait time threshold. The email notification is sent after the service has been in failed state for failed threshold number of minutes.
```
hostname (config) # health configuration service <service-name> notify
failure-threshold <minutes>
```
Configure the recovery time threshold. The email notification is sent after the service recovers from degraded state and stays in recovered or healthy state for recovery threshold number of minutes. This recovery threshold time prevents multiple notifications if the service changes state intermittently.
```
hostname (config) # health configuration service <service-name> notify
recovery-threshold <minutes>
```
Configure the time of day when the email notification is sent about the health of appliance services.
```
hostname (config) # health configuration digest notify daily at
<hour:minute>
```
Configure backoff time. If the service changes to a degraded state, then an email notification will not be sent until after the configured backoff time has been reached.
```
hostname # health configuration service <service-name> notify backoff
<hours>
```

View the configuration for appliance service email notifications.

hostname # show health configuration
Services Health Digest:
Email Notification at 12:15 (daily)

Service Health Configurations:

Service "Submission-Queue" Health Configuration:

    Notifications Enabled           : yes
    Notification Backoff Period     : 10 hours
    Recovery Threshold              : 5 minutes
    Failure Threshold               : 5 minutes

Service "CMS-Server-Connectivity" Health Configuration:

    Notifications Enabled           : yes
    Notification Backoff Period     : 24 hours
    Recovery Threshold              : 20 minutes
    Failure Threshold               : 20 minutes

Service "System-CPU-Memory-DiskIO-Health" Health Configuration:

    Notifications Enabled           : yes
    Notification Backoff Period     : 24 hours
    Recovery Threshold              : 5 minutes
    Failure Threshold               : 5 minutes

Service "Dynamic-URL-Analysis-Live-Mode" Health Configuration:

    Notifications Enabled           : yes
    Notification Backoff Period     : 24 hours
    Recovery Threshold              : 5 minutes
    Failure Threshold               : 5 minutes
.
.
.

Save the configuration:
```
hostname (config) # write memory
```