Skip to content

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

feat(web): persistent trace summary strip with tags (#17536)

Trang Nguyen4630fd97fb94
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 e601d3c7dd..501499b991 100644
--- a/web/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/ObservationDetailViewHeader.tsx
+++ b/web/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/ObservationDetailViewHeader.tsx
@@ -40,10 +40,6 @@ import {
VersionBadge,
} from "@/src/features/traces/components/ObservationMetadataBadgesSimple/ObservationMetadataBadgesSimple";
import { ObservationLevelBadge } from "@/src/features/traces/components/ObservationLevelBadge";
-import {
- SessionBadge,
- UserIdBadge,
-} from "@/src/features/traces/components/TraceMetadataBadges";
import { EvaluatorBadge } from "@/src/features/traces/components/ObservationDetailView/components/ObservationDetailViewHeader/components/EvaluatorBadge/EvaluatorBadge";
import {
CostBadge,
@@ -739,18 +735,6 @@ export const ObservationDetailViewHeader = memo(
<TimeToFirstTokenBadge
timeToFirstToken={observation.timeToFirstToken}
/>
- {observation.sessionId && (
- <SessionBadge
- sessionId={observation.sessionId}
- projectId={projectId}
- />
- )}
- {observation.userId && (
- <UserIdBadge
- userId={observation.userId}
- projectId={projectId}
- />
- )}
{evaluatorId &&
(observation.environment ===
LangfuseInternalTraceEnvironment.LLMJudge ||
diff --git a/web/src/features/traces/components/Trace.tsx b/web/src/features/traces/components/Trace.tsx
index 5aedf0c2f7..615520d463 100644
--- a/web/src/features/traces/components/Trace.tsx
+++ b/web/src/features/traces/components/Trace.tsx
@@ -20,6 +20,7 @@ import {
} from "@/src/features/traces/contexts/TraceGraphDataContext";
import { TraceLayoutMobile } from "@/src/features/traces/components/TraceLayoutMobile";
import { TraceLayoutDesktop } from "@/src/features/traces/components/TraceLayoutDesktop";
+import { TraceSummaryStrip } from "@/src/features/traces/components/TraceSummaryStrip";
import { TracePanelNavigation } from "@/src/features/traces/components/TracePanelNavigation";
import { TracePanelDetail } from "@/src/features/traces/components/TracePanelDetail";
import { TracePanelNavigationLayoutDesktop } from "@/src/features/traces/components/TracePanelNavigationLayoutDesktop/TracePanelNavigationLayoutDesktop";
@@ -196,11 +197,11 @@ function TraceWithSelection({
*/
function TraceContent({ desktopLayout }: { desktopLayout: DesktopLayout }) {
const isMobile = useIsMobile();
- const { showGraph } = useViewPreferences();
+ const { showGraph, isAnnotationMode } = useViewPreferences();
const { isGraphViewAvailable } = useTraceGraphData();
const shouldShowGraph = showGraph && isGraphViewAvailable;
- return isMobile ? (
+ const panels = isMobile ? (
<MobileTraceContent shouldShowGraph={shouldShowGraph} />
) : (
<DesktopTraceContent
@@ -208,6 +209,18 @@ function TraceContent({ desktopLayout }: { desktopLayout: DesktopLayout }) {
desktopLayout={desktopLayout}
/>
);
+
+ // Annotation mode shows no trace-level metadata.
+ if (isAnnotationMode) {
+ return panels;
+ }
+
+ return (
+ <div className="flex h-full flex-col overflow-hidden">
+ <TraceSummaryStrip />
+ <div className="min-h-0 flex-1">{panels}</div>
+ </div>
+ );
}
/**
diff --git a/web/src/features/traces/components/TraceDetailView/TraceDetailView.tsx b/web/src/features/traces/components/TraceDetailView/TraceDetailView.tsx
index d7e4acca7e..7b8e722aa4 100644
--- a/web/src/features/traces/components/TraceDetailView/TraceDetailView.tsx
+++ b/web/src/features/traces/components/TraceDetailView/TraceDetailView.tsx
@@ -249,7 +249,6 @@ export function TraceDetailView({
{/* Header section (extracted component) */}
<TraceDetailViewHeader
trace={trace}
- observations={observations}
parsedMetadata={parsedMetadata}
projectId={projectId}
traceScores={traceScores}
diff --git a/web/src/features/traces/components/TraceDetailView/components/TraceDetailViewHeader.tsx b/web/src/features/traces/components/TraceDetailView/components/TraceDetailViewHeader.tsx
index eb32df336b..0c9ebdb641 100644
--- a/web/src/features/traces/components/TraceDetailView/components/TraceDetailViewHeader.tsx
+++ b/web/src/features/traces/components/TraceDetailView/components/TraceDetailViewHeader.tsx
@@ -4,12 +4,12 @@
* Contains:
* - Title row with ItemBadge, trace name, options menu
* - Action buttons (Dataset, Annotate, Queue, Comments)
- * - Metadata badges (timestamp, latency, session, user, environment, release, version, cost, usage)
+ * - Metadata badges (timestamp, environment, release, version, target trace)
*
* Memoized to prevent unnecessary re-renders when tab state changes.
*/
-import { memo, useMemo } from "react";
+import { memo } from "react";
import {
type TraceDomain,
type ScoreDomain,
@@ -17,7 +17,6 @@ import {
LangfuseInternalTraceEnvironment,
} from "@langfuse/shared";
import { type WithStringifiedMetadata } from "@/src/utils/clientSideDomainTypes";
-import { type ObservationReturnTypeWithMetadata } from "@/src/server/api/routers/traces";
import { ItemBadge } from "@/src/components/ItemBadge";
import { DetailHeaderActionsMenuController } from "@/src/features/traces/components/DetailHeaderActionsMenuController";
import {
@@ -30,16 +29,11 @@ import { ActionButtonCountBadge } from "@/src/components/ui/action-button-count-
import { AnnotationQueueItemDropdownMenuController } from "@/src/features/annotation-queues/components/AnnotationQueueItemDropdownMenuController";
import { AnnotationQueueItemCountBadge } from "@/src/features/annotation-queues/components/AnnotationQueueItemCountBadge";
import {
- SessionBadge,
- UserIdBadge,
EnvironmentBadge,
ReleaseBadge,
VersionBadge,
TargetTraceBadge,
} from "../../TraceMetadataBadges";
-import { LatencyBadge } from "../../ObservationMetadataBadgesSimple/ObservationMetadataBadgesSimple";
-import { CostBadge, UsageBadge } from "../../ObservationMetadataBadgesTooltip";
-import { aggregateTraceMetrics } from "@/src/features/traces/fns/traceAggregation";
import { resolveEvalExecutionMetadata } from "@/src/features/traces/fns/resolveMetadata";
import { useViewPreferences } from "@/src/features/traces/contexts/ViewPreferencesContext";
import { CollapsibleBadgeRow } from "@/src/features/traces/components/CollapsibleBadgeRow";
@@ -70,7 +64,6 @@ export interface TraceDetailViewHeaderProps {
input: string | null;
output: string | null;
};
- observations: ObservationReturnTypeWithMetadata[];
parsedMetadata: unknown;
projectId: string;
traceScores: WithStringifiedMetadata<ScoreDomain>[];
@@ -83,7 +76,6 @@ export interface TraceDetailViewHeaderProps {
export const TraceDetailViewHeader = memo(function TraceDetailViewHeader({
trace,
- observations,
parsedMetadata,
projectId,
traceScores,
@@ -92,10 +84,6 @@ export const TraceDetailViewHeader = memo(function TraceDetailViewHeader({
}: TraceDetailViewHeaderProps) {
const { isAnnotationMode } = useViewPreferences();
const isMobile = useIsMobile();
- const aggregatedMetrics = useMemo(
- () => aggregateTraceMetrics(observations),
- [observations],
- );
const {
existingDatasetItems,
hasAccess: hasDatasetAccess,
@@ -486,13 +474,6 @@ export const TraceDetailViewHeader = memo(function TraceDetailViewHeader({
{/* Other badges */}
{!isAnnotationMode && (
<CollapsibleBadgeRow>
- <LatencyBadge latencySeconds={trace.latency ?? null} />
- {trace.sessionId && (
- <SessionBadge sessionId={trace.sessionId} projectId={projectId} />
- )}
- {trace.userId && (
- <UserIdBadge userId={trace.userId} projectId={projectId} />
- )}
{targetTraceId && (
<TargetTraceBadge
targetTraceId={targetTraceId}
@@ -504,22 +485,6 @@ export const TraceDetailViewHeader = memo(function TraceDetailViewHeader({
)}
{trace.release && <ReleaseBadge release={trace.release} />}
{trace.version && <VersionBadge version={trace.version} />}
- {aggregatedMetrics.totalCost != null &&
- aggregatedMetrics.costDetails && (
- <CostBadge
- totalCost={aggregatedMetrics.totalCost}
- costDetails={aggregatedMetrics.costDetails}
- />
- )}
- {aggregatedMetrics.hasGenerationLike &&
- aggregatedMetrics.usageDetails && (
- <UsageBadge
- inputUsage={aggregatedMetrics.inputUsage}
- outputUsage={aggregatedMetrics.outputUsage}
- totalUsage={aggregatedMetrics.totalUsage}
- usageDetails={aggregatedMetrics.usageDetails}
- />
- )}
</CollapsibleBadgeRow>
)}
</div>
diff --git a/web/src/features/traces/components/TraceSummaryStrip.tsx b/web/src/features/traces/components/TraceSummaryStrip.tsx
new file mode 100644
index 0000000000..cbac36e000
--- /dev/null
+++ b/web/src/features/traces/components/TraceSummaryStrip.tsx
@@ -0,0 +1,96 @@
+/** Trace totals, session/user links and tags, above the panels. */
+
+import { useMemo, useState } from "react";
+
+import { Button } from "@/src/components/ui/button";
+import { TagButton } from "@/src/features/tag/components/TagButton";
+import {
+ SessionBadge,
+ UserIdBadge,
+} from "@/src/features/traces/components/TraceMetadataBadges";
+import { LatencyBadge } from "@/src/features/traces/components/ObservationMetadataBadgesSimple/ObservationMetadataBadgesSimple";
+import {
+ CostBadge,
+ UsageBadge,
+} from "@/src/features/traces/components/ObservationMetadataBadgesTooltip";
+import { useTraceData } from "@/src/features/traces/contexts/TraceDataContext";
+import { aggregateTraceMetrics } from "@/src/features/traces/fns/traceAggregation";
+
+const MAX_VISIBLE_TAGS = 3;
+
+export function TraceSummaryStrip() {
+ const { trace, observations } = useTraceData();
+ const [showAllTags, setShowAllTags] = useState(false);
+
+ const aggregatedMetrics = useMemo(
+ () => aggregateTraceMetrics(observations),
+ [observations],
+ );
+
+ const visibleTags = showAllTags
+ ? trace.tags
+ : trace.tags.slice(0, MAX_VISIBLE_TAGS);
+ const hiddenTagCount = trace.tags.length - visibleTags.length;
+
+ return (
+ <div className="shrink-0 border-b px-3 py-2">
+ <div className="flex flex-wrap items-center gap-1">
+ <LatencyBadge latencySeconds={trace.latency ?? null} />
+ {aggregatedMetrics.totalCost != null &&
+ aggregatedMetrics.costDetails && (
+ <CostBadge
+ totalCost={aggregatedMetrics.totalCost}
+ costDetails={aggregatedMetrics.costDetails}
+ />
+ )}
+ {aggregatedMetrics.hasGenerationLike &&
+ aggregatedMetrics.usageDetails && (
+ <UsageBadge
+ inputUsage={aggregatedMetrics.inputUsage}
+ outputUsage={aggregatedMetrics.outputUsage}
+ totalUsage={aggregatedMetrics.totalUsage}
+ usageDetails={aggregatedMetrics.usageDetails}
+ />
+ )}
+ {trace.sessionId && (
+ <SessionBadge
+ sessionId={trace.sessionId}
+ projectId={trace.projectId}
+ />
+ )}
+ {trace.userId && (
+ <UserIdBadge userId={trace.userId} projectId={trace.projectId} />
+ )}
+ {trace.tags.length > 0 && (
+ <div className="flex min-w-0 items-center gap-1">
+ {visibleTags.map((tag) => (
+ <TagButton key={tag} tag={tag} loading={false} viewOnly />
+ ))}
+ {hiddenTagCount > 0 && (
+ <Button
+ variant="tertiary"
+ size="icon-sm"
+ className="w-fit"
+ aria-label={`Show ${hiddenTagCount} more tags`}
+ onClick={() => setShowAllTags(true)}
+ >
+ +{hiddenTagCount}
+ </Button>
+ )}
+ {showAllTags && trace.tags.length > MAX_VISIBLE_TAGS && (
+ <Button
+ variant="tertiary"
+ size="icon-sm"
+ className="w-fit"
+ aria-label="Show fewer tags"
+ onClick={() => setShowAllTags(false)}
+ >
+ Show fewer
+ </Button>
+ )}
+ </div>
+ )}
+ </div>
+ </div>
+ );
+}
diff --git a/web/src/features/traces/contexts/TraceDataContext.tsx b/web/src/features/traces/contexts/TraceDataContext.tsx
index 29aa8c36bf..f47c392ec9 100644
--- a/web/src/features/traces/contexts/TraceDataContext.tsx
+++ b/web/src/features/traces/contexts/TraceDataContext.tsx
@@ -41,6 +41,8 @@ type TraceType = Omit<
> & {
input: string | null;
output: string | null;
+ /** Server-derived, in seconds. */
+ latency?: number;
};
interface TraceDataContextValue {