Splunk Cloud Platform

Alerting Manual

Configure alerts in savedsearches.conf

You can use Splunk Web to configure most alerts. If you have Splunk Enterprise, you can configure alerts by editing savedsearches.conf. For reference, see savedsearches.conf in the Splunk Enterprise Admin Manual.

Splunk Cloud Platform
Use the Splunk Web steps to configure alerts. See Create scheduled alerts. You can't configure alerts using the configuration files.
Splunk Enterprise
To configure alerts using the configuration files, follow these steps.

Never change or copy the configuration files in the default directory. The files in the default directory must remain intact and in their original location. Make changes to the files in the local directory.

  1. Open or create a savedsearch.conf file in the proper directory. See Configuration file paths.
  2. Create or edit the stanza for the saved search. See Example savedsearch.conf stanza.

Configuration file paths

Open or create a local savedsearch.conf file at $SPLUNK_HOME/etc/system/local.

For apps, open or create the savedsearches.conf file in the application directory: $SPLUNK_HOME/etc/apps/<app name>/local

Example savedsearch.conf stanza

Alerts use a saved search to look for events. savedsearches.conf contains a stanza for each saved search. The following example shows the stanza for a saved search with its alert action settings. In this case, the alert sends an email notification when it triggers.

[Too Many Errors Today]
# send an email notification
action.email = 1
action.email.message.alert = The alert condition for '$name$' in the $app$ fired with $job.resultCount$ error events.
action.email.to = address@example.com
action.email.useNSSubject = 1

alert.suppress = 0
alert.track = 0

counttype = number of events
quantity = 5
relation = greater than

# run every day at 14:00
cron_schedule = 0 14 * * *

#search for results in the last day
dispatch.earliest_time = -1d
dispatch.latest_time = now

display.events.fields = ["host","source","sourcetype","latitude"]
display.page.search.mode = verbose
display.visualizations.charting.chart = area
display.visualizations.type = mapping

enableSched = 1

request.ui_dispatch_app = search
request.ui_dispatch_view = search
search = index=_internal " error " NOT debug source=*splunkd.log* earliest=-7d latest=now
disabled = 1

For an example of configuring alerts, see the savedsearches.conf.example file in the Splunk Enterprise Admin Manual.

Last modified on 01 March, 2022
Alert examples   Configure a script for an alert action

This documentation applies to the following versions of Splunk Cloud Platform: 8.2.2112, 8.2.2201, 8.2.2202, 9.0.2205, 8.2.2203, 9.0.2208, 9.0.2209, 9.0.2303, 9.0.2305, 9.1.2308 (latest FedRAMP release), 9.1.2312, 9.2.2403

Was this topic useful?

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters