Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

chore(single-trace): show CH cloud query in ui (#17370)

Nimar48f3f5558720
diff --git a/web/src/features/sessions/ModernSessionHeaderActionsController.clienttest.tsx b/web/src/features/sessions/ModernSessionHeaderActionsController.clienttest.tsx
index 1ad8e5cde2..adcec57826 100644
--- a/web/src/features/sessions/ModernSessionHeaderActionsController.clienttest.tsx
+++ b/web/src/features/sessions/ModernSessionHeaderActionsController.clienttest.tsx
@@ -5,6 +5,13 @@ import { vi } from "vitest";
import { ModernSessionHeaderActionsController } from "@/src/features/sessions/ModernSessionHeaderActionsController";
import { DropdownMenuTrigger } from "@/src/components/ui/dropdown-menu";
+const { mockUseSession, copy } = vi.hoisted(() => ({
+ mockUseSession: vi.fn(),
+ copy: vi.fn(),
+}));
+
+vi.mock("next-auth/react", () => ({ useSession: mockUseSession }));
+
vi.mock("@/src/components/ui/dropdown-menu", () => ({
DropdownMenu: ({ children }: { children: ReactNode }) => <>{children}</>,
DropdownMenuTrigger: ({ children }: { children: ReactNode }) => (
@@ -63,7 +70,7 @@ vi.mock("@/src/features/rbac/utils/checkProjectAccess", () => ({
}));
vi.mock("@/src/hooks/useCopyToClipboard", () => ({
- useCopyToClipboard: () => ({ copy: vi.fn() }),
+ useCopyToClipboard: () => ({ copy }),
}));
vi.mock("@/src/utils/api", () => ({
@@ -78,6 +85,78 @@ vi.mock("@/src/utils/api", () => ({
}));
describe("ModernSessionHeaderActionsController", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ mockUseSession.mockReturnValue({ data: { user: { admin: false } } });
+ });
+
+ it.each(["events_full", "events_core"])(
+ "copies all session rows from %s with escaped identifiers",
+ (table) => {
+ mockUseSession.mockReturnValue({ data: { user: { admin: true } } });
+ render(
+ <ModernSessionHeaderActionsController
+ projectId={"project'\\id"}
+ sessionId={"session'\\id"}
+ isPublic={false}
+ >
+ <button type="button">Actions</button>
+ </ModernSessionHeaderActionsController>,
+ );
+
+ fireEvent.click(
+ screen.getByRole("button", { name: `Copy ${table} query` }),
+ );
+
+ expect(copy).toHaveBeenCalledExactlyOnceWith(
+ "WITH\n" +
+ " 'project\\'\\\\id' AS target_project_id,\n" +
+ " 'session\\'\\\\id' AS target_session_id\n" +
+ `SELECT *\nFROM ${table}\n` +
+ "WHERE project_id = target_project_id\n" +
+ " AND trace_id IN (\n" +
+ " SELECT trace_id\n" +
+ " FROM events_core\n" +
+ " WHERE project_id = target_project_id\n" +
+ " AND trace_id IN (\n" +
+ " SELECT trace_id\n" +
+ " FROM events_core\n" +
+ " WHERE project_id = target_project_id\n" +
+ " AND session_id = target_session_id\n" +
+ " )\n" +
+ " GROUP BY trace_id\n" +
+ " HAVING argMaxIf(session_id, event_ts, session_id <> '') = target_session_id\n" +
+ " )\n" +
+ "ORDER BY start_time ASC, event_ts DESC;",
+ );
+ },
+ );
+
+ it.each([{ user: { admin: false } }, { user: {} }, null])(
+ "hides query copying without an instance admin (%j)",
+ (data) => {
+ mockUseSession.mockReturnValue({ data });
+ render(
+ <ModernSessionHeaderActionsController
+ projectId="project-id"
+ sessionId="session-id"
+ isPublic={false}
+ >
+ <button type="button">Actions</button>
+ </ModernSessionHeaderActionsController>,
+ );
+
+ expect(
+ screen.queryByRole("button", { name: "Copy events_full query" }),
+ ).not.toBeInTheDocument();
+ expect(
+ screen.queryByRole("button", { name: "Copy events_core query" }),
+ ).not.toBeInTheDocument();
+ fireEvent.click(screen.getByRole("button", { name: "Copy session ID" }));
+ expect(copy).toHaveBeenCalledExactlyOnceWith("session-id");
+ },
+ );
+
it("keeps the timeline display setting reachable from the actions menu", () => {
const onShowSystemPromptChange = vi.fn();
diff --git a/web/src/features/sessions/ModernSessionHeaderActionsController.tsx b/web/src/features/sessions/ModernSessionHeaderActionsController.tsx
index 3e8b260092..8494a066d0 100644
--- a/web/src/features/sessions/ModernSessionHeaderActionsController.tsx
+++ b/web/src/features/sessions/ModernSessionHeaderActionsController.tsx
@@ -1,4 +1,5 @@
import { CopyIcon, Share2 } from "lucide-react";
+import { useSession } from "next-auth/react";
import { type ReactNode } from "react";
import {
@@ -16,6 +17,38 @@ import { useHasProjectAccess } from "@/src/features/rbac/utils/checkProjectAcces
import { useCopyToClipboard } from "@/src/hooks/useCopyToClipboard";
import { api } from "@/src/utils/api";
+function buildSessionClickHouseQuery(
+ table: "events_full" | "events_core",
+ projectId: string,
+ sessionId: string,
+) {
+ const quote = (value: string) =>
+ `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+
+ // Session membership belongs to the trace; child events may have no session_id.
+ // Resolve current membership from core before reading every event in the trace.
+ return `WITH
+ ${quote(projectId)} AS target_project_id,
+ ${quote(sessionId)} AS target_session_id
+SELECT *
+FROM ${table}
+WHERE project_id = target_project_id
+ AND trace_id IN (
+ SELECT trace_id
+ FROM events_core
+ WHERE project_id = target_project_id
+ AND trace_id IN (
+ SELECT trace_id
+ FROM events_core
+ WHERE project_id = target_project_id
+ AND session_id = target_session_id
+ )
+ GROUP BY trace_id
+ HAVING argMaxIf(session_id, event_ts, session_id <> '') = target_session_id
+ )
+ORDER BY start_time ASC, event_ts DESC;`;
+}
+
export function ModernSessionHeaderActionsController({
projectId,
sessionId,
@@ -39,6 +72,7 @@ export function ModernSessionHeaderActionsController({
onShowSystemPromptChange?: (isEnabled: boolean) => void;
children: ReactNode;
}) {
+ const session = useSession();
const capture = usePostHogClientCapture();
const { copy } = useCopyToClipboard();
const utils = api.useUtils();
@@ -81,6 +115,20 @@ export function ModernSessionHeaderActionsController({
<CopyIcon className="mr-2 h-3.5 w-3.5" />
Copy session ID
</DropdownMenuItem>
+ {session.data?.user?.admin === true &&
+ (["events_full", "events_core"] as const).map((table) => (
+ <DropdownMenuItem
+ key={table}
+ onClick={async () => {
+ await copy(
+ buildSessionClickHouseQuery(table, projectId, sessionId),
+ );
+ }}
+ >
+ <CopyIcon className="mr-2 h-3.5 w-3.5" />
+ Copy {table} query
+ </DropdownMenuItem>
+ ))}
{hasDisplaySettings ? (
<>
<DropdownMenuSeparator />
diff --git a/web/src/features/traces/components/DetailHeaderActionsMenuController.tsx b/web/src/features/traces/components/DetailHeaderActionsMenuController.tsx
index 1f1a160a83..3ff34fa7a8 100644
--- a/web/src/features/traces/components/DetailHeaderActionsMenuController.tsx
+++ b/web/src/features/traces/components/DetailHeaderActionsMenuController.tsx
@@ -1,4 +1,5 @@
import { useRouter } from "next/router";
+import { useSession } from "next-auth/react";
import { CheckIcon, CopyIcon } from "lucide-react";
import { useState, type ComponentProps, type ReactNode } from "react";
import {
@@ -26,6 +27,11 @@ type DetailHeaderActionsMenuControllerProps = {
idItems: IdItem[];
observationType?: ObservationType;
projectId: string;
+ observation?: {
+ id: string;
+ traceId: string;
+ startTime: Date;
+ };
spanName?: string;
webCallout?: {
traceId: string | null;
@@ -35,6 +41,32 @@ type DetailHeaderActionsMenuControllerProps = {
children: ComponentProps<typeof DropdownMenuController>["children"];
};
+function buildObservationClickHouseQuery(
+ projectId: string,
+ observation: NonNullable<
+ DetailHeaderActionsMenuControllerProps["observation"]
+ >,
+) {
+ const quote = (value: string) =>
+ `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+ const minute = observation.startTime
+ .toISOString()
+ .slice(0, 16)
+ .replace("T", " ");
+
+ // Match the events_full primary-key prefix, without requiring microsecond
+ // precision from the browser's Date. The query runs in the admin's SQL client.
+ return `SELECT *
+FROM events_full
+WHERE project_id = ${quote(projectId)}
+ AND toStartOfMinute(start_time) = toDateTime('${minute}:00', 'UTC')
+ AND xxHash32(trace_id) = xxHash32(${quote(observation.traceId)})
+ AND trace_id = ${quote(observation.traceId)}
+ AND span_id = ${quote(observation.id)}
+ORDER BY event_ts DESC
+LIMIT 1;`;
+}
+
function WebCalloutActionController({
projectId,
webCallout,
@@ -61,13 +93,20 @@ export function DetailHeaderActionsMenuController({
idItems,
observationType,
projectId,
+ observation,
spanName,
webCallout,
children,
}: DetailHeaderActionsMenuControllerProps) {
const router = useRouter();
+ const session = useSession();
const [copiedId, setCopiedId] = useState<string | null>(null);
+ const clickHouseQuery =
+ session.data?.user?.admin === true && observation
+ ? buildObservationClickHouseQuery(projectId, observation)
+ : null;
+
const handleCopy = (textToCopy: string) => {
copyTextToClipboard(textToCopy);
setCopiedId(textToCopy);
@@ -156,6 +195,19 @@ export function DetailHeaderActionsMenuController({
</span>
</DropdownMenuItem>
))}
+ {clickHouseQuery && (
+ <DropdownMenuItem
+ className="text-xs"
+ onSelect={() => handleCopy(clickHouseQuery)}
+ >
+ {copiedId === clickHouseQuery ? (
+ <CheckIcon className="text-muted-green mr-2 h-4 w-4" />
+ ) : (
+ <CopyIcon className="mr-2 h-4 w-4" />
+ )}
+ Copy ClickHouse query
+ </DropdownMenuItem>
+ )}
</>
)}
>
diff --git a/web/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/ObservationDetailViewHeader.tsx b/web/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/ObservationDetailViewHeader.tsx
index a59123f44e..9cbfd744c8 100644
--- a/web/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/ObservationDetailViewHeader.tsx
+++ b/web/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/ObservationDetailViewHeader.tsx
@@ -236,6 +236,15 @@ export const ObservationDetailViewHeader = memo(
]}
observationType={observation.type}
projectId={projectId}
+ observation={
+ isV4Enabled
+ ? {
+ id: observation.id,
+ traceId,
+ startTime: observation.startTime,
+ }
+ : undefined
+ }
spanName={observation.name ?? ""}
webCallout={{
traceId,