:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
feat(apm): record first use of logs, metrics and tracing as person properties (#119399)
Jon McCallumb6bf6ed22e5e
diff --git a/posthog/event_usage.py b/posthog/event_usage.pyindex ecc3076aff2e..13fa98036ba0 100644--- a/posthog/event_usage.py+++ b/posthog/event_usage.py@@ -654,7 +654,7 @@ def report_user_action(if not isinstance(user, User) or not user.distinct_id:returnif user.email:- properties["$set_once"] = {"email": user.email}+ properties["$set_once"] = {**properties.get("$set_once", {}), "email": user.email}with _tracer.start_as_current_span("report_user_action"):posthoganalytics.capture(distinct_id=user.distinct_id,diff --git a/posthog/test/test_event_usage.py b/posthog/test/test_event_usage.pyindex 93b164797da8..d19c67bda465 100644--- a/posthog/test/test_event_usage.py+++ b/posthog/test/test_event_usage.py@@ -239,12 +239,21 @@ class TestReportUserAction(BaseTest):assert mock_capture.call_args[1]["properties"]["access_method"] == expected+ @parameterized.expand(+ [+ ("no_set_once", {}, {}),+ ("caller_set_once_kept", {"$set_once": {"first_used_at": "2026-01-01"}}, {"first_used_at": "2026-01-01"}),+ ]+ )@patch("posthog.event_usage.posthoganalytics.capture")- def test_no_request_passes_properties_unchanged(self, mock_capture):- report_user_action(self.user, "test event", properties={"key": "val"})+ def test_no_request_passes_properties_unchanged(self, _name, extra, expected_set_once, mock_capture):+ report_user_action(self.user, "test event", properties={"key": "val", **extra})mock_capture.assert_called_once()- assert mock_capture.call_args[1]["properties"] == {"key": "val", "$set_once": {"email": self.user.email}}+ assert mock_capture.call_args[1]["properties"] == {+ "key": "val",+ "$set_once": {**expected_set_once, "email": self.user.email},+ }@patch("posthog.event_usage.posthoganalytics.capture")def test_analytics_props_merged_into_capture(self, mock_capture):diff --git a/products/logs/backend/presentation/views/api.py b/products/logs/backend/presentation/views/api.pyindex f111aa788e14..da4b26478de6 100644--- a/products/logs/backend/presentation/views/api.py+++ b/products/logs/backend/presentation/views/api.py@@ -1651,18 +1651,22 @@ class LogsViewSet(TeamAndOrgViewSetMixin, PydanticModelMixin, viewsets.ViewSet):next_cursor = base64.b64encode(json.dumps(cursor_data).encode("utf-8")).decode("utf-8")if not live_logs_checkpoint:+ event_properties: dict[str, object] = {+ "results_count": len(results),+ "has_more": has_more,+ "has_search_term": bool(query_data.get("searchTerm")),+ "has_filter_group": bool(query_data.get("filterGroup")),+ "severity_levels_count": len(query_data.get("severityLevels") or []),+ "service_names_count": len(query_data.get("serviceNames") or []),+ "is_paginated": bool(after_cursor),+ }+ if results:+ # This endpoint serves the app, API keys, MCP and other integrations, so the property covers all of them.+ event_properties["$set_once"] = {"first_used_logs_at": timezone.now().isoformat()}report_user_action(request.user,"logs query executed",- {- "results_count": len(results),- "has_more": has_more,- "has_search_term": bool(query_data.get("searchTerm")),- "has_filter_group": bool(query_data.get("filterGroup")),- "severity_levels_count": len(query_data.get("severityLevels") or []),- "service_names_count": len(query_data.get("serviceNames") or []),- "is_paginated": bool(after_cursor),- },+ event_properties,team=self.team,request=request,)diff --git a/products/metrics/frontend/components/metricsUsageTrackingLogic.ts b/products/metrics/frontend/components/metricsUsageTrackingLogic.tsindex 81a2d5a5f5a5..d1818fa912b9 100644--- a/products/metrics/frontend/components/metricsUsageTrackingLogic.ts+++ b/products/metrics/frontend/components/metricsUsageTrackingLogic.ts@@ -365,6 +365,7 @@ export const metricsUsageTrackingLogic = kea<metricsUsageTrackingLogicType>([// and each intent call is an API request (the backend counts repeats itself).if (!cache.viewerQueryIntentFired) {cache.viewerQueryIntentFired = true+ posthog.setPersonProperties(undefined, { first_used_metrics_at: new Date().toISOString() })actions.addProductIntent({product_type: ProductKey.METRICS,intent_context: ProductIntentContext.METRICS_VIEWER_QUERY_RUN,diff --git a/products/tracing/frontend/tracingDataLogic.ts b/products/tracing/frontend/tracingDataLogic.tsindex 1b8298a7dc5f..d1ca82ff74ce 100644--- a/products/tracing/frontend/tracingDataLogic.ts+++ b/products/tracing/frontend/tracingDataLogic.ts@@ -101,6 +101,12 @@ function captureTracingResults(count: number, queryType: 'spans' | 'aggregation'posthog.capture('tracing no results returned', { query_type: queryType })} else {posthog.capture('tracing results returned', { count, query_type: queryType })+ // $set_once keeps the first value, so one send per browser is enough for survey targeting.+ const stampKey = `ph_first_used_tracing_stamp_${posthog.get_distinct_id()}`+ if (!localStorage.getItem(stampKey)) {+ posthog.setPersonProperties(undefined, { first_used_tracing_at: new Date().toISOString() })+ localStorage.setItem(stampKey, Date.now().toString())+ }}}