Data egress from self-hosted instances

What data does PostHog collect from self-hosted instances?

In order to understand usage, build better products, and bill customers accurately, PostHog instances routinely send usage reports to our servers. In addition, this data helps us troubleshoot when we provide support. These reports do not contain any raw person, event, or group data — ie no identifiable or unique information from your users, only anonymized, aggregated data.

What if I cannot allow data egress or need to run in an air gapped environment?

We are committed to supporting businesses whose user data is subject to privacy regulations, or whose compliance postures dictate that internally generated data be isolated from the internet. For customers that need our paid features, we offer the ability to run PostHog in air gapped environments, or without sending this status ping, on the Enterprise plan.

What data is sent in the usage report?

The following is an example status report that would be sent from your instance to PostHog's servers.

JSON

{
    "id": "01808211-23a9-0000-354b-a5da0697932b",
    "timestamp": "2022-05-02T00:00:02.293000+00:00",
    "event": "user instance status report",
    "distinct_id": "VY1tssVQViiUWdVY1tssVQViiUWdVY1tssVQViiUWd",
    "properties": {
        "$geoip_city_name": "London",
        "$geoip_continent_code": "EU",
        "$geoip_continent_name": "Europe",
        "$geoip_country_code": "GB",
        "$geoip_country_name": "United Kingdom",
        "$geoip_latitude": 51.5368,
        "$geoip_longitude": -0.6718,
        "$geoip_postal_code": "SL1",
        "$geoip_subdivision_1_code": "ENG",
        "$geoip_subdivision_1_name": "England",
        "$geoip_time_zone": "Europe/London",
        "$ip": "165.22.112.27",
        "$lib": "posthog-python",
        "$lib_version": "1.4.4",
        "$plugins_deferred": [
            "Hubspot (2788)"
        ],
        "$plugins_failed": [],
        "$plugins_succeeded": [
            "GeoIP (80)",
            "Clearbit Enhance User (2911)",
            "Property Flattener Plugin (93)",
            "First Time Event Tracker (7272)"
        ],
        "$set": {
            "$geoip_city_name": "London",
            "$geoip_country_name": "United Kingdom",
            "$geoip_country_code": "GB",
            "$geoip_continent_name": "Europe",
            "$geoip_continent_code": "EU",
            "$geoip_postal_code": "SL1",
            "$geoip_latitude": 51.5368,
            "$geoip_longitude": -0.6718,
            "$geoip_time_zone": "Europe/London",
            "$geoip_subdivision_1_code": "ENG",
            "$geoip_subdivision_1_name": "England"
        },
        "$set_once": {
            "$initial_geoip_city_name": "London",
            "$initial_geoip_country_name": "United Kingdom",
            "$initial_geoip_country_code": "GB",
            "$initial_geoip_continent_name": "Europe",
            "$initial_geoip_continent_code": "EU",
            "$initial_geoip_postal_code": "SL1",
            "$initial_geoip_latitude": 51.5368,
            "$initial_geoip_longitude": -0.6718,
            "$initial_geoip_time_zone": "Europe/London",
            "$initial_geoip_subdivision_1_code": "ENG",
            "$initial_geoip_subdivision_1_name": "England"
        },
        "clickhouse_version": "21.6.5",
        "deployment": "helm_do_ha",
        "helm": {
            "chart_version": "18.2.3",
            "cloud": "do",
            "deployment_type": "helm",
            "hostname": "playground.posthog.net",
            "ingress_type": "nginx",
            "kube_version": "v1.22.7",
            "operation": "upgrade",
            "release_name": "posthog",
            "release_revision": 9
        },
        "helm__chart_version": "18.2.3",
        "helm__cloud": "do",
        "helm__deployment_type": "helm",
        "helm__hostname": "playground.posthog.net",
        "helm__ingress_type": "nginx",
        "helm__kube_version": "v1.22.7",
        "helm__operation": "upgrade",
        "helm__release_name": "posthog",
        "helm__release_revision": 9,
        "instance_usage_summary": {
            "events_count_new_in_period": 0,
            "persons_count_new_in_period": 0,
            "persons_count_total": 52113,
            "events_count_total": 1627639,
            "dashboards_count": 10,
            "ff_count": 1,
            "using_groups": true
        },
        "instance_usage_summary__dashboards_count": 10,
        "instance_usage_summary__events_count_new_in_period": 0,
        "instance_usage_summary__events_count_total": 1627639,
        "instance_usage_summary__ff_count": 1,
        "instance_usage_summary__persons_count_new_in_period": 0,
        "instance_usage_summary__persons_count_total": 52113,
        "instance_usage_summary__using_groups": true,
        "is_first_event_in_session": true,
        "license_keys": [
            "BGQQQQQQQQQQQQQQQQQQQQQQQQQQqqqqq"
        ],
        "license_keys__0": "BGQQQQQQQQQQQQQQQQQQQQQQQQQQqqqqq",
        "period": {
            "start_inclusive": "2022-04-25T00:00:00+00:00",
            "end_inclusive": "2022-05-01T23:59:59.999999+00:00"
        },
        "period__end_inclusive": "2022-05-01T23:59:59.999999+00:00",
        "period__start_inclusive": "2022-04-25T00:00:00+00:00",
        "plugins_enabled": {
            "GeoIP": 37,
            "Avo": 1
        },
        "plugins_enabled__Avo": 1,
        "plugins_enabled__GeoIP": 37,
        "plugins_installed": {
            "GeoIP": 38,
            "job": 1,
            "both servers": 1,
            "onEvent": 1,
            "Avo": 2,
            "Avo New": 1,
            "THE CRASH": 1
        },
        "plugins_installed__Avo": 2,
        "plugins_installed__Avo New": 1,
        "plugins_installed__GeoIP": 38,
        "plugins_installed__THE CRASH": 1,
        "plugins_installed__both servers": 1,
        "plugins_installed__job": 1,
        "plugins_installed__onEvent": 1,
        "posthog_version": "1.35.0",
        "realm": "hosted-clickhouse",
        "scope": "user",
        "site_url": "https://playground.posthog.net",
        "table_sizes": {
            "posthog_event": 57344,
            "posthog_sessionrecordingevent": 49152
        },
        "table_sizes__posthog_event": 57344,
        "table_sizes__posthog_sessionrecordingevent": 49152,
        "teams": {
            "2": {
                "events_count_total": 1616800,
                "events_count_new_in_period": 0,
                "events_count_by_lib": {
                    "web": 370048,
                    "null": 1246752
                },
                "events_count_by_name": {
                    "$autocapture": 210240,
                    "$exception": 11935,
                    "$identify": 31362,
                    "Lead": 33,
                    "$pageleave": 16593,
                    "$pageview": 122770
                },
                "duplicate_distinct_ids": {
                    "prev_total_ids_with_duplicates": 0,
                    "prev_total_extra_distinct_id_rows": 0,
                    "new_total_ids_with_duplicates": 0,
                    "new_total_extra_distinct_id_rows": 0
                },
                "multiple_ids_per_person": {
                    "total_persons_with_more_than_2_ids": 0,
                    "max_distinct_ids_for_one_person": 0
                },
                "group_types_count": 3,
                "persons_count_total": 50350,
                "persons_count_new_in_period": 0,
                "dashboards_count": 1,
                "dashboards_template_count": 0,
                "dashboards_shared_count": 0,
                "dashboards_tagged_count": 0,
                "ff_count": 1,
                "ff_active_count": 1
            },
            "35": {
                "events_count_total": 0,
                "events_count_new_in_period": 0,
                "events_count_by_lib": {},
                "events_count_by_name": {},
                "duplicate_distinct_ids": {
                    "prev_total_ids_with_duplicates": 0,
                    "prev_total_extra_distinct_id_rows": 0,
                    "new_total_ids_with_duplicates": 0,
                    "new_total_extra_distinct_id_rows": 0
                },
                "multiple_ids_per_person": {
                    "total_persons_with_more_than_2_ids": 0,
                    "max_distinct_ids_for_one_person": 0
                },
                "group_types_count": 0,
                "persons_count_total": 0,
                "persons_count_new_in_period": 0,
                "dashboards_count": 1,
                "dashboards_template_count": 0,
                "dashboards_shared_count": 0,
                "dashboards_tagged_count": 0,
                "ff_count": 0,
                "ff_active_count": 0
            },
            "36": {
                "events_count_total": 10839,
                "events_count_new_in_period": 0,
                "events_count_by_lib": {},
                "events_count_by_name": {},
                "duplicate_distinct_ids": {
                    "prev_total_ids_with_duplicates": 0,
                    "prev_total_extra_distinct_id_rows": 0,
                    "new_total_ids_with_duplicates": 0,
                    "new_total_extra_distinct_id_rows": 0
                },
                "multiple_ids_per_person": {
                    "total_persons_with_more_than_2_ids": 0,
                    "max_distinct_ids_for_one_person": 0
                },
                "group_types_count": 0,
                "persons_count_total": 1763,
                "persons_count_new_in_period": 0,
                "dashboards_count": 3,
                "dashboards_template_count": 0,
                "dashboards_shared_count": 0,
                "dashboards_tagged_count": 0,
                "ff_count": 0,
                "ff_active_count": 0
            }
        },
        "teams__2__dashboards_count": 1,
        "teams__2__dashboards_shared_count": 0,
        "teams__2__dashboards_tagged_count": 0,
        "teams__2__dashboards_template_count": 0,
        "teams__2__duplicate_distinct_ids__new_total_extra_distinct_id_rows": 0,
        "teams__2__duplicate_distinct_ids__new_total_ids_with_duplicates": 0,
        "teams__2__duplicate_distinct_ids__prev_total_extra_distinct_id_rows": 0,
        "teams__2__duplicate_distinct_ids__prev_total_ids_with_duplicates": 0,
        "teams__2__events_count_by_lib": {},
        "teams__2__events_count_by_name": {},
        "teams__2__events_count_new_in_period": 0,
        "teams__2__events_count_total": 1616800,
        "teams__2__ff_active_count": 1,
        "teams__2__ff_count": 1,
        "teams__2__group_types_count": 3,
        "teams__2__multiple_ids_per_person__max_distinct_ids_for_one_person": 0,
        "teams__2__multiple_ids_per_person__total_persons_with_more_than_2_ids": 0,
        "teams__2__persons_count_new_in_period": 0,
        "teams__2__persons_count_total": 50350,
        "teams__35__dashboards_count": 1,
        "teams__35__dashboards_shared_count": 0,
        "teams__35__dashboards_tagged_count": 0,
        "teams__35__dashboards_template_count": 0,
        "teams__35__duplicate_distinct_ids__new_total_extra_distinct_id_rows": 0,
        "teams__35__duplicate_distinct_ids__new_total_ids_with_duplicates": 0,
        "teams__35__duplicate_distinct_ids__prev_total_extra_distinct_id_rows": 0,
        "teams__35__duplicate_distinct_ids__prev_total_ids_with_duplicates": 0,
        "teams__35__events_count_by_lib": {},
        "teams__35__events_count_by_name": {},
        "teams__35__events_count_new_in_period": 0,
        "teams__35__events_count_total": 0,
        "teams__35__ff_active_count": 0,
        "teams__35__ff_count": 0,
        "teams__35__group_types_count": 0,
        "teams__35__multiple_ids_per_person__max_distinct_ids_for_one_person": 0,
        "teams__35__multiple_ids_per_person__total_persons_with_more_than_2_ids": 0,
        "teams__35__persons_count_new_in_period": 0,
        "teams__35__persons_count_total": 0,
        "teams__36__dashboards_count": 3,
        "teams__36__dashboards_shared_count": 0,
        "teams__36__dashboards_tagged_count": 0,
        "teams__36__dashboards_template_count": 0,
        "teams__36__duplicate_distinct_ids__new_total_extra_distinct_id_rows": 0,
        "teams__36__duplicate_distinct_ids__new_total_ids_with_duplicates": 0,
        "teams__36__duplicate_distinct_ids__prev_total_extra_distinct_id_rows": 0,
        "teams__36__duplicate_distinct_ids__prev_total_ids_with_duplicates": 0,
        "teams__36__events_count_by_lib": {},
        "teams__36__events_count_by_name": {},
        "teams__36__events_count_new_in_period": 0,
        "teams__36__events_count_total": 10839,
        "teams__36__ff_active_count": 0,
        "teams__36__ff_count": 0,
        "teams__36__group_types_count": 0,
        "teams__36__multiple_ids_per_person__max_distinct_ids_for_one_person": 0,
        "teams__36__multiple_ids_per_person__total_persons_with_more_than_2_ids": 0,
        "teams__36__persons_count_new_in_period": 0,
        "teams__36__persons_count_total": 1763,
        "users_who_logged_in": []
    },
    "elements_chain": ""
}

What data does PostHog collect from self-hosted instances?

What if I cannot allow data egress or need to run in an air gapped environment?

What data is sent in the usage report?

Questions?

Was this page useful?

Data deletion