Manage alerts
One of the most powerful features of Profundis is its ability to alert you when a new asset is discovered. You can create alert tasks based on one of multiple fields. Alerting is a paid feature: Free accounts cannot enable any alert. The number of active alerts you can have and the alerts-per-hour rate both depend on your subscription plan.
You only receive alerts for newly discovered assets, never for ones already in our data. You can run a hosts search to see if the data is already present in Profundis. You can create alerts on Hosts, Certificates (virtual hosts), and WHOIS. DNS is the only type not supported. WHOIS alerts require a Professional or Enterprise plan.
Create an alert
To create an alert, make sure you are logged in and navigate to the alerting page. You have 2 ways to create alert tasks:
- Using the Classic mode: this is the easiest method for beginners. Fill up some fields and let us create the regexps automatically.
- Using the Advanced mode: you can create an alert from an example, or create it from scratch yourself. If you are not comfortable with regexps, validate it on regex101.
After creating an alert, it is validated before you can enable it. This usually takes less than 1 second. You can then enable the alert task.
The number of alerts you can receive every hour is limited and depends on your subscription plan. If your alert task matches too much data, it will be disabled automatically. If that happens, review your alert task and make it more precise, or upgrade to a higher plan.
Receiving alerts costs 1 credit per 10 alert notifications (rounded up). You keep receiving them up to your subscription plan's hourly alert rate; if you run out of credits, the alert is paused and you get an email, so you can top up (or wait for your next monthly reset) and re-enable it. See the Credits page for the full cost list.
Receive the alert results
You can integrate with the Profundis alerting system in many ways.
| Alerting methods | Description | Pros | Cons |
|---|---|---|---|
| Use Profundis servers (recommended) | Specify the alerting settings (e.g. webhook, SMTP credentials, etc) in the Profundis UI and let us notify you automatically. | Very easy to use. | You put sensitive information (e.g. SMTP credentials) in the Profundis UI. |
| Profundis alerting Docker image (recommended) | You deploy a Docker container which connects to the Profundis alerts SSE stream. | Your SMTP credentials, Discord webhooks stay on a machine you control and never goes on Profundis servers. You can use filters to send specific alerts via dedicated notification channels (e.g. send alerts which contain a specific value via the Discord webhook n°1, and the rest via the Discord webhook n°2). The alerts are automatically buffered to avoid being rate limited by the notification system you chose (e.g. Discord). The container automatically reconnects to Profundis SSE stream in case of network disruption. | You have to deploy a Docker container. |
| n8n SSE trigger node | Use the n8n SSE trigger node to receive Profundis alerts in your n8n workflow. | You can receive alerts in n8n and handle them as desired with a custom workflow. If you already use n8n the setup will be very quick and easy. | You have to use n8n. In some rare cases, it doesn't automatically reconnect to the SSE alerts stream (requires a restart) and causes the loss of some notifications. |
Miscellaneous
My regexp is pending validation
We validate your regexp before it can be enabled to make sure it is not going to match too many assets. If we detect that your regexp may match too many assets or values, it will be refused. If it happens, edit your query to make it more precise. The regexp validations usually take a few seconds.
I don't receive any alert
You receive alerts only for assets which were NOT already present in Profundis and have just been discovered. Before creating an alert, run a search to see if the data you are looking for is already here. Then, there could be a few reasons why you didn't receive any alert:
- The asset you are looking for has not yet been discovered by Profundis. Be patient.
- Your regexp is not matching the correct value, or is incorrect. Validate it on regex101 to be sure it works.
- Don't forget you receive alerts only for newly discovered assets, never for ones already in our data.
- Your alert was matching too much data and has been disabled automatically. Higher subscription plans can receive more alerts per hour.
- You didn't setup n8n or the Profundis alerting Docker image correctly.
Error: Active alerts limit reached
You may encounter this error when trying to enable an alert task because you reached the maximum number of active alerts for your subscription. If you are a free tier user, you cannot use the alerting feature. Please check our subscription plans.