Install metrics
Contents
Note: Metrics is in open alpha. Any team can turn it on — open Metrics and select Enable metrics in the onboarding view. Setup details, including the ingestion endpoint, may change before general availability.
There are three ways to get metrics into PostHog:
- PostHog SDKs: if a PostHog SDK is already in your app, record metrics with the
posthog.metricsAPI. No new packages, no extra authentication. - OpenTelemetry (OTLP): if you use OpenTelemetry anywhere else, point your OTLP metrics exporter at PostHog. No PostHog packages required.
- Metrics agent: if your services already expose Prometheus
/metricsendpoints, run the PostHog metrics agent with Docker or the Kubernetes Helm chart to scrape and forward them, with no code changes. The same agent can also pull from Google Cloud Monitoring for managed-service metrics like Cloud SQL and load balancers.
Already capturing metrics with Prometheus, StatsD, or Datadog? You don't need to replace anything: add the PostHog call next to your existing instrumentation, using the same metric name and attributes, and migrate at your own pace.
Platforms
| Platform | Method |
|---|---|
| JavaScript (web) | posthog.metrics API in posthog-js |
| Node.js | posthog.metrics API in posthog-node |
| Python | posthog.metrics API in posthog-python |
| Other languages | Any OpenTelemetry-compatible OTLP metrics exporter |
| Docker | Metrics agent container that scrapes Prometheus /metrics targets |
| Kubernetes | Helm chart that scrapes prometheus.io/scrape annotated pods |
| Google Cloud | Metrics agent that pulls Google Cloud Monitoring metrics |
Note: Metrics uses the OpenTelemetry Protocol (OTLP) standard. If your language isn't listed, check the OpenTelemetry documentation for compatible libraries and see other languages.