# Product Analytics troubleshooting - Docs This page covers troubleshooting for Product Analytics and event capture. For setup, see the [installation guides](/docs/product-analytics/installation.md). ## Have a question? Ask PostHog AI Ask PostHog AI ## Event capture questions ### Why are events not appearing in my project? **1\. Your library is configured incorrectly** This is the most common reason events don't appear. To debug this, you can try sending events to `https://webhook.site/`. Make sure to not use sensitive data while debugging using third-party tools. 1. Visit [webhook.site](https://webhook.site/) and copy “Your unique URL”. 2. In your PostHog [initialization code](/docs/product-analytics/installation.md), replace "[https://us.i.posthog.com"](https://us.i.posthog.com%22) or "[https://eu.i.posthog.com"](https://eu.i.posthog.com%22) if using the EU Cloud) with the URL you copied from webhook.site. For example: PostHog AI ### web ```web posthog.init('', { api_host: '', defaults: '2026-01-30' }) // Replace with the URL you copied from webhook.site ``` ### Node.js ```javascript const client = new PostHog( '_6SG-F7I1vCuZ-HdJL3VZQqjBlaSb1_20hDPwqMNnGI', { host: '' } // Replace with the URL you copied from webhook.site ) ``` ### React ```jsx // src/index.js import React from 'react'; import ReactDOM from 'react-dom/client'; import App from './App'; import { PostHogProvider} from '@posthog/react' const options = { api_host: '' } // Replace with the URL you copied from webhook.site } const root = ReactDOM.createRoot(document.getElementById('root')); root.render( ); ``` ### Ruby ```ruby posthog = PostHog::Client.new({ api_key: "", host: "", # Replace with the URL you copied from webhook.site on_error: Proc.new { |status, msg| print msg } }) ``` 3. Send a few events from your app. If events are *not* visible in webhook.site, that means you have misconfigured your PostHog library, or incorrectly formatted your events. Consult our [guide for how to initialize PostHog](/docs/product-analytics/installation.md). If events are visible in webhook.site, it means that you have configured PostHog correctly. **2\. PostHog is adblocked** PostHog can be adblocked, even locally. This prevents requests from being sent from your app to PostHog. If you're just testing your setup in development, disable your browser ad blocker and make sure you can see PostHog requests succeeding in the network tab of your browser's developer tools. For production, the best way to limit the impact of ad blockers is to [set up a reverse proxy](/docs/advanced/proxy.md). **3\. An app has been configured incorrectly** Another common reason for missing events is that an app has been configured to drop certain or all events. To debug if this is the case, follow these steps in order: 1. If you're using the [Filter Out](/cdp/filter-out.md) app, ensure that it is configured correctly. 2. Try to temporarily disable the Filter Out plugin. 3. Try to temporarily disable all other enabled plugins. **4\. There is a bug in the PostHog library** Sometimes, bugs in the PostHog library may be the cause of missing events. However, this is quite rare. To debug if this is the issue, most of our SDKs have an option to [enable debug logging](/docs/libraries.md). If you're using the [JavaScript web](/docs/libraries/js.md) library, you can identify failed requests using the network tab in your browser devtools: 1. Open devtools in your browser and switch to the network tab. 2. Identify the failed requests to `https://us.i.posthog.com/e` (or `https://eu.i.posthog.com/e` if you're using EU Cloud). 3. Right click one of those requests and click Copy -> Copy as cURL. 4. See below on how to [report your issue](#report-your-issue) and attach your cURL command to get further support. **5\. Events are not ingested after being received by PostHog** If your library is configured correctly and successfully sending events to PostHog, events may get lost in the [ingestion pipeline](/docs/how-posthog-works/ingestion-pipeline.md) – e.g. if there is an ongoing outage. To confirm if this is the issue, use the following steps: 1. Ensure PostHog is not experiencing an incident by checking [the status page](https://status.posthog.com), as this may cause ingestion lags. 2. Check PostHog for any [ingestion warnings](https://app.posthog.com/data-management/ingestion-warnings). 3. Send your event as a cURL request directly - i) Copy your cURL request. - If you're using the JavaScript web library, you can copy the cURL request from the network tab in your browser devtools. - If you're using any other library, you can track your outgoing network requests using something like [Wireshark](https://www.wireshark.org/) and format them as a cURL request. - ii) [Decode your request](/docs/product-analytics/troubleshooting.md#step-1-decode-your-curl-command). - iii) Send your event a cURL request. Wait 1 hour and check if the event is still not visible in PostHog. Once you have confirmed there is an issue with event ingestion, you can [report your issue](#report-your-issue) to get further support. ### It's none of the above. How do I report an issue? **Step 1: Decode your cURL command** 1. Your copied cURL command will look similar to this: PostHog AI ``` curl 'http://localhost:3000/e?ip=1&_=1691496272289&ver=1.53.4' \ -H 'Origin: http://localhost:3000' \ --data-raw 'data=W3siZXZlbnQiOiJjaGFuZ2UgYmlsbGluZyBjeWNsZSIsInByb3BlcnRpZXMiOnsiJG9zIjoiTWFjIE9TIFgiLCIkYnJvd3NlciI6IkNocm9tZSIsIiRkZXZpY2VfdHlwZSI6IkRlc2t0b3AiLCIkY3VycmVudF91cmwiOiJodHRwOi8vbG9jYWxob3N0OjMwMDAvcHJpY2luZyIsIiRob3N0IjoibG9jYWxob3N0OjMwMDAiLCIkcGF0aG5hbWUiOiIvcHJpY2luZyIsIiRicm93c2VyX3ZlcnNpb24iOjExNSwiJGJyb3dzZXJfbGFuZ3VhZ2UiOiJlbi1HQiIsIiRzY3JlZW5faGVpZ2h0Ijo5MDAsIiRzY3JlZW5fd2lkdGgiOjE0NDAsIiR2aWV3cG9ydF9oZWlnaHQiOjc5MCwiJHZpZXdwb3J0X3dpZHRoIjo3OTcsIiRsaWIiOiJ3ZWIiLCIkbGliX3ZlcnNpb24iOiIxLjUzLjQiLCIkaW5zZXJ0X2lkIjoicnNsdm9pYXlocjEydXRvbSIsIiR0aW1lIjoxNjkxNDk2MjcxLjc5NywiZGlzdGluY3RfaWQiOiIxODlkNTA4YjBmNDRkNzAtMDBmN2E5MmRkNmE0MzgtMWE1MjU2MzQtMTNjNjgwLTE4OWQ1MDhiMGY1NTJlZSIsIiRkZXZpY2VfaWQiOiIxODlkMTM4ZmMxZjJjMzYtMGQ4MmQ4Njc4NjA4YmUtMWI1MjU2MzQtMTNjNjgwLTE4OWQxMzhmYzIwM2M2NCIsIiRyZWZlcnJlciI6IiRkaXJlY3QiLCIkcmVmZXJyaW5nX2RvbWFpbiI6IiRkaXJlY3QiLCJ0b2tlbiI6InRlc3QiLCIkc2Vzc2lvbl9pZCI6IjE4OWQ1MDhjZmIxMWViMi0wZjkyMjU2YTk1OTBhNS0xYTUyNTYzNC0xM2M2ODAtMTg5ZDUwOGNmYjI0MWZiIiwiJHdpbmRvd19pZCI6IjE4OWQ1MDhjZmIzNDc0Yy0wNmQ2Mzc2NWI3NGEzZi0xYTUyNTYzNC0xM2M2ODAtMTg5ZDUwOGNmYjQ0NzVlIiwiJHBhZ2V2aWV3X2lkIjoiMTg5ZDUwOGFlMjYzOWJmLTAyYjFjNzgwZTRmMDktMWE1MjU2MzQtMTNjNjgwLTE4OWQ1MDhhZTI3NDMxZCJ9LCJvZmZzZXQiOjQ5Mn1d' \ --compressed ``` 2. Copy the base64 encoded string right after `--data-raw 'data=`. 3. Visit [base64decode.org](https://www.base64decode.org/) and paste the encoded string. 4. Click decode and paste the decoded output into this format: PostHog AI ``` POST https://[your-instance].com/i/v0/e/ Content-Type: application/json Body: { "api_key": "", "event": "event_name", "distinct_id": "distinct_id_of_your_user", "properties": { "key1": "value1", "key2": "value2" }, "timestamp": "[optional timestamp in ISO 8601 format]" } ``` **Step 2: Submit a support ticket** 1. [Submit a support ticket via the app](https://app.posthog.com/home#supportModal=bug%3Aingestion). Submit your issue in the below format, and also include the decoded request from step 1. PostHog AI ``` # Library: // e.g. // posthog-python /docs/libraries/python # Library initialization: // e.g. // from posthog import Posthog // posthog = Posthog(phc_yourAPIKey, host='us_or_eu.posthog.com') # What was called: // e.g. // posthog.capture( // "Bob", // "user_signed_up", // { // "login_type": "email", // "is_free_trial": "true" // } // ) # Network request // [include request from previous step here] # What was expected to happen: // e.g. // To see the network call include the login_type property. # What actually happened: // e.g. // The "login_type" property was missing. ``` ### Does PostHog block bots by default? Yes, PostHog blocks most known bots by default, including: | Google bots | Non-Google bots | | --- | --- | | 'adsbot-google' | 'ahrefsbot' | | 'apis-google' | 'applebot' | | 'duplexweb-google' | 'baiduspider' | | 'feedfetcher-google' | 'bingbot' | | 'google favicon' | 'bingpreview' | | 'google web preview' | 'bot.htm' | | 'google-read-aloud' | 'bot.php' | | 'googlebot' | 'crawler' | | 'googleweblight' | 'duckduckbot' | | 'mediapartners-google' | 'facebookexternal' | | 'storebot-google' | 'facebookcatalog' | | 'Google-HotelAdsVerifier' | 'gptbot' | | 'hubspot' | | 'linkedinbot' | | 'mj12bot' | | 'petalbot' | | 'pinterest' | | 'prerender' | | 'rogerbot' | | 'screaming frog', | | 'semrushbot', | | 'sitebulb', | | 'twitterbot', | | 'yahoo! slurp', | | 'yandexbot', | Want a bot added to this list? Request it via [the in-app feedback form](http://us.posthog.com/home#supportModal), or raise an issue in the [posthog-js GitHub repo](https://github.com/PostHog/posthog-js/issues). ### Is it ok for my API key to be exposed and public? It is **ok** for your **project token** (starts with `phc_`) to be public. It is used to initialize PostHog, capture events, evaluate feature flags, and more, but doesn't have access to your private data. Your **personal API key** (starts with `phx_`), however, should **NOT** be public as it enables reading and writing potentially private data. ### How do I rename my events? It's not possible to rename events in PostHog. Renaming is very resource intensive because it requires updating every existing event in the database. It's more practical to give events aliases instead using [actions](/docs/data/actions.md). This [tutorial](/tutorials/how-to-rename-events.md) covers this in detail. ## Insights and queries questions ### How do I speed up my insights and queries? PostHog dedicates huge amounts of infrastructure to running your insight and queries. We also use a specialized database called an OLAP database (Clickhouse in our case) which is optimized for running analytics queries quickly. Sometimes, insights and queries can still be slow. Here are some things you can do to speed them up: **1\. Select a specific event** Filtering by "All events" is useful, but is also much slower than filtering by a specific event. Try using a specific autocaptured or custom event instead. **2\. Reduce the period you're filtering on** A smaller time period means less data to process. You can always adjust the period later if you need to. **3\. Use faster person properties mode** Avoid using `pdi.person.properties.` in your filters and breakdowns, this should only be used if you absolutely need to see what the data for a person looks like right now. Instead, prefer to use `person.properties.` which is much faster. You can find more details about how these modes works in our doc on [how querying works](/docs/how-posthog-works/queries.md#filtering-on-person-properties). ### How do I group or combine events? To combine events, you can use [actions](/docs/data/actions.md). This enables you to combine and filter events for use in insights and other areas of PostHog. Note that actions are different from [group analytics](/docs/product-analytics/group-analytics.md), which enable you to aggregate events at an entity-level, such as organizations or companies ## Solved community questions ### Community questions Ask a question ### Was this page useful? HelpfulCould be better