Skip to content

: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.

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.py
index 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:
return
if 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.py
index 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.py
index 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.ts
index 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.ts
index 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())
+ }
}
}