Skip to main content

External Alerting

External alerting is a feature that allows for automatically updating configurations based on alerts from an external alerting system. The setup is simple and can be done in a couple steps listed below.

  1. Create an external alert for the appropriate alerting system. Supported alerting systems are Datadog, Grafana, and Circonus.
  2. Create a rule that will apply a configuration file to an agent that matches the external alert.

We will be using Circonus as our external alerting system. The following example will apply a Telegraf configuration file to to the linux host that matches "os:linux,os:{host}" when an alert is triggered in Circonus.


  • Passport
  • An observability solution that can send alerts to Passport via a webhook.
  • A configuration file uploaded to Passport.

Create an external alert

Click the External Alerts menu item and select Create External Alert.

Choose the desired key field for the appropriate alerting system. For example, if you are using Circonus, then choose "alert_id" as the key field.


Note: When creating an external alert, you will need to add the generated Passport Webhook URL to your current alerting output to send alerts to Passport. This URL will be provided to you when you create the external alert in the "Webhook URL field on the External Alert list view page".


Create a rule

Select a configuration file from Configurations list view page, then click the Rules tab and select Create Rule.


After creating the rule, ensure the rule weight is set to a higher value than all other existing rules that target the same host. This will ensure that the rule is applied to the agent when the alert is triggered.