What kinds of Notifications are available?
Available Notifications depend on your Cloudflare plan. We offer a variety of Notifications for our products and services, such as Billing, Denial-of-Service protection, Magic Transit, and SSL/TLS. Depending on your plan, you will also be able to configure webhooks. Webhooks allow you to connect your account with external services such as Slack and Google Chat. Another possibility is to use PagerDuty to receive Cloudflare Notifications.
What should you do when receiving Notifications?
Each Notification carries different types of information about the status of your Cloudflare account, or the type of action you can take.
Click below to understand what each Notification does and what to do when receiving one.
Access
Expiring Access Service Token Alert
Who is it for?
Access customers who want to receive a notification when their service token is about to expire.
Other options / filters
None.
Included with
Purchase of Access.
What should you do if you receive one?
Refresh your service token in the Teams dashboard under Configuration > Service Auth.
Billing
Usage Based Billing
Who is it for?
Customers who want to receive a notification when usage of a product goes above a set level.
Other options / filters
Customers can choose the Product they want to be notified about and the threshold that fires the notification. Thresholds depend on the product chosen. For example:
- Argo Smart Routing: has Notify when total bytes of traffic exceeds as threshold.
- Load Balancing: has Notify when total number of DNS Queries exceeds as threshold.
Included with
Professional plans or higher.
What should you do if you receive one?
Review your usage of the product and adjust the configuration and/or increase the alerting threshold.
DNS
Secondary DNS all Primaries Failing
Who is it for?
Enterprise customers who have at least one secondary zone in their account and want to receive a notification if all of their primary nameservers are failing.
Other options / filters
None.
Included with
Purchase of Secondary DNS.
What should you do if you receive one?
- Confirm that your primary nameservers are up and running.
- Confirm that the ACLs on your primary nameservers are configured correctly.
- Confirm that your primary nameservers are configured correctly in your Cloudflare account (correct IP, port, TSIG).
Secondary DNS Primaries Failing
Who is it for?
Enterprise customers who have at least one secondary zone and want to receive a notification if at least one of their primary nameservers is failing.
Other options / filters
None.
Included with
Purchase of Secondary DNS.
What should you do if you receive one?
- Confirm that the primary nameserver that is failing is up and running.
- Confirm that the ACL on the primary nameserver that is failing is configured correctly.
- Confirm that the primary nameserver that is failing is configured correctly in your Cloudflare account (correct IP, port, TSIG).
Secondary DNS Successfully Updated
Who is it for?
Enterprise customers who have at least one secondary zone in their account and want to receive a notification on successful zone transfers.
Other options / filters
None.
Included with
Purchase of Secondary DNS.
What should you do if you receive one?
No action needed. Everything is working correctly.
Secondary DNSSEC Validation Warning
Who is it for?
Customers who are using Cloudflare for Secondary DNS and want to receive notifications about failure or success of zone transfers from their primary nameservers.
Other options / filters
None.
Included with
Enterprise plans.
What should you do if you receive one?
Success alerts require no further action. Actions for failure notifications will depend on the type of failure. Possible actions include:
- Checking the Access Control List (ACL) on your primary nameserver.
- Checking if Cloudflare IPs have been configured correctly on your primary nameserver.
- Checking logs on primary nameservers for other errors.
DoS Protection
HTTP DDoS Attack Alerter
Who is it for?
WAF/CDN customers who want to receive a notification when Cloudflare has mitigated an attack.
Other options / filters
None.
Included with
All Cloudflare plans.
What should you do if you receive one?
No action needed. Refer to Understanding Cloudflare DDoS alerts for more information.
Layer 4 Attack Alerter
Who is it for?
BYOIP customers and Spectrum customers with Network Analytics who want to receive a notification when Cloudflare has mitigated an attack.
Other options / filters
None.
Included with
Purchase of Magic Transit and/or BYOIP.
What should you do if you receive one?
No action needed. Refer to Understanding Cloudflare DDoS alerts for more information.
Health checks
Health Checks status notification
Who is it for?
Customers who want to be warned about changes to server health as determined by health checks.
Other options / filters
Multiple filters available:
- Customers can can search for and add health checks from their list of health checks.
- Customers can choose a trigger to fire the notification. Available triggers are:
- Becomes unhealthy
- Becomes healthy
- Becomes either healthy or unhealthy
Included with
Pro plans or higher.
What should you do if you receive one?
Review your health check analytics.
Load Balancing
Pool Enablement
Who is it for?
Customers who want to be warned about status changes (enabled/disabled) in their pools.
Other options / filters
Multiple filters available:
- Customers can search for and add pools from their list of pools.
- Customers can also choose the trigger that fires the notification. Available triggers are:
- Load Balancing pool enabled
- Load Balancing pool disabled
- Load Balancing pool enabled / disabled
Included with
All Cloudflare plans with Load Balancing purchase.
What should you do if you receive one?
No direct call to action.
Magic Transit
Flow-based Monitoring: Auto Advertisement
Who is it for?
Magic Transit on-demand customers who use Flow Based Monitoring and want alerts when Magic Transit is automatically enabled.
Other options / filters
None.
Included with
Purchase of Magic Transit.
What should you do if you receive one?
No action is needed. You can go to the dashboard to review the health and status of your tunnels.
Flow-based Monitoring: Volumetric Attack
Who is it for?
Magic Transit On Demand customers who are using Flow Based Monitoring to detect attacks when Magic Transit is disabled.
Other options / filters
None.
Included with
Purchase of Magic Transit.
What should you do if you receive one?
If you do not have auto advertisement enabled, you need to advertise your IP prefixes to enable Magic Transit. For more information, see Dynamic advertisement .
Origin Monitoring
Origin Error Rate Alert
Who is it for?
Enterprise customers who want to receive a notification when Cloudflare is unable to access their origin server.
Other options / filters
Multiple filters available:
- Customers can search and add domains from their list of domains.
- Customers can also choose the trigger that fires the notification. Available triggers are:
- Low sensitivity
- Medium sensitivity
- High sensitivity
- Very High sensitivity
Included with
Enterprise plans.
What should you do if you receive one?
- Use the link in the Notification you received to see which error codes Cloudflare is seeing from your origin.
Refer to Troubleshooting Cloudflare 5XX errors to learn how to troubleshoot these errors.
Passive Origin Monitoring
Who is it for?
Any customer who wants to receive a notification when Cloudflare is unable to access their origin.
Other options / filters
None.
Included with
All Cloudflare plans.
What should you do if you receive one?
Refer to Troubleshooting Cloudflare 5XX errors to learn how to troubleshoot these errors.
Route Leak Detection
Route Leak Detection Alert
Who is it for?
BYOIP customers who want to receive a notification when their prefixes are advertised in places they should not be.
Other options / filters
None.
Included with
Purchase of BYOIP.
What should you do if you receive one?
Confirm your traffic is healthy: reach out to your transit providers to ensure you are behaving as expected and ask them to follow up with any providers accepting the unauthorized routes.
SSL/TLS
Access mTLS Certificate Expiration Alert
Who is it for?
Access customers that use client certificates for mutual TLS authentication.
Other options / filters
None.
Included with
Access and Cloudflare for SaaS.
What should you do if you receive one?
Upload a renewed certificate .
Dedicated SSL Alert
Who is it for?
Customers with dedicated certificates that want to be alerted on validation, issuance, renewal, and expiration of certificates.
Other options / filters
None.
Included with
When a dedicated certificate is validated, issued, renewed, or expired.
What should you do if you receive one?
Action only needed if notification is about a certificate that failed to be issued. Refer to SSL expired or SSL mismatch errors for more information.
Hostname-level Authenticated Origin Pulls Certificate Expiration Alert
Who is it for?
Customers that upload their own certificate to use with hostname-level Authenticated Origin Pull (AOP) to secure connections from Cloudflare to their origin server.
Other options / filters
None.
Included with
Authenticated Origin Pull.
What should you do if you receive one?
Upload a renewed certificate to use for hostname-level AOP .
SSL for SaaS Custom Hostnames Alert
Who is it for?
Customers with custom hostname certificates who want to receive a notification on validation, issuance, renewal, and expiration of certificates.
Other options / filters
None.
Included with
Purchase of Cloudflare for SaaS.
What should you do if you receive one?
You only need to take action if notified that you have a certificate that failed. You can find the reasons why a certificate is not being issued in Troubleshooting SSL errors.
Universal SSL Alert
Who is it for?
Customers with universal certificates who want to receive a notification on validation, issuance, and renewal of certificates.
Other options / filters
None.
Included with
All Cloudflare plans.
What should you do if you receive one?
You only need to take action if notified that you have a certificate that failed. You can find the reasons why a certificate is not being issued in Troubleshooting SSL errors.
Zone-level Authenticated Origin Pulls Certificate Expiration Alert
Who is it for? Customers that upload their own certificate to use with zone-level Authenticated Origin Pull (AOP) to secure connections from Cloudflare to their origin server.
Other options / filters
None.
Included with Authenticated Origin Pull
What should you do if you receive one? Upload a renewed certificate to use for zone-level AOP .
Script Monitor
Script Monitor New Code Change Detection Alert
Who is it for?
Page Shield customers who want to receive a notification when JavaScript dependencies change in the pages of their domain.
Other options / filters
None.
Included with
Enterprise plans with paid add-on.
What should you do if you receive one?
Investigate to confirm it is an expected change.
Script Monitor New Domain Alert
Who is it for?
Page Shield customers who want to receive a notification when JavaScript dependencies from new host domains appear in their domain.
Other options / filters
None.
Included with
Business plans or higher.
What should you do if you receive one?
Investigate to confirm it is an expected change.
Script Monitor New Malicious Domain Alert
Who is it for?
Page Shield customers who want to receive a notification when JavaScript dependencies from a known malicious domain appear in their domain.
For more information, refer to Detecting malicious scripts
.
Other options / filters
None.
Included with
Enterprise plans with paid add-on.
What should you do if you receive one?
Review the information in the Page Shield dashboard about the detected malicious scripts, and eventually update the pages where the scripts were detected.
For more information, refer to Review scripts considered malicious .
Script Monitor New Malicious Script Alert
Who is it for?
Page Shield customers who want to receive a notification when Cloudflare classifies JavaScript dependencies in their domain as malicious.
For more information, refer to Detecting malicious scripts
.
Other options / filters
None.
Included with
Enterprise plans with paid add-on.
What should you do if you receive one?
Review the information in the Page Shield dashboard about the detected malicious scripts, and eventually update the pages where the scripts were detected.
For more information, refer to Review scripts considered malicious .
Script Monitor New Malicious URL Alert
Who is it for?
Page Shield customers who want to receive a notification when JavaScript dependencies from a known malicious URL appear in their domain.
For more information, refer to Detecting malicious scripts
.
Other options / filters
None.
Included with
Enterprise plans with paid add-on.
What should you do if you receive one?
Review the information in the Page Shield dashboard about the detected malicious scripts, and eventually update the pages where the scripts were detected.
For more information, refer to Review scripts considered malicious .
Script Monitor New Scripts Alert
Who is it for?
Page Shield customers who want to receive a notification when new JavaScript dependencies appear in their domain.
Other options / filters
None.
Included with
Business plans or higher.
What should you do if you receive one?
Investigate to confirm it is an expected change.
Script Monitor New Script Exceeds Max URL Length Alert
Who is it for?
Page Shield customers who want to receive a notification when a script’s URL exceeds the maximum allowed length.
Other options / filters
None.
Included with
Business plans or higher.
What should you do if you receive one?
Manually check the script.
Stream
Stream Live Notifications
Who is it for?
Customers who are using Stream and want to receive webhooks with the status of their videos.
Other options / filters
Customers can input Stream Live IDs to receive notifications only about those inputs. If left blank, customers will receive a list for all inputs.
The following input states will fire notifications. Customers can toggle them on or off:
live_input.connectedLive_input.disconnected
Included with
Stream subscription.
What should you do if you receive one?
Stream notifications are entirely customizable by the customer. Action will depend on the customizations enabled.
WAF
Advanced Security Events Alert
Who is it for?
Enterprise customers who want to receive alerts about spikes in specific services that generate log entries in firewall events.
For more information, refer to WAF alerts .
Other options / filters
Customers can search for and add domains from their list of enterprise zones. Customers also have to choose which services the alert should monitor (Managed Firewall, Rate Limiting, etc.).
Included with
Enterprise plans.
What should you do if you receive one?
Review the information in Firewall Analytics to identify any possible attack or misconfiguration.
Security Events Alert
Who is it for?
Business and Enterprise customers who want to receive alerts about spikes across all services that generate log entries in firewall events.
For more information, refer to WAF alerts .
Other options / filters
Customers can search for and add domains from their list of business or enterprise zones. The notification will be sent for the domains chosen.
Included with
Business and Enterprise plans.
What should you do if you receive one?
Review the information in Firewall Analytics to identify any possible attack or misconfiguration.
Workers
Workers Usage Report
Who is it for?
Developers using Workers, especially those on the Unbound usage model.
Other options / filters None.
Included with
Workers subscription (free or paid).
What should you do if you receive one?
Check any recent changes to your script or its external dependencies. Usage reports inform users of a sharp increase (25% or more) in key metrics like CPU time.
Workers Weekly Summary
Who is it for?
Developers using Workers.
Other options / filters None.
Included with
Workers subscription (free or paid).
What should you do if you receive one?
No action is usually required. This notification gives users a high-level overview of their key Workers’ metrics without having to check the dashboard. Possible metrics include account usage and per-worker usage.