Alerts Settings

Dashboard Location: Network-wide > Configure > Alerts

Network Alert Management

Alerts settings configuration in Meraki provides administrators with control over network-wide alert destinations and per-alert notification routing. Default destinations define where all network alerts are sent, while per-alert overrides allow fine-grained control over which emails, administrators, SNMP traps, or webhooks receive each specific alert type. The muting option suppresses wireless unreachable alerts triggered by port schedules, reducing notification noise during planned maintenance windows.

Diagram

Classes

networks (meraki.domains.organizations)

Name	Type	Constraint	Mandatory	Default Value
alerts_settings	Class	[alerts_settings]	No

alerts_settings (meraki.domains.organizations.networks)

Name	Type	Constraint	Mandatory	Default Value
default_destinations	Class	[default_destinations]	No
muting_by_port_schedules	Boolean	true, false	No
alerts	List	[alerts]	No

default_destinations (meraki.domains.organizations.networks.alerts_settings)

Name	Type	Constraint	Mandatory	Default Value
all_admins	Boolean	true, false	No
snmp	Boolean	true, false	No
emails	List	String[min: 1, max: 255]	No
http_server_ids	List	String[min: 1, max: 255]	No

alerts (meraki.domains.organizations.networks.alerts_settings)

Name	Type	Constraint	Mandatory	Default Value
type	String	min: 1, max: 127	Yes
enabled	Boolean	true, false	No
alert_destinations	Class	[alert_destinations]	No
filters	Class	[filters]	No

alert_destinations (meraki.domains.organizations.networks.alerts_settings.alerts)

Name	Type	Constraint	Mandatory	Default Value
all_admins	Boolean	true, false	No
snmp	Boolean	true, false	No
emails	List	String[min: 1, max: 255]	No
http_server_ids	List	String[min: 1, max: 255]	No
sms_numbers	List	String[min: 1, max: 32]	No

filters (meraki.domains.organizations.networks.alerts_settings.alerts)

Name	Type	Constraint	Mandatory	Default Value
failure_type	String	min: 1, max: 127	No
lookback_window	Integer	min: 0	No
min_duration	Integer	min: 0	No
name	String	min: 1, max: 127	No
period	Integer	min: 0	No
priority	String	min: 1, max: 127	No
regex	String	min: 1, max: 1024	No
selector	String	min: 1, max: 4096	No
ssid_name	String	min: 1, max: 127	No
tag	String	min: 1, max: 255	No
threshold	Integer		No
timeout	Integer	min: 0	No
devices	List	String[min: 1, max: 127]	No
conditions	List	[conditions]	No

conditions (meraki.domains.organizations.networks.alerts_settings.alerts.filters)

Name	Type	Constraint	Mandatory	Default Value
type	String	min: 1, max: 127	Yes
direction	Choice	+, -	No
duration	Integer	min: 0	No
threshold	Number		No
unit	String	min: 1, max: 127	No

Examples

Example-1: The example below demonstrates alerts settings configuration.

This configuration enables network-wide default destinations for all admins and SNMP, with port schedule muting set via muting_by_port_schedules: true. Three alert overrides demonstrate the available filter types: gatewayDown scopes notifications to specific access points using filters.devices (referenced by device name); sensorAlert uses filters.conditions to trigger on temperature threshold breaches with direction and duration criteria; and usageAlert scopes to a wireless SSID by name via filters.ssid_name, with period and threshold filters controlling when the alert fires. Device names and SSID names reference other NAC model resources and are automatically resolved to their API identifiers by the Terraform module.

meraki:
  domains:
    - name: !env domain
      administrator:
        name: !env org_admin
      organizations:
        - name: !env org
          networks:
            - name: !env network_name
              product_types:
                - appliance
                - switch
                - wireless
                - camera
                - sensor
                - cellularGateway
              alerts_settings:
                default_destinations:
                  all_admins: true
                  snmp: true
                  emails:
                    - miles@meraki.com
                muting_by_port_schedules: true
                alerts:
                  - type: gatewayDown
                    enabled: true
                    alert_destinations:
                      all_admins: false
                      snmp: false
                      emails:
                        - miles@meraki.com
                    filters:
                      timeout: 60
                      devices:
                        - !env ap_01
                        - !env ap_02
                  - type: sensorAlert
                    enabled: true
                    alert_destinations:
                      all_admins: true
                      snmp: false
                    filters:
                      conditions:
                        - type: temperature
                          direction: '+'
                          threshold: 72.5
                          unit: celsius
                          duration: 0
                      devices:
                        - !env sensor_01
                  - type: usageAlert
                    enabled: true
                    alert_destinations:
                      all_admins: true
                      snmp: false
                    filters:
                      ssid_name: CORP
                      period: 1200
                      threshold: 104857600