Ingestion Alert

Last updated:

What does the Ingestion Alert app do?

This app triggers a webhook when no events have been ingested for a specified period of time. It can be used to alert you when ingestion for your project / instance is not working correctly.

What are the requirements for this app?

The Ingestion Alert app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

How do I install the Ingestion Alert app?

  1. Log in to your PostHog instance
  2. Click 'Apps' on the left-hand tool bar
  3. Search for 'Ingestion Alert'
  4. Select the app, press 'Install' and follow the on-screen instructions

Configuration

OptionDescription
No Ingestion Time Range (minutes)
Type: string
Required: True
This is the number of consecutive minutes with no events before the alert will trigger
WebHook Trigger Alert URL
Type: string
Required: True
This is the webhook we will call when no new events have been detected in the set time range
WebHook Resolve Alert URL
Type: string
Required: True
This is the webhook we will call when new events have been detected again
PostHog API Key
Type: string
Required: True
Your Personal API Key is not the same as the Project API key
URL of your PostHog instance
Type: string
Required: True
Used to monitor ingestion

Why am I not getting ingestion alert notifications?

If you do not have a lot of users, or they are all based in the same timezone you may legitimately have 'dead periods' where no events are generated. To prevent such dead periods causing alerts you can increase the threshold. You can also use the heartbeat app to trigger events during dead periods if you wish to only monitor the ingestion pipeline.

If an alert has already been triggered and ingestion has not recovered for an extended period, you will not receive another reminder that it is down.

This is helpful to monitor if there are any ingestion issues within your posthog instance and within your setup (e.g. using the wrong project key).

If the app server itself is down, this app will not be able to alert you that ingestion has stopped.

Is the source code for this app available?

PostHog is open-source and so are all apps on the platform. The source code for the Ingestion Alert app is available on GitHub.

Who created this app?

We'd like to thank PostHog team member Marcus Hyett and former PostHog team member Kunal for creating the Ingestion Alert app.

Who maintains this app?

This app is maintained by PostHog. If you have issues with the app not functioning as intended, please raise a bug report to let us know!

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.

Questions?

Was this page useful?

Next article

Email Scoring

What does the Email Scoring app do? The Email Scoring app adds email scores to Persons in PostHog, giving you more context on each user. Email scores are added using the Mailboxlayer API . What are the requirements for this app? The Email Scoring app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later. Not running 1.30.0? Find out how to update your self-hosted PostHog deployment ! You'll also need Mailboxlayer access and an API key. How do I…

Read next article