[Blog] Practical alerts examples

contents/blog/practical-alerts.mdx

@@ -0,0 +1,139 @@
+---
+title: '6 practical uses for PostHog alerts'
+date: 2024-12-16
+author:
+ - bijan-boustani
+rootpage: /blog
+category: General
+tags:
+  - Alerts
+  - Product updates
+---
+
+To keep life interesting, it's important to live in a state of perpetual ignorance. When things are going well, there's no need to find out why. When things go south, let anxiety run its course.
+
+![Homer covers his eyes](https://res.cloudinary.com/dmukukwp6/image/upload/319051_c8e072f85e.gif)
+
+An alternative, less exciting, approach to life is to become aware as things change. For example, you can use PostHog's new alert features to receive notifications based on your [insights](/docs/product-analytics/insights).
+
+You can track important metrics and get email notifications when they cross threshold that you specify. The threshold can be an absolute value (e.g. pageviews exceeded 1,000) or a relative amount (e.g. conversion rate increased by 10%).
+
+So, instead of having to remember to check in on the status of a a metric or feature; you can receive an email alert when changes occur.
+
+Let's get started with how to create alerts, and then we can dive into some practical examples of how they can be helpful.
+
+## How to create alerts
+
+Alerts are based on your insights. You can select from your existing [trends](/docs/product-analytics/trends/overview), or create a new one.
+
+To create an alert, click the **Alerts** button on the top right of the insight page.
+
+<ProductScreenshot
+    imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/alerts_button_4ecd022cd6.png"
+    imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/alert_button_dark_c2f642fde3.png"
+    alt="alerts button"
+    classes="rounded"
+/>
+
+To configure the alert, we'll set the following:
+
+- **Name:** the name you'll see when the alert is triggered.
+- **When:** the data points the alert will be based on. The drop-down contains a list of all the series in your insight's graph. For example, if you have an insight that tracks the number of pageviews and signups, you can use either of these series as the basis for the alert threshold.
+- **Type:** select "has value" to check if the series is more or less than an absolute amount. Or, select "increases by/decreases by" to check if the series increased or decreased by a relative amount. These can also be configured with a percentage instead of a static value (e.g. signups increased by 10%).
+- **Frequency:** set how often you want to check the alert threshold (hourly, daily, weekly, monthly).
+- **Who to notify:** select who should receive an email when the alert is triggered.
+
+<ProductScreenshot
+    imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/filled_alert_627158e6bb.png"
+    imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/alert_people_dark_0ccd7611bd.png"
+    alt="filled alert"
+    classes="rounded"
+/>
+
+Then, you can click **Create alert**, and you're all set.
+
+<ProductScreenshot
+    imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/insight_alerts_5k_daef47ade1.png"
+    imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/created_alert_dark_1710da74dc.png"
+    alt="insight alerts"
+    classes="rounded"
+/>
+
+For a more detailed walkthrough, you can also check out our our [Alerts docs](https://posthog.com/docs/alerts), which we'll also update as new alerting features get added.
+
+## Practical uses for alerts
+
+Now that we can create alerts, let's take a look at a handful of practical examples.
+
+### 1. Get an alert when traffic spikes
+
+Want to investigate spikes in traffic to your website? This can be useful when testing marketing campaigns to see if they trigger the expected spikes in traffic.
+
+But these kinds of alerts can also be useful to investigate an _unexpected_ spike in traffic. We often see this at PostHog when our content gets featured in a popular email newsletter or shared on Hacker News. When we notice an influx of new signups, it can be interesting to dig in and try to figure out where they came from.
+
+For example, we can get an alert when the number of pageviews for our [pricing page](/pricing) rises above 8,000 views for the week. First, you can [create a new trend insight](/docs/product-analytics/trends/overview#1-creating-a-new-trend) to track pageviews where "Path Name" equals "/pricing". Then, filter by the year to date and group by week.
+
+Then, set up an alert using the steps above to trigger a notification when the number of pageviews rises above 8,000. When the threshold is crossed, this is what the email looks like:
+
+![Pricing pageviews alert](https://res.cloudinary.com/dmukukwp6/image/upload/posthog_alert_df58e89828.png)
+
+### 2. Get notified for 404 page anomalies
+
+You can also use alerts to track down errors. For example, you can track the number of visits to your 404 page. If someone visits `posthog.com/some-nonexistent-url` they will land on our 404 page, and some number of these kinds of visits to this page is to be expected. Anyone that misspells a URL or finds a dead link is bound to land here at some point.
+
+But what about anomalous spikes in 404s? It might mean you deployed a broken link somewhere. Or perhaps you moved a page and need to set up a redirect to prevent users from missing it.
+
+In this case, you can set up another trend insight to graph the number of pageviews for your 404 page. You can examine the graph to establish a baseline for a standard amount of traffic to the 404 page. Then, set up an alert to check when 404s are significantly higher than this baseline.
+
+![Graph of 404s](https://res.cloudinary.com/dmukukwp6/image/upload/404_graph_79107f52bb.png)
+
+One of the great things about these graphs is you can click the graph where you see a spike and it will display a list of all the users effected. And if you have [session replay](/session-replay) enabled, you can go through and watch the session where the 404 occurred and figure out exactly which link is broken.
+
+In addition to 404s, this same logic can be applied to other anomalous events like "rageclicks." Rageclick events are when a user has rapidly and repeatedly clicked in a single place. It could be an indicator that there is some visual affordance that looks like it should be interactive, but users are surprised to find out it does nothing. You can use the same process we used for the 404 visits to hunt down rageclicks as well.
+
+### 3. Alert if billing emails are not sent
+
+Alerts can also be used to check for the _absence_ of something happening.
+
+For example, PostHog tracks the number of transactional billing emails that get sent out every day. If these emails aren't getting sent, it would be a big deal.
+
+To do something similar, you can track events when you trigger these transactional emails. Then, create an insight to track the number of transactional emails sent every day.
+
+Then, we can set up an alert called "No billing events sent" that gets triggered when the transactional emails have a value less than 1.
+
+We can set the frequency to check this daily. And for critical alerts like this, you can add more than one email to the notification list and ensure the entire billing team gets the alert.
+
+### 4. Monitor deploys and new features
+
+With feature flags, you can set up [canary releases](/tutorials/canary-release) to slowly roll out changes and make sure your new features work well before they're released to all your users.
+
+But you still want to monitor deploys and new features to verify that they're having the intended effect and not triggering unexpected errors.
+
+![Simpson, you've got a 513](https://frinkiac.com/meme/S08E23/385084.jpg?b64lines=U0lNUFNPTiwgWU9VJ1ZFIEdPVCBBIDUxMyE=)
+![That got it](https://frinkiac.com/video/S08E23/XOUcScbq8W_7yoA6nti16cCC31A=.gif)
+
+For example, you could track error events and trigger an alert if the error rate rises above a particular threshold after a new feature launch.
+
+But there are more subtle issues that aren't necessarily bugs or errors. For example, you could launch a big redesign for the product pages on your marketing website. Or change the copy on some of your CTAs. Those won't necessarily trigger errors, but they could still have a drastic impact on engagement.
+
+So you can set up an alert that coincides with the launch of your redesigned pages, and verify that the number of clicks for the CTAs on those pages should be increasing, not decreasing.
+
+### 5. Alert on changes in conversion rates
+
+To set alerts on changes in your conversion rate, you can set up an insight that tracks visits to your pricing page as well as user signups. For example, we can create a trend insight and filter for pageviews where "Path Name" equals "/pricing". And then add a filter for our `user_signed_up` event. So this insight will display a graph with a line for the number of pageviews for the pricing page as well as a separate line for the number of users that signed up.
+
+![Conversions](https://res.cloudinary.com/dmukukwp6/image/upload/conversion_graph_d4ac533adf.png)
+
+To find out if the conversion rate is increasing or decreasing by a specified percentage, we can set up multiple alerts. We can set up one alert for when the `user_sign_up` event is increasing by 5% and a separate alert for when the `user_sign_up` event is decreasing by 5%.
+
+### 6. Alert on breakdown in referral sources
+
+Alert on major changes in breakdowns. "For example, I have a graph showing traffic to my site by day broken down by referrer - if there's a major change in who's referring traffic (a bunch of new traffic from a new source, or a previous major source of traffic disappearing) I'd love to be able to get alerts about that, even if the overall traffic total doesn't shift.
+
+> Note: For trends with breakdown, the alert will fire if any of the breakdown values breaches the threshold.
+
+## Upcoming improvements and suggestions
+
+Alerts are currently available for trends insights. But we're currently working on adding alerts for [funnels](/docs/product-analytics/funnels), which will make it easier to track conversions across various stages. For example, we can create a funnel to see how many users are following through and signing up after visiting our pricing page.
+
+Thanks to [Anirudh](/community/profiles/30974) for making this much-requested feature a reality. The idea for threshold-based alerts started as a [GitHub Issue](https://github.com/PostHog/posthog/issues/14331), so if you have other interesting use cases and suggestions for how to improve the features be sure to let us know!

contents/founders/posthog-first-five.md

@@ -64,7 +64,7 @@ Eric has worn many hats since joining PostHog, building many of our user-facing
 
 ![James](https://res.cloudinary.com/dmukukwp6/image/upload/v1710055416/posthog.com/contents/images/blog/posthog-first-five/james.png)
 
-In the early days, James would check out people who starred the GitHub repo and sometimes get in touch to gather feedback. One day, he spied a data engineer at Uber, [James Greenhill](/community/profiles/90) (aka Jams), had left a star and this piqued his interest.
+In the early days, James would check out people who starred the GitHub repo and sometimes get in touch to gather feedback. One day, he spied a data engineer at Uber, [James Greenhill](/community/profiles/30174) (aka Jams), had left a star and this piqued his interest.
 
 On a call, Jams explained Uber had built a bunch of internal tools like PostHog for data control reasons. He found the project interesting and wanted to work on it, so he did a SuperWeek like Eric and Marius.