From 77e6e4ce003dc9af9a818ad03097e42060add14c Mon Sep 17 00:00:00 2001 From: Marko Saric Date: Thu, 22 Oct 2026 10:21:54 +0200 Subject: [PATCH] 22k --- docs/events-api.md | 4 ++++ docs/introduction.md | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/events-api.md b/docs/events-api.md index 5188126c..abe40d8e 100644 --- a/docs/events-api.md +++ b/docs/events-api.md @@ -166,6 +166,10 @@ The API always returns HTTP 202 Accepted, even when an event is dropped. To debu E.g: Add this header to your request and log the response. +**Test the path your real events take.** Run the `X-Debug-Request` check from the same place your production events are sent (your server, worker, edge function or retry job), not only with a one-off test request. `X-Forwarded-For` can be set correctly in your code and still reach us with a different IP: a proxy, CDN, load balancer or hosting provider along the way may replace the header or add its own address to it. If the header contains a comma-separated list, Plausible uses the first valid IP address in it, so make sure the visitor's IP comes first. Also check that the visitor's original `User-Agent` is forwarded, not your server's or HTTP library's default. + +Dropped events can't be added to your stats afterwards, so it's worth running these checks whenever you set up or change your integration. + :::tip Want to monitor the status of our API? You can can use GET https://plausible.io/api/health endpoint to do so ::: diff --git a/docs/introduction.md b/docs/introduction.md index a463170e..cef4c426 100644 --- a/docs/introduction.md +++ b/docs/introduction.md @@ -6,7 +6,7 @@ description: "Plausible Analytics documentation. No cookies, no personal data, n import CtaBox from '@site/src/components/CtaBox'; -[Plausible Analytics](https://plausible.io/) is a simple, privacy-friendly alternative to Google Analytics. No cookies, no personal data collection, no consent banners required. One lightweight script, one easy-to-read dashboard. Running since 2018 and used by 21,000+ teams. Explore the [live demo](https://plausible.io/plausible.io) to see what it looks like. +[Plausible Analytics](https://plausible.io/) is a simple, privacy-friendly alternative to Google Analytics. No cookies, no personal data collection, no consent banners required. One lightweight script, one easy-to-read dashboard. Running since 2018 and used by 22,000+ teams. Explore the [live demo](https://plausible.io/plausible.io) to see what it looks like.