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(aio): copy a trace as json from the trace view header (#128320)

Carlos Marchal49df67e50408
diff --git a/frontend/snapshots.yml b/frontend/snapshots.yml
index bdb63e520624..e08af82817ad 100644
--- a/frontend/snapshots.yml
+++ b/frontend/snapshots.yml
@@ -9867,17 +9867,17 @@ snapshots:
scenes-app-ai-observability-trace-view-trace-header--errored--light:
hash: v1.k794b7964.d5f529b017815acb1ebb9574f158ba7f125210f01a492ec0e1c1793d3d552218.C3M8ObMcwOFWzDFvX1hkAWjday-8dCOdkxLJU4AtDHc
scenes-app-ai-observability-trace-view-trace-header--export-in-progress--dark:
- hash: v1.k794b7964.57c93cae2eef4eee189f48880adc2b22b1c1a3b88dadd4a0ac07a1d0a6526cf3.UptFxwVnwWfGrxl5_1vOFsZz9tgWPUuSb8_evEdSjh0
+ hash: v1.k794b7964.cdca65817ea42d7fba17da5d54812469f72c0d77404796fe3e2a85b117e21c84.zC60jMAMHlDtYXjA0QMGb2zyAnn7xNHRldHuw4ZxrsA
scenes-app-ai-observability-trace-view-trace-header--export-in-progress--light:
- hash: v1.k794b7964.f40e96fc673c00ea5224003a9c29fdcee8ff7db093387dd9fbee0346e90d474d.n9vOY-54g3oEWRmYP3K51gbjx1-OGDs8Ra06-tAI3og
+ hash: v1.k794b7964.8615c73feb84715f639c8a7a11c3ae5fe42b802a336760076f80b0240accadbb.KiZXnkxRtxHfAtmtEg3Xxdx5y38oYkcOLev0YtZgKAY
scenes-app-ai-observability-trace-view-trace-header--narrow--dark:
- hash: v1.k794b7964.ea52b401ffc33beb9f082516bf764a2731bd65284027cb5cef1b9ee04157b39a.LsqLoMh2PKAYes9ihiMfV1RsqVRHgZMxSbw5S3JT-9s
+ hash: v1.k794b7964.a95423f6eb74b76952c0bfe0adb395116d343ec76555537177aa480d872b1490.LbS2weV40SPCGlcMgboTXue8ix6TFpI4b1b_TJQM27w
scenes-app-ai-observability-trace-view-trace-header--narrow--light:
- hash: v1.k794b7964.6bc90881d4596b3c892811a66f67c395f86799caf26f327dfe2a44945085cbb7.Edb7kJq3DRne4_k7BrkP_BrCettDLuCURrJGSZDBPLg
+ hash: v1.k794b7964.dc5b0e28a00ba8bd9ae5d09fadeef8d6d69faf94fa846ff1009f89776a6c3405.5XO1WXB7B87kkAR1BzBd8gxgOOg_oue0a9HWbgSRPDI
scenes-app-ai-observability-trace-view-trace-header--with-export--dark:
- hash: v1.k794b7964.412edd0fd0487ad65c586eef9982a8df72ae5ba4a8cd5d699b140c5aeeb1d9b5.A-Yowqo_MogMzkgjQNPJcW_nVeucgwEGTIy515lBuk8
+ hash: v1.k794b7964.7d6d5e0f42e2a5724b22c1a18e81f962214116fe27668c8726a58eacd8192296.cJr6hdjOB0w9T1TZLe3kZGfN_fVNwIMyW_PSePtFzaQ
scenes-app-ai-observability-trace-view-trace-header--with-export--light:
- hash: v1.k794b7964.d5d608523adc04cd94b2b6127564adede8b7a27ba93ed629a91a351c12415797.DcYDxy5gkejL1ri_qZMc5sqJoU2rsmSst9SwodqdItU
+ hash: v1.k794b7964.676f5bd748974a84c35a6b2ad712b90d5e8a134682f626817612a661623db130.rFNm41OBmR-STUiECpezB28ipN0R9IU8MLAL0nK-whY
scenes-app-ai-observability-trace-view-trace-header--with-search--dark:
hash: v1.k794b7964.bb8b7faaef569161d5b2788f30aa0727ec872283ed6a03fa5d0ce5bf0eb0eb06.APtzVe9PIqbFv-svcGxEKA1LXDeduuxpObWKAVW0tho
scenes-app-ai-observability-trace-view-trace-header--with-search--light:
@@ -10027,21 +10027,21 @@ snapshots:
scenes-app-ai-observability-trace-view-trace-tree--with-search-matches--light:
hash: v1.k794b7964.256649d42ee8d767ea2e76aea6a996c3bb484fda062549d98232f777b626db20.fMY_pk-8vczLIfWg6X_0rG2JJdaG3kmVSpo16joT90w
scenes-app-ai-observability-trace-view-trace-view--error-trace--dark:
- hash: v1.k794b7964.7085c7f7bd764554d0489f7230d4820206118611d1465728b7755b0f8e2683d1._7qbxWnsgMZ_ZQ8zzgw0UOspO_fFlB6pS-tZXRotPt4
+ hash: v1.k794b7964.caf990e38d05173541881510b22dea4c65b70db0c69b617cf5bf227f1c69825a.BlrORTET_6u32l8l2RLY3EhQFke3ZoJ1wbC8vl-GU-A
scenes-app-ai-observability-trace-view-trace-view--error-trace--light:
- hash: v1.k794b7964.1b21679eff548b599eb2dea532ea2b690c4b7f9992d8dd71a4e2f618f49974c9.1o-nlOKjZhVJHdS-d9UqTP51HA7OcgbUlkadg8s06EU
+ hash: v1.k794b7964.39b069183caf0c42083220b9a48538e891c9d38bffb4086d96222ac1d12975ee.ZD5WabzT0H75834dEaEkbekLQaL4vfUf-6V-bA9rZCs
scenes-app-ai-observability-trace-view-trace-view--feedback-mode--dark:
- hash: v1.k794b7964.f0f8abade6242178a102106e1ff1beb32e1245ad5d6282a4bd5a35abfa97212f.aCTxPd846zEcV61n-alopbaqQ8P0E4If_r7DLaXWYA8
+ hash: v1.k794b7964.fa9e765d90669b4f486795580eec3fd2af292116033f9ded266f196e44e97277.e0tAOWx5plfJLW63iLmBsgV-0A1dmhDJPI11eKDht3s
scenes-app-ai-observability-trace-view-trace-view--feedback-mode--light:
- hash: v1.k794b7964.c925b0ebfcbb3da6332350bb47fa803e840a3031f94b8cf3b7abe54001a1fd70.pnt2DBUbAt513gy6lz0MDRd4U8crb7uzj392lDPbaI4
+ hash: v1.k794b7964.4cc0d03d9c1beb45073f475cccf44252245383c468f4a239a1b30c7343fd9ae2.F-jj5TdzgFjHZxmXIvrfqyILazO4I-uN9KjmvJdSWPM
scenes-app-ai-observability-trace-view-trace-view--fills-short-host--dark:
hash: v1.k794b7964.9e0b000ae88002006a68108afa565e70a952ef84a955e24c4a1e447e9dda39e5.YqWJUnnrBANrcCTjw0UgsXFaB18gm_vJOyg_iYmGGwk
scenes-app-ai-observability-trace-view-trace-view--fills-short-host--light:
hash: v1.k794b7964.64783b1bb137693bcb2fbe2dd1031e391dfa5d0ca21cbeeff72451330ce5e170.qsha2FkM50UQV2Yq6qEfhgrkSxrxHtx39BuRjSSA1iI
scenes-app-ai-observability-trace-view-trace-view--generation-selected--dark:
- hash: v1.k794b7964.bae531b1be9da9f5dfb662955e73095ae96716ad166795e671f16408cfdfa24d.iRrceUDV3xYj9RwrBCgkz6s3UgcjB1oOdJb8ncy-P8E
+ hash: v1.k794b7964.65335c8deb870f950d3828218223118b14454cc532c7816cb9ac93825b468c60.Y0wK0sq6TrejF4vNRblsP3WgHJ_0Aws1ApizOcmv8aw
scenes-app-ai-observability-trace-view-trace-view--generation-selected--light:
- hash: v1.k794b7964.dd2cba6d414bdb3bfc61f3515871cb83c3cc9afd01b1d387b77195eebcc8134a.-ZL-40uvP_v5zFegNnOLCJw2rfoXHHbJrMMm8OxCMYc
+ hash: v1.k794b7964.2b4165665a2b86f5d7e0241a7f1a86b9e748b7967a8e7f2e9849ef1b546b6129.N3NQV8dWyC1oDbqanYczwFIt0VRUCT3w4DyvIYKMxSA
scenes-app-ai-observability-trace-view-trace-view--load-error--dark:
hash: v1.k794b7964.c4e963947f61276470d35e280b1b69130365cde0f3153efba7bfbab805e496de.B2FhLvOWBsI-x3axjIDbfrTFGaYKLtFR32l7sn4SCfI
scenes-app-ai-observability-trace-view-trace-view--load-error--light:
@@ -10059,9 +10059,9 @@ snapshots:
scenes-app-ai-observability-trace-view-trace-view--narrow-with-evals--light:
hash: v1.k794b7964.0530822f7f324be82e6d20dd8e83593df0711024c97435a3fe0b02fece25923d.YCzyVwrI7LMYPYMIgvGLDf1ICnJ29rUg_X0jgf0R8AE
scenes-app-ai-observability-trace-view-trace-view--narrow-with-search--dark:
- hash: v1.k794b7964.252600a05962ea926448b04eb9fc4b1a432c531fd88f3254b41b145d88f7ab3d.Ng7Br730lmymLy7a-GEPlmrRiWhuHIhDCpi809MysQw
+ hash: v1.k794b7964.41390e62aaf2ad7fcb58909feb122a930b662e6cd6dd08abf0780862c937b95e.zpRvO4hTWahRHHvihrPtZmINxhXTYdcRyIrKncHGJ60
scenes-app-ai-observability-trace-view-trace-view--narrow-with-search--light:
- hash: v1.k794b7964.2778ab294ce6a667d188f092a9b3915b14dc504086f2b12159040d5e28d29023.9Ck0DKzlj72tvhiq9KvZ2jQbj14Op9fZyPH7bVvA-tk
+ hash: v1.k794b7964.6bbe496e6b6a810842cf73eefed746e9537f0b961371849fee8c82d986d73fea.zYJ3kr6DtmtcbN2S7b0oVJ7eIcghERdiARkesuwdFGM
scenes-app-ai-observability-trace-view-trace-view--sample-anthropic-thinking-tool-use--dark:
hash: v1.k794b7964.ee72ae95c2c0db21361b7924fb3f7db28af93dae0f3773ad4530f847f95fc20c.1m0893IlRbuhUW5V-caBPubusOcO8QdDfOSfYt_iA5k
scenes-app-ai-observability-trace-view-trace-view--sample-anthropic-thinking-tool-use--light:
@@ -10079,17 +10079,17 @@ snapshots:
scenes-app-ai-observability-trace-view-trace-view--sample-open-ai-agents-with-evals--light:
hash: v1.k794b7964.0defbf16466852328781c98a0b1bad727292512e3d6ef94a34ef89a7cc7af7c8.YxnGetMJ8rP0TaFE_BGBDK33bYPoEi7QBgsYACaJnRs
scenes-app-ai-observability-trace-view-trace-view--span-selected--dark:
- hash: v1.k794b7964.5661cb373b0a885e9fcae9aae48e1a2f2e4c1878e978d479eb21c2afa4c56b33.MRr4zuk2ZEYYgCjUapLRG4_yvUduKdK4-jxb3OwL-CM
+ hash: v1.k794b7964.a3df03d876e582a6049edf046de889e17383de51babb5af84cef9235a861cbfc.LU4NX0PZdfIVwOHvOBgHVxKEWy2tkH5uHl4-qeygqk0
scenes-app-ai-observability-trace-view-trace-view--span-selected--light:
- hash: v1.k794b7964.cce518d901220cf3987ffecc01a12863a52ebcfbbc85a7e57c66412269e5ecd4.BDrwhtzMs2xy21QD2YQhRspMwVDx0it-wBv_v8X_BwY
+ hash: v1.k794b7964.86e606688296cd4c4dbf3ad3d1303849b7fe31f5d0e454b0f037db94a55c3fa9.5-YLVQKi0GL0R-Mlh40h6kjL4Bp6OIvZQUE2-nk22nw
scenes-app-ai-observability-trace-view-trace-view--thread-mode--dark:
- hash: v1.k794b7964.a67a33e56d46e1cce8d4e8f8c1acdbce48cb95aef40a3565bf00cec07285df2d.TTwODTDJcqX0WWEM23lHDrYrwt3mc11OczHUbTDGW_o
+ hash: v1.k794b7964.02d016829733cfcade7763c948f82975a850e276a3b65352365a13abd86111e0.ERP9-ylENZoj29DBDyPwB8RwSwqDmrhhHaO9Bj0O8LY
scenes-app-ai-observability-trace-view-trace-view--thread-mode--light:
- hash: v1.k794b7964.7e7b6476eebb5463219b494da41ce168004b0195ff5740ba96331b4c39b2cfc2.8PFv02RIXoQVHtiuL0q-q4dP4F3g7-wIeI02zBMG86I
+ hash: v1.k794b7964.a7d9dcdf63eaf5cb47ab6b25888ebd59457b533d57e6dbf467870aaacedabb6c.HV3Cuftpo17R7Gn7ywwodTV6qhEdcsk2nyOmScZH6ZU
scenes-app-ai-observability-trace-view-trace-view--timeline-mode--dark:
- hash: v1.k794b7964.257916db753723724422e8e079f222b696e115fa68d5af3299ecabad144a6b2b.tHk4yi8qag5eR66lnJKE1IC8sjCTjMNq5qAmCsTfcyY
+ hash: v1.k794b7964.c9fc72811b943c115537e635134b80a91c58a47543524d0965c42602bfdfec27.qyngZZkvl7G39BPx-HjBx7Mu-z-FmDtnmpHBAuRhg4s
scenes-app-ai-observability-trace-view-trace-view--timeline-mode--light:
- hash: v1.k794b7964.d75461acbb67383146529c1f9cac861fb7be369d2c551e445611aadbf8db8e70.ZBRYpdhZNMGd22yuvV8JqVPJYQXKgZz5TLSlM5-VTqQ
+ hash: v1.k794b7964.a2443f5ee729993e26c5842b2f139209fcf1723ec5f5adbdfd324481b6813bbd.Saq9FjUVQPXqDnjkFCABEH-NjvGihIRi1G52alnk6_o
scenes-app-ai-observability-trace-view-trace-view-switch--on-new-view--dark:
hash: v1.k794b7964.705e0647746424a98de2bbf79737ac43b3f60b57ae45b8f0e5d0cb5f01226aad.vSallcE6n-MHVAkWEOsfs2D1X--pp40NBjawl5otiOk
scenes-app-ai-observability-trace-view-trace-view-switch--on-new-view--light:
diff --git a/products/ai_observability/backend/presentation/views.py b/products/ai_observability/backend/presentation/views.py
index 030dfff39ed8..515abb64a252 100644
--- a/products/ai_observability/backend/presentation/views.py
+++ b/products/ai_observability/backend/presentation/views.py
@@ -3,7 +3,7 @@ from datetime import datetime
from functools import partial
from typing import Any
-from django.db import transaction
+from django.db import models, transaction
from django.http import HttpResponseBase
from drf_spectacular.types import OpenApiTypes
@@ -113,6 +113,19 @@ class TraceExportErrorSerializer(serializers.Serializer):
detail = serializers.CharField(help_text="Why the file cannot be downloaded yet.")
+class TraceExportContentPurpose(models.TextChoices):
+ DOWNLOAD = "download", "Download"
+ COPY = "copy", "Copy"
+
+
+class TraceExportContentQuerySerializer(serializers.Serializer):
+ purpose = serializers.ChoiceField(
+ choices=TraceExportContentPurpose.choices,
+ default=TraceExportContentPurpose.DOWNLOAD,
+ help_text="What the file is read for. Only a download is recorded as one.",
+ )
+
+
class TraceViewSet(TeamAndOrgViewSetMixin, viewsets.ViewSet):
scope_object = "llm_analytics"
scope_object_read_actions = [
@@ -451,10 +464,10 @@ class TraceViewSet(TeamAndOrgViewSetMixin, viewsets.ViewSet):
return Response(export.model_dump(mode="json", by_alias=True))
@extend_schema(
- parameters=[TRACE_ID_PARAMETER, EXPORT_ID_PARAMETER],
+ parameters=[TRACE_ID_PARAMETER, EXPORT_ID_PARAMETER, TraceExportContentQuerySerializer],
responses={
(200, "application/json"): OpenApiResponse(response=contracts.TraceExportFile),
- 400: OpenApiResponse(description="The encoded trace id is malformed."),
+ 400: OpenApiResponse(description="The encoded trace id or the purpose is malformed."),
404: EXPORT_NOT_FOUND_RESPONSE,
409: OpenApiResponse(
response=TraceExportErrorSerializer, description="The export is still being written, or failed."
@@ -465,6 +478,8 @@ class TraceViewSet(TeamAndOrgViewSetMixin, viewsets.ViewSet):
@action(detail=True, methods=["GET"], url_path=r"exports/(?P<export_id>\d+)/content")
def export_content(self, request: Request, pk: str, export_id: str, **kwargs: Any) -> HttpResponseBase:
"""Downloads a completed export as a JSON file."""
+ query = TraceExportContentQuerySerializer(data=request.query_params)
+ query.is_valid(raise_exception=True)
try:
export = self._trace_export(request, pk, export_id)
except MalformedTraceIdSegmentError:
@@ -476,6 +491,8 @@ class TraceViewSet(TeamAndOrgViewSetMixin, viewsets.ViewSet):
detail = export.exception or "The export is still being prepared."
return Response({"detail": detail}, status=status.HTTP_409_CONFLICT)
response = get_export_asset_content_response(asset=asset, download=True)
+ if query.validated_data["purpose"] == TraceExportContentPurpose.COPY:
+ return response
transaction.on_commit(
partial(
report_user_action,
diff --git a/products/ai_observability/backend/tests/test_trace_views.py b/products/ai_observability/backend/tests/test_trace_views.py
index 68d6df2afda0..8aacc3f14cb9 100644
--- a/products/ai_observability/backend/tests/test_trace_views.py
+++ b/products/ai_observability/backend/tests/test_trace_views.py
@@ -804,17 +804,27 @@ class TestTraceExportViews(APIBaseTest):
assert (export["status"], export["exception"]) == expected
assert (status["status"], status["exception"]) == expected
+ @parameterized.expand([("a download", "", True), ("a copy", "?purpose=copy", False)])
@patch("products.ai_observability.backend.presentation.views.report_user_action")
- def test_tracks_a_download(self, report_user_action: MagicMock) -> None:
+ def test_tracks_only_downloads(self, _name: str, query: str, tracked: bool, report_user_action: MagicMock) -> None:
export_id = self._create()["id"]
ExportedAsset.objects.filter(id=export_id).update(content=b'{"trace":{},"nodes":[]}')
with self.captureOnCommitCallbacks(execute=True):
- self.client.get(self._url(_encode("a/b"), export_id, "content/"))
+ response = self.client.get(self._url(_encode("a/b"), export_id, f"content/{query}"))
- report_user_action.assert_called_once_with(
- self.user, "llma trace export downloaded", {"export_id": export_id}, team=self.team, request=ANY
- )
+ assert (response.status_code, response.content) == (200, b'{"trace":{},"nodes":[]}')
+ if tracked:
+ report_user_action.assert_called_once_with(
+ self.user, "llma trace export downloaded", {"export_id": export_id}, team=self.team, request=ANY
+ )
+ else:
+ report_user_action.assert_not_called()
+
+ def test_rejects_an_unknown_content_purpose(self) -> None:
+ export_id = self._create()["id"]
+
+ assert self.client.get(self._url(_encode("a/b"), export_id, "content/?purpose=print")).status_code == 400
def test_a_failed_export_reports_its_reason(self) -> None:
export_id = self._create()["id"]
diff --git a/products/ai_observability/frontend/generated/api.schemas.ts b/products/ai_observability/frontend/generated/api.schemas.ts
index 3542d725e9c4..29c8a4723172 100644
--- a/products/ai_observability/frontend/generated/api.schemas.ts
+++ b/products/ai_observability/frontend/generated/api.schemas.ts
@@ -5872,6 +5872,25 @@ export type AiObservabilityTracesClustersRetrieveParams = {
created_at: string
}
+export type AiObservabilityTracesExportsContentRetrieveParams = {
+ /**
+ * What the file is read for. Only a download is recorded as one.
+ *
+ * * `download` - Download
+ * * `copy` - Copy
+ * @minLength 1
+ */
+ purpose?: AiObservabilityTracesExportsContentRetrievePurpose
+}
+
+export type AiObservabilityTracesExportsContentRetrievePurpose =
+ (typeof AiObservabilityTracesExportsContentRetrievePurpose)[keyof typeof AiObservabilityTracesExportsContentRetrievePurpose]
+
+export const AiObservabilityTracesExportsContentRetrievePurpose = {
+ Download: 'download',
+ Copy: 'copy',
+} as const
+
export type AiObservabilityTracesFeedbackRetrieveParams = {
/**
* When the trace happened, as carried by links into it. Lets a trace older than the AI events retention load from the shared events table.
diff --git a/products/ai_observability/frontend/generated/api.ts b/products/ai_observability/frontend/generated/api.ts
index ec03e69d9f85..d1a206adbf3f 100644
--- a/products/ai_observability/frontend/generated/api.ts
+++ b/products/ai_observability/frontend/generated/api.ts
@@ -17,6 +17,7 @@ import type {
AiObservabilityOfflineExperimentsScorerSummariesListParams,
AiObservabilityOfflineScorersHistoryListParams,
AiObservabilityTracesClustersRetrieveParams,
+ AiObservabilityTracesExportsContentRetrieveParams,
AiObservabilityTracesFeedbackRetrieveParams,
AiObservabilityTracesNodesRetrieveParams,
AiObservabilityTracesPullRequestRetrieveParams,
@@ -790,8 +791,25 @@ export const aiObservabilityTracesExportsRetrieve = async (
})
}
-export const getAiObservabilityTracesExportsContentRetrieveUrl = (projectId: string, id: string, exportId: number) => {
- return `/api/projects/${projectId}/ai_observability/traces/${id}/exports/${exportId}/content/`
+export const getAiObservabilityTracesExportsContentRetrieveUrl = (
+ projectId: string,
+ id: string,
+ exportId: number,
+ params?: AiObservabilityTracesExportsContentRetrieveParams
+) => {
+ const normalizedParams = new URLSearchParams()
+
+ Object.entries(params || {}).forEach(([key, value]) => {
+ if (value !== undefined) {
+ normalizedParams.append(key, value === null ? 'null' : String(value))
+ }
+ })
+
+ const stringifiedParams = normalizedParams.toString()
+
+ return stringifiedParams.length > 0
+ ? `/api/projects/${projectId}/ai_observability/traces/${id}/exports/${exportId}/content/?${stringifiedParams}`
+ : `/api/projects/${projectId}/ai_observability/traces/${id}/exports/${exportId}/content/`
}
/**
@@ -801,12 +819,16 @@ export const aiObservabilityTracesExportsContentRetrieve = async (
projectId: string,
id: string,
exportId: number,
+ params?: AiObservabilityTracesExportsContentRetrieveParams,
options?: RequestInit
): Promise<TraceExportFileApi> => {
- return apiMutator<TraceExportFileApi>(getAiObservabilityTracesExportsContentRetrieveUrl(projectId, id, exportId), {
- ...options,
- method: 'GET',
- })
+ return apiMutator<TraceExportFileApi>(
+ getAiObservabilityTracesExportsContentRetrieveUrl(projectId, id, exportId, params),
+ {
+ ...options,
+ method: 'GET',
+ }
+ )
}
export const getAiObservabilityTracesFeedbackRetrieveUrl = (
diff --git a/products/ai_observability/frontend/redesign/trace/adapter/TraceViewContainer.tsx b/products/ai_observability/frontend/redesign/trace/adapter/TraceViewContainer.tsx
index ef6b88e99cbd..7a8930af287c 100644
--- a/products/ai_observability/frontend/redesign/trace/adapter/TraceViewContainer.tsx
+++ b/products/ai_observability/frontend/redesign/trace/adapter/TraceViewContainer.tsx
@@ -44,7 +44,7 @@ type ReadyValues = Pick<
| 'feedbackCountByNodeId'
| 'feedbackMode'
| 'selectedStepFeedback'
-> & { traceExportLoading: boolean; backLink: LabeledLink | null }
+> & { traceExportLoading: boolean; traceCopying: boolean; backLink: LabeledLink | null }
interface ReadyActions {
setMode: (mode: TraceMode) => void
@@ -54,6 +54,7 @@ interface ReadyActions {
viewInThread: () => void
prefetchNode: (id: string) => void
exportTrace: () => void
+ copyTrace: () => void
showFailingEvals: () => void
setQuery: (query: string) => void
stepMatch: (direction: MatchDirection) => void
@@ -73,6 +74,7 @@ function toReadyProps(values: ReadyValues, actions: ReadyActions): TraceViewRead
header: {
...values.header,
backLink: values.backLink,
+ copyAction: { loading: values.traceCopying, onCopy: actions.copyTrace },
exportAction: { loading: values.traceExportLoading, onExport: actions.exportTrace },
},
summary: {
@@ -172,8 +174,8 @@ export const TraceViewContainer = memo(function TraceViewContainer({
} = useValues(logic)
const actions = useActions(logic)
const exportLogic = traceExportLogic({ traceId, timestampHint })
- const { traceExportLoading } = useValues(exportLogic)
- const { exportTrace } = useActions(exportLogic)
+ const { traceExportLoading, traceCopying } = useValues(exportLogic)
+ const { exportTrace, copyTrace } = useActions(exportLogic)
const readyProps =
status === 'ready'
@@ -208,9 +210,10 @@ export const TraceViewContainer = memo(function TraceViewContainer({
feedbackMode,
selectedStepFeedback,
traceExportLoading,
+ traceCopying,
backLink,
},
- { ...actions, exportTrace }
+ { ...actions, exportTrace, copyTrace }
)
: null
diff --git a/products/ai_observability/frontend/redesign/trace/components/TraceCopyButton.tsx b/products/ai_observability/frontend/redesign/trace/components/TraceCopyButton.tsx
new file mode 100644
index 000000000000..2550b1c0a401
--- /dev/null
+++ b/products/ai_observability/frontend/redesign/trace/components/TraceCopyButton.tsx
@@ -0,0 +1,23 @@
+import { IconCopy } from '@posthog/icons'
+import { LemonButton } from '@posthog/lemon-ui'
+
+export interface TraceCopyButtonProps {
+ loading: boolean
+ onCopy: () => void
+}
+
+export function TraceCopyButton({ loading, onCopy }: TraceCopyButtonProps): JSX.Element {
+ return (
+ <LemonButton
+ size="small"
+ type="secondary"
+ icon={<IconCopy />}
+ loading={loading}
+ onClick={onCopy}
+ tooltip="Copy this trace as JSON"
+ data-attr="trace-view-copy"
+ >
+ Copy
+ </LemonButton>
+ )
+}
diff --git a/products/ai_observability/frontend/redesign/trace/components/TraceHeader.stories.tsx b/products/ai_observability/frontend/redesign/trace/components/TraceHeader.stories.tsx
index cd5f12d4c001..0072f05c02c9 100644
--- a/products/ai_observability/frontend/redesign/trace/components/TraceHeader.stories.tsx
+++ b/products/ai_observability/frontend/redesign/trace/components/TraceHeader.stories.tsx
@@ -17,12 +17,13 @@ export default meta
type Story = StoryObj<typeof TraceHeader>
const exportAction = { loading: false, onExport: () => {} }
+const copyAction = { loading: false, onCopy: () => {} }
export const Default: Story = {}
export const Errored: Story = { args: { hasError: true } }
-export const WithExport: Story = { args: { exportAction } }
+export const WithExport: Story = { args: { copyAction, exportAction } }
export const ExportInProgress: Story = {
- args: { exportAction: { ...exportAction, loading: true } },
+ args: { copyAction, exportAction: { ...exportAction, loading: true } },
// The busy button's spinner is the state this story shows, so the snapshot must not wait for it to go.
parameters: { testOptions: { waitForLoadersToDisappear: false } },
}
@@ -41,6 +42,6 @@ export const WithSearch: Story = {
},
}
export const Narrow: Story = {
- args: { name: 'a-very-long-trace-name-that-should-truncate-cleanly', exportAction },
+ args: { name: 'a-very-long-trace-name-that-should-truncate-cleanly', copyAction, exportAction },
decorators: [withWidth(360)],
}
diff --git a/products/ai_observability/frontend/redesign/trace/components/TraceHeader.tsx b/products/ai_observability/frontend/redesign/trace/components/TraceHeader.tsx
index b226c8b5f18d..161fe33713e9 100644
--- a/products/ai_observability/frontend/redesign/trace/components/TraceHeader.tsx
+++ b/products/ai_observability/frontend/redesign/trace/components/TraceHeader.tsx
@@ -2,6 +2,7 @@ import { IconArrowLeft } from '@posthog/icons'
import { LemonButton } from '@posthog/lemon-ui'
import { LabeledLink } from '../types'
+import { TraceCopyButton, TraceCopyButtonProps } from './TraceCopyButton'
import { TraceExportButton, TraceExportButtonProps } from './TraceExportButton'
import { TraceSearchBox, TraceSearchBoxProps } from './TraceSearchBox'
import { TraceStatusBadge } from './TraceStatusBadge'
@@ -11,10 +12,18 @@ export interface TraceHeaderProps {
hasError: boolean
backLink: LabeledLink | null
search?: TraceSearchBoxProps | null
+ copyAction?: TraceCopyButtonProps
exportAction?: TraceExportButtonProps
}
-export function TraceHeader({ name, hasError, backLink, search = null, exportAction }: TraceHeaderProps): JSX.Element {
+export function TraceHeader({
+ name,
+ hasError,
+ backLink,
+ search = null,
+ copyAction,
+ exportAction,
+}: TraceHeaderProps): JSX.Element {
return (
<header className="flex flex-wrap items-center gap-2">
{backLink ? (
@@ -31,6 +40,7 @@ export function TraceHeader({ name, hasError, backLink, search = null, exportAct
<TraceStatusBadge hasError={hasError} />
<div className="ml-auto flex min-w-0 flex-wrap items-center gap-2">
{search ? <TraceSearchBox {...search} /> : null}
+ {copyAction ? <TraceCopyButton {...copyAction} /> : null}
{exportAction ? <TraceExportButton {...exportAction} /> : null}
</div>
</header>
diff --git a/products/ai_observability/frontend/redesign/trace/storyFixtures.tsx b/products/ai_observability/frontend/redesign/trace/storyFixtures.tsx
index 207e1d32a791..a29f9b699fa1 100644
--- a/products/ai_observability/frontend/redesign/trace/storyFixtures.tsx
+++ b/products/ai_observability/frontend/redesign/trace/storyFixtures.tsx
@@ -381,6 +381,7 @@ export const FIXTURE_TRACE: SampleTraceFixture = {
name: 'answer-billing-question',
hasError: false,
backLink: { label: 'Back to traces', href: '/traces' },
+ copyAction: { loading: false, onCopy: () => {} },
exportAction: { loading: false, onExport: () => {} },
},
summary: {
diff --git a/products/ai_observability/frontend/redesign/trace/traceExportCopy.ts b/products/ai_observability/frontend/redesign/trace/traceExportCopy.ts
new file mode 100644
index 000000000000..3c2c07425849
--- /dev/null
+++ b/products/ai_observability/frontend/redesign/trace/traceExportCopy.ts
@@ -0,0 +1,154 @@
+import api, { ApiConfig } from 'lib/api'
+
+import {
+ aiObservabilityTracesExportsCreate,
+ aiObservabilityTracesExportsRetrieve,
+ getAiObservabilityTracesExportsContentRetrieveUrl,
+} from '../../generated/api'
+import {
+ AiObservabilityTracesExportsContentRetrievePurpose,
+ ExportStatusEnumApi,
+ type TraceExportApi,
+} from '../../generated/api.schemas'
+import { encodeTraceIdSegment } from './traceIdSegment'
+
+export const COPY_TRACE_MAX_MEGABYTES = 5
+const COPY_TRACE_MAX_BYTES = COPY_TRACE_MAX_MEGABYTES * 1_000_000
+const FIRST_POLL_DELAY_MS = 500
+const MAX_POLL_DELAY_MS = 3000
+const CLIPBOARD_TEXT_TYPE = 'text/plain'
+
+export class TraceExportFailedError extends Error {}
+
+export class TraceTooLargeToCopyError extends Error {
+ constructor(readonly traceExport: TraceExportApi) {
+ super(`The trace is larger than ${COPY_TRACE_MAX_MEGABYTES} MB.`)
+ }
+}
+
+export interface TraceExportText {
+ text: string
+ sizeBytes: number
+}
+
+export interface ReadTraceExportTextParams {
+ traceId: string
+ timestampHint: string | null
+ signal: AbortSignal
+}
+
+function sleep(ms: number, signal: AbortSignal): Promise<void> {
+ return new Promise((resolve, reject) => {
+ const timeout = window.setTimeout(resolve, ms)
+ signal.addEventListener(
+ 'abort',
+ () => {
+ window.clearTimeout(timeout)
+ reject(signal.reason)
+ },
+ { once: true }
+ )
+ })
+}
+
+async function waitForExport(
+ projectId: string,
+ segment: string,
+ traceExport: TraceExportApi,
+ signal: AbortSignal
+): Promise<TraceExportApi> {
+ let delay = FIRST_POLL_DELAY_MS
+ while (traceExport.status === ExportStatusEnumApi.Pending) {
+ await sleep(delay, signal)
+ delay = Math.min(delay * 1.5, MAX_POLL_DELAY_MS)
+ traceExport = await aiObservabilityTracesExportsRetrieve(projectId, segment, traceExport.id, { signal })
+ }
+ return traceExport
+}
+
+async function readCapped(
+ response: Response,
+ traceExport: TraceExportApi,
+ stopReading: () => void
+): Promise<TraceExportText> {
+ if (!response.body) {
+ throw new Error('The export came back empty.')
+ }
+ const reader = response.body.getReader()
+ const chunks: Uint8Array[] = []
+ let sizeBytes = 0
+ for (let chunk = await reader.read(); !chunk.done; chunk = await reader.read()) {
+ sizeBytes += chunk.value.byteLength
+ if (sizeBytes > COPY_TRACE_MAX_BYTES) {
+ // Abort the request rather than cancel the reader: the API client keeps a clone of the response,
+ // and a cancel waits until every clone of the body is cancelled too.
+ stopReading()
+ throw new TraceTooLargeToCopyError(traceExport)
+ }
+ chunks.push(chunk.value)
+ }
+ const decoder = new TextDecoder()
+ const text = chunks.map((chunk) => decoder.decode(chunk, { stream: true })).join('') + decoder.decode()
+ return { text, sizeBytes }
+}
+
+/**
+ * Writes a trace export and reads it back as text, giving up once it passes the copy cap.
+ *
+ * Throws `TraceExportFailedError` when the export fails and `TraceTooLargeToCopyError` past the cap.
+ */
+export async function readTraceExportText({
+ traceId,
+ timestampHint,
+ signal,
+}: ReadTraceExportTextParams): Promise<TraceExportText> {
+ const projectId = String(ApiConfig.getCurrentProjectId())
+ const segment = encodeTraceIdSegment(traceId)
+ const created = await aiObservabilityTracesExportsCreate(
+ projectId,
+ segment,
+ timestampHint ? { timestamp_hint: timestampHint } : {},
+ { signal }
+ )
+ const traceExport = await waitForExport(projectId, segment, created, signal)
+ if (traceExport.status === ExportStatusEnumApi.Failed) {
+ throw new TraceExportFailedError(traceExport.exception ?? "Couldn't export this trace. Try again.")
+ }
+ const read = new AbortController()
+ const stopReading = (): void => read.abort(signal.reason)
+ signal.addEventListener('abort', stopReading, { once: true })
+ try {
+ // nosemgrep: prefer-codegen-api -- an export download; the generated client parses JSON, and the cap needs the raw body stream
+ const response = await api.getResponse(
+ getAiObservabilityTracesExportsContentRetrieveUrl(projectId, segment, traceExport.id, {
+ purpose: AiObservabilityTracesExportsContentRetrievePurpose.Copy,
+ }),
+ { signal: read.signal }
+ )
+ return await readCapped(response, traceExport, () => read.abort())
+ } finally {
+ signal.removeEventListener('abort', stopReading)
+ }
+}
+
+/**
+ * Puts text that is still loading on the clipboard. Resolves to false when the browser refused.
+ *
+ * Call it in the same task as the click: Safari and Firefox only accept a clipboard write that starts
+ * inside the user gesture, so the pending text goes onto the `ClipboardItem` instead of being awaited first.
+ */
+export async function writePendingTextToClipboard(text: Promise<string>): Promise<boolean> {
+ // Chrome accepts only a Blob promise on a ClipboardItem, not a string promise.
+ const blob = text.then((value) => new Blob([value], { type: CLIPBOARD_TEXT_TYPE }))
+ // The caller handles a failed read. Nothing else observes this promise when the browser cannot write it.
+ blob.catch(() => {})
+ if (typeof ClipboardItem === 'undefined' || !navigator.clipboard?.write) {
+ return false
+ }
+ try {
+ await navigator.clipboard.write([new ClipboardItem({ [CLIPBOARD_TEXT_TYPE]: blob })])
+ return true
+ } catch {
+ return false
+ }
+}
diff --git a/products/ai_observability/frontend/redesign/trace/traceExportLogic.test.ts b/products/ai_observability/frontend/redesign/trace/traceExportLogic.test.ts
index 4dcd25ddc46f..32b9d47740ad 100644
--- a/products/ai_observability/frontend/redesign/trace/traceExportLogic.test.ts
+++ b/products/ai_observability/frontend/redesign/trace/traceExportLogic.test.ts
@@ -1,4 +1,5 @@
import { expectLogic } from 'kea-test-utils'
+import posthog from 'posthog-js'
import { exportsLogic } from 'lib/components/ExportButton/exportsLogic'
import { lemonToast } from 'lib/lemon-ui/LemonToast/LemonToast'
@@ -14,6 +15,14 @@ import { traceViewLogic } from './traceViewLogic'
const TRACE_URL = '/api/projects/:team_id/ai_observability/traces/:id/'
const EXPORT_URL = '/api/projects/:team_id/ai_observability/traces/:id/exports/'
const EXPORT_STATUS_URL = '/api/projects/:team_id/ai_observability/traces/:id/exports/:export_id/'
+const EXPORT_CONTENT_URL = '/api/projects/:team_id/ai_observability/traces/:id/exports/:export_id/content/'
+const EXPORT_FILE = { trace: { id: 'trace-1' }, truncated: false, nodes: [] }
+const EXPORT_FILE_TEXT = JSON.stringify(EXPORT_FILE)
+const OVERSIZED_FILE = { padding: 'x'.repeat(5_000_000) }
+
+class FakeClipboardItem {
+ constructor(readonly items: Record<string, Promise<Blob>>) {}
+}
function makeTraceExport(overrides: Partial<TraceExportApi> = {}): TraceExportApi {
return {
@@ -32,11 +41,23 @@ describe('traceExportLogic', () => {
let createdExport: TraceExportApi = makeTraceExport()
let exportBodies: unknown[] = []
let statusRequests = 0
+ let exportFile: object = EXPORT_FILE
+ let contentPurposes: (string | null)[] = []
+ let clipboardText: string | null = null
+ const clipboardWrite = jest.fn(async ([item]: FakeClipboardItem[]): Promise<void> => {
+ clipboardText = await (await item.items['text/plain']).text()
+ })
beforeEach(() => {
createdExport = makeTraceExport()
exportBodies = []
statusRequests = 0
+ exportFile = EXPORT_FILE
+ contentPurposes = []
+ clipboardText = null
+ clipboardWrite.mockClear()
+ Object.defineProperty(globalThis, 'ClipboardItem', { value: FakeClipboardItem, configurable: true })
+ Object.defineProperty(navigator, 'clipboard', { value: { write: clipboardWrite }, configurable: true })
useMocks({
get: {
[TRACE_URL]: () => [200, makeTraceResource()],
@@ -45,6 +66,10 @@ describe('traceExportLogic', () => {
statusRequests += 1
return [200, makeTraceExport({ status: 'complete' })]
},
+ [EXPORT_CONTENT_URL]: ({ request }) => {
+ contentPurposes.push(new URL(request.url).searchParams.get('purpose'))
+ return [200, exportFile]
+ },
},
post: {
[EXPORT_URL]: async ({ request }) => {
@@ -56,6 +81,7 @@ describe('traceExportLogic', () => {
initKeaTests()
jest.spyOn(lemonToast, 'info').mockImplementation(() => 'toast')
jest.spyOn(lemonToast, 'error').mockImplementation(() => 'toast')
+ jest.spyOn(posthog, 'capture')
})
afterEach(() => {
@@ -113,4 +139,120 @@ describe('traceExportLogic', () => {
expect(lemonToast.error).toHaveBeenCalledWith('The export could not be started. Try again.')
})
+
+ async function mountForCopy(): Promise<ReturnType<typeof traceExportLogic.build>> {
+ exportsLogic.mount()
+ await expectLogic(traceViewLogic(props), () => {
+ traceViewLogic(props).mount()
+ }).toFinishAllListeners()
+ const logic = traceExportLogic(props)
+ logic.mount()
+ return logic
+ }
+
+ // Safari and Firefox drop a clipboard write that starts after an await, so it has to begin in the click itself.
+ // Hiding the page mid-copy pauses disposables by default, which would abort the read.
+ test('copyTrace starts the clipboard write in the click and fills it with the exported file, even if the tab is hidden', async () => {
+ const logic = await mountForCopy()
+
+ logic.actions.copyTrace()
+ expect(clipboardWrite).toHaveBeenCalledTimes(1)
+ expect(logic.values.traceCopying).toBe(true)
+ Object.defineProperty(document, 'hidden', { value: true, configurable: true })
+ try {
+ document.dispatchEvent(new Event('visibilitychange'))
+ await expectLogic(logic).toDispatchActions(['copyTraceFinished'])
+ } finally {
+ Object.defineProperty(document, 'hidden', { value: false, configurable: true })
+ }
+
+ expect(clipboardText).toEqual(EXPORT_FILE_TEXT)
+ expect(statusRequests).toBe(1)
+ expect(contentPurposes).toEqual(['copy'])
+ expect(logic.values.traceCopying).toBe(false)
+ expect(posthog.capture).toHaveBeenCalledWith('llma trace export copied', {
+ size_bytes: EXPORT_FILE_TEXT.length,
+ fallback: false,
+ })
+ })
+
+ test.each([
+ {
+ name: 'a refused clipboard write offers a copy button',
+ setup: (): void => {
+ createdExport = makeTraceExport({ status: 'complete' })
+ clipboardWrite.mockRejectedValueOnce(new Error('NotAllowedError'))
+ },
+ toast: 'info' as const,
+ message: 'The trace is ready to copy.',
+ button: 'Copy',
+ event: null,
+ },
+ {
+ name: 'an oversized trace offers to download the same export',
+ setup: (): void => {
+ createdExport = makeTraceExport({ status: 'complete' })
+ exportFile = OVERSIZED_FILE
+ },
+ toast: 'info' as const,
+ message: "This trace is larger than 5 MB, so it can't be copied. Download it as a JSON file instead.",
+ button: 'Download',
+ event: 'too_large',
+ },
+ {
+ name: 'a failed export shows its reason',
+ setup: (): void => {
+ createdExport = makeTraceExport({ status: 'failed', exception: 'This trace is no longer available.' })
+ },
+ toast: 'error' as const,
+ message: 'This trace is no longer available.',
+ button: undefined,
+ event: 'export_failed',
+ },
+ ])('$name', async ({ setup, toast, message, button, event }) => {
+ setup()
+ const logic = await mountForCopy()
+
+ await expectLogic(logic, () => logic.actions.copyTrace()).toDispatchActions(['copyTraceFinished'])
+
+ expect(lemonToast[toast]).toHaveBeenCalledWith(message, ...(button ? [expect.anything()] : []))
+ const options = jest.mocked(lemonToast[toast]).mock.calls[0][1] as { button?: { label: string } } | undefined
+ expect(options?.button?.label).toEqual(button)
+ expect(posthog.capture).not.toHaveBeenCalledWith('llma trace export copied', expect.anything())
+ if (event) {
+ expect(posthog.capture).toHaveBeenCalledWith('llma trace export copy failed', { reason: event })
+ }
+ })
+
+ test('the download button on the oversized toast downloads the export the copy wrote', async () => {
+ createdExport = makeTraceExport({ status: 'complete' })
+ exportFile = OVERSIZED_FILE
+ const logic = await mountForCopy()
+ await expectLogic(logic, () => logic.actions.copyTrace()).toDispatchActions(['copyTraceFinished'])
+ const options = jest.mocked(lemonToast.info).mock.calls[0][1] as { button: { action: () => void } }
+
+ await expectLogic(exportsLogic, () => options.button.action()).toDispatchActions([
+ exportsLogic.actionCreators.downloadExport(toExportedAsset(createdExport)),
+ ])
+ })
+
+ test('a browser without clipboard writes shows a failed export without an unhandled rejection', async () => {
+ Object.defineProperty(globalThis, 'ClipboardItem', { value: undefined, configurable: true })
+ createdExport = makeTraceExport({ status: 'failed', exception: 'This trace is no longer available.' })
+ const unhandled: unknown[] = []
+ const recordUnhandled = (reason: unknown): void => {
+ unhandled.push(reason)
+ }
+ process.on('unhandledRejection', recordUnhandled)
+ try {
+ const logic = await mountForCopy()
+ await expectLogic(logic, () => logic.actions.copyTrace()).toDispatchActions(['copyTraceFinished'])
+ await new Promise((resolve) => setTimeout(resolve, 0))
+ } finally {
+ process.off('unhandledRejection', recordUnhandled)
+ }
+
+ expect(lemonToast.error).toHaveBeenCalledWith('This trace is no longer available.')
+ expect(unhandled).toEqual([])
+ })
})
diff --git a/products/ai_observability/frontend/redesign/trace/traceExportLogic.ts b/products/ai_observability/frontend/redesign/trace/traceExportLogic.ts
index 820f0307ab76..85be0573e216 100644
--- a/products/ai_observability/frontend/redesign/trace/traceExportLogic.ts
+++ b/products/ai_observability/frontend/redesign/trace/traceExportLogic.ts
@@ -1,17 +1,32 @@
-import { MakeLogicType, connect, kea, key, listeners, path, props } from 'kea'
+import { MakeLogicType, actions, connect, kea, key, listeners, path, props, reducers } from 'kea'
import { loaders } from 'kea-loaders'
+import posthog from 'posthog-js'
import { ApiConfig } from 'lib/api'
import { exportsLogic } from 'lib/components/ExportButton/exportsLogic'
import { lemonToast } from 'lib/lemon-ui/LemonToast/LemonToast'
+import { copyToClipboard } from 'lib/utils/copyToClipboard'
import { ExportedAssetType, ExporterFormat } from '~/types'
import { aiObservabilityTracesExportsCreate, aiObservabilityTracesExportsRetrieve } from '../../generated/api'
import { ExportStatusEnumApi, type TraceExportApi } from '../../generated/api.schemas'
+import {
+ COPY_TRACE_MAX_MEGABYTES,
+ TraceExportFailedError,
+ TraceTooLargeToCopyError,
+ readTraceExportText,
+ writePendingTextToClipboard,
+} from './traceExportCopy'
import { encodeTraceIdSegment } from './traceIdSegment'
import { traceViewLogic } from './traceViewLogic'
+type CopyFailureReason = 'too_large' | 'export_failed' | 'error'
+
+function trackCopyFailure(reason: CopyFailureReason): void {
+ posthog.capture('llma trace export copy failed', { reason })
+}
+
export interface TraceExportLogicProps {
traceId: string
timestampHint: string | null
@@ -32,12 +47,16 @@ export function toExportedAsset(traceExport: TraceExportApi): ExportedAssetType
// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
export interface traceExportLogicValues {
createdAt: string | null // traceViewLogic
+ traceCopying: boolean
traceExport: TraceExportApi | null
traceExportLoading: boolean
}
// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
export interface traceExportLogicActions {
+ downloadExport: (exportedAsset: ExportedAssetType) => {
+ exportedAsset: ExportedAssetType
+ } // exportsLogic
trackExport: (
exportedAsset: ExportedAssetType,
fetchLatest?: import('lib/components/ExportButton/exportsLogic').ExportStatusFetcher | undefined
@@ -45,6 +64,12 @@ export interface traceExportLogicActions {
exportedAsset: ExportedAssetType
fetchLatest: import('lib/components/ExportButton/exportsLogic').ExportStatusFetcher | undefined
} // exportsLogic
+ copyTrace: () => {
+ value: true
+ }
+ copyTraceFinished: () => {
+ value: true
+ }
exportTrace: () => any
exportTraceFailure: (
error: string,
@@ -80,8 +105,12 @@ export const traceExportLogic = kea<traceExportLogicType>([
path((key) => ['products', 'ai_observability', 'frontend', 'redesign', 'trace', 'traceExportLogic', key]),
connect((props: TraceExportLogicProps) => ({
values: [traceViewLogic(props), ['createdAt']],
- actions: [exportsLogic, ['trackExport']],
+ actions: [exportsLogic, ['trackExport', 'downloadExport']],
})),
+ actions({
+ copyTrace: true,
+ copyTraceFinished: true,
+ }),
loaders(({ props, values }) => ({
traceExport: [
null as TraceExportApi | null,
@@ -95,7 +124,69 @@ export const traceExportLogic = kea<traceExportLogicType>([
},
],
})),
- listeners(({ actions, props }) => ({
+ reducers({
+ traceCopying: [
+ false,
+ {
+ copyTrace: () => true,
+ copyTraceFinished: () => false,
+ },
+ ],
+ }),
+ listeners(({ actions, props, values, cache }) => ({
+ copyTrace: async () => {
+ const controller = new AbortController()
+ // The copy keeps running while the tab is hidden, so that switching tabs does not abort it.
+ cache.disposables.add(() => () => controller.abort(), 'traceCopy', { pauseOnPageHidden: false })
+ const reading = readTraceExportText({
+ traceId: props.traceId,
+ timestampHint: values.createdAt,
+ signal: controller.signal,
+ })
+ const written = writePendingTextToClipboard(reading.then(({ text }) => text))
+ try {
+ const [copied, { text, sizeBytes }] = await Promise.all([written, reading])
+ if (copied) {
+ lemonToast.info('Copied trace to clipboard')
+ posthog.capture('llma trace export copied', { size_bytes: sizeBytes, fallback: false })
+ } else {
+ lemonToast.info('The trace is ready to copy.', {
+ button: {
+ label: 'Copy',
+ action: async () => {
+ if (await copyToClipboard(text, 'trace')) {
+ posthog.capture('llma trace export copied', {
+ size_bytes: sizeBytes,
+ fallback: true,
+ })
+ }
+ },
+ },
+ })
+ }
+ } catch (error) {
+ if (controller.signal.aborted) {
+ return
+ }
+ if (error instanceof TraceTooLargeToCopyError) {
+ const exportedAsset = toExportedAsset(error.traceExport)
+ lemonToast.info(
+ `This trace is larger than ${COPY_TRACE_MAX_MEGABYTES} MB, so it can't be copied. Download it as a JSON file instead.`,
+ { button: { label: 'Download', action: () => actions.downloadExport(exportedAsset) } }
+ )
+ trackCopyFailure('too_large')
+ } else if (error instanceof TraceExportFailedError) {
+ lemonToast.error(error.message)
+ trackCopyFailure('export_failed')
+ } else {
+ lemonToast.error("Couldn't copy this trace. Try again.")
+ trackCopyFailure('error')
+ posthog.captureException(error)
+ }
+ }
+ cache.disposables.dispose('traceCopy')
+ actions.copyTraceFinished()
+ },
exportTraceSuccess: ({ traceExport }) => {
if (traceExport.status === ExportStatusEnumApi.Failed) {
lemonToast.error(traceExport.exception ?? "Couldn't export this trace. Try again.")
diff --git a/services/mcp/src/api/generated.ts b/services/mcp/src/api/generated.ts
index 0f3a66401d14..db6eda21e421 100644
--- a/services/mcp/src/api/generated.ts
+++ b/services/mcp/src/api/generated.ts
@@ -120465,6 +120465,25 @@ export namespace Schemas {
created_at: string;
};
+ export type AiObservabilityTracesExportsContentRetrieveParams = {
+ /**
+ * What the file is read for. Only a download is recorded as one.
+ *
+ * * `download` - Download
+ * * `copy` - Copy
+ * @minLength 1
+ */
+ purpose?: AiObservabilityTracesExportsContentRetrievePurpose;
+ };
+
+ export type AiObservabilityTracesExportsContentRetrievePurpose = typeof AiObservabilityTracesExportsContentRetrievePurpose[keyof typeof AiObservabilityTracesExportsContentRetrievePurpose];
+
+
+ export const AiObservabilityTracesExportsContentRetrievePurpose = {
+ Download: 'download',
+ Copy: 'copy',
+ } as const;
+
export type AiObservabilityTracesFeedbackRetrieveParams = {
/**
* When the trace happened, as carried by links into it. Lets a trace older than the AI events retention load from the shared events table.