Skip to content

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

refactor(web): thin users pages into features/users (#17269)

Nikita Kabardin89aeba80ce2b
diff --git a/web/src/features/users/UserDetailPage.tsx b/web/src/features/users/UserDetailPage.tsx
new file mode 100644
index 0000000000..54adf179fe
--- /dev/null
+++ b/web/src/features/users/UserDetailPage.tsx
@@ -0,0 +1,240 @@
+import { useRouter } from "next/router";
+import { api } from "@/src/utils/api";
+import {
+ RouteParamsPendingFallback,
+ useReadyRouteParams,
+} from "@/src/hooks/useReadyRouteParams";
+import TracesTable from "@/src/components/table/use-cases/traces";
+import ScoresTable from "@/src/components/table/use-cases/scores";
+import { compactNumberFormatter, usdFormatter } from "@/src/utils/numbers";
+import { StringParam, useQueryParam, withDefault } from "use-query-params";
+import { DetailPageNav } from "@/src/features/navigate-detail-pages/DetailPageNav";
+import SessionsTable from "@/src/components/table/use-cases/sessions";
+import { cn } from "@/src/utils/tailwind";
+import { Badge } from "@/src/components/ui/badge";
+import { ActionButton } from "@/src/components/ActionButton";
+import { LayoutDashboard } from "lucide-react";
+import Page from "@/src/components/layouts/page";
+import { useReadPath } from "@/src/features/events/hooks/useReadPath";
+import { ObservationsEventsTable } from "@/src/features/events/components";
+
+const tabs = ["Traces", "Sessions", "Scores"] as const;
+
+export default function UserDetailPage() {
+ const route = useReadyRouteParams(["projectId", "userId"]);
+ if (!route.ready) return <RouteParamsPendingFallback />;
+ return (
+ <UserDetailView
+ projectId={route.params.projectId}
+ userId={route.params.userId}
+ />
+ );
+}
+
+function UserDetailView({
+ projectId,
+ userId,
+}: {
+ projectId: string;
+ userId: string;
+}) {
+ const router = useRouter();
+ const { isV4 } = useReadPath();
+
+ const userV3 = api.users.byId.useQuery(
+ {
+ projectId: projectId,
+ userId,
+ },
+ { enabled: Boolean(projectId) && Boolean(userId) && !isV4 },
+ );
+
+ const userV4 = api.users.byIdFromEvents.useQuery(
+ {
+ projectId: projectId,
+ userId,
+ },
+ { enabled: Boolean(projectId) && Boolean(userId) && isV4 },
+ );
+
+ const user = isV4 ? userV4 : userV3;
+
+ const [currentTab, setCurrentTab] = useQueryParam(
+ "tab",
+ withDefault(StringParam, tabs[0]),
+ );
+
+ const renderTabContent = () => {
+ switch (currentTab as (typeof tabs)[number]) {
+ case "Sessions":
+ return <SessionsTab userId={userId} projectId={projectId} />;
+ case "Traces":
+ return <TracesTab userId={userId} projectId={projectId} />;
+ case "Scores":
+ return <ScoresTab userId={userId} projectId={projectId} />;
+ default:
+ return null;
+ }
+ };
+
+ const handleTabChange = async (tab: string) => {
+ if (router.query.filter || router.query.orderBy) {
+ const newQuery = { ...router.query };
+ delete newQuery.filter;
+ delete newQuery.orderBy;
+ await router.replace({ query: newQuery });
+ }
+ setCurrentTab(tab);
+ };
+
+ return (
+ <Page
+ headerProps={{
+ title: userId,
+ breadcrumb: [{ name: "Users", href: `/project/${projectId}/users` }],
+ itemType: "USER",
+ actionButtonsRight: (
+ <>
+ <ActionButton
+ href={`/project/${projectId}?filter=user%3Bstring%3B%3B%3D%3B${userId}`} // dashboard filter serialization
+ variant="secondary"
+ icon={<LayoutDashboard className="h-4 w-4" />}
+ >
+ Dashboard
+ </ActionButton>
+ <DetailPageNav
+ currentId={encodeURIComponent(userId)}
+ path={(entry) =>
+ `/project/${projectId}/users/${encodeURIComponent(entry.id)}`
+ }
+ listKey="users"
+ />
+ </>
+ ),
+ }}
+ >
+ <>
+ {user.data && (
+ <div className="flex flex-wrap gap-2 px-4 py-4">
+ <Badge variant="outline">
+ Observations:{" "}
+ {compactNumberFormatter(user.data.totalObservations)}
+ </Badge>
+ <Badge variant="outline">
+ Traces: {compactNumberFormatter(user.data.totalTraces)}
+ </Badge>
+ <Badge variant="outline">
+ Total Tokens: {compactNumberFormatter(user.data.totalTokens)}
+ </Badge>
+ <Badge variant="outline">
+ <span className="flex items-center gap-1">
+ Total Cost: {usdFormatter(user.data.sumCalculatedTotalCost)}
+ </span>
+ </Badge>
+ <Badge variant="outline">
+ Active:{" "}
+ {user.data.firstTrace
+ ? `${user.data.firstTrace.toLocaleString()} - ${user.data.lastTrace?.toLocaleString()}`
+ : isV4
+ ? "No activity yet"
+ : "No traces yet"}
+ </Badge>
+ </div>
+ )}
+
+ <div className="border-border border-t" />
+
+ <div>
+ <div className="sm:hidden">
+ <label htmlFor="tabs" className="sr-only">
+ Select a tab
+ </label>
+ <select
+ id="tabs"
+ name="tabs"
+ className="border-border bg-background text-foreground block w-full rounded-md py-2 pr-10 pl-3 text-base focus:outline-hidden sm:text-sm"
+ defaultValue={currentTab}
+ onChange={(e) => handleTabChange(e.currentTarget.value)}
+ >
+ {tabs.map((tab) => (
+ <option key={tab}>{tab}</option>
+ ))}
+ </select>
+ </div>
+ <div className="hidden sm:block">
+ <div className="border-border border-b">
+ <nav className="-mb-px flex" aria-label="Tabs">
+ {tabs.map((tab) => (
+ <button
+ key={tab}
+ className={cn(
+ tab === currentTab
+ ? "border-primary-accent text-foreground"
+ : "text-muted-foreground hover:border-border hover:text-foreground border-transparent",
+ "border-b-2 px-4 py-3 text-sm font-bold whitespace-nowrap",
+ )}
+ aria-current={tab === currentTab ? "page" : undefined}
+ onClick={() => handleTabChange(tab)}
+ >
+ {tab}
+ </button>
+ ))}
+ </nav>
+ </div>
+ </div>
+ </div>
+ <div className="flex flex-1 overflow-hidden">{renderTabContent()}</div>
+ </>
+ </Page>
+ );
+}
+
+type TabProps = {
+ userId: string;
+ projectId: string;
+};
+
+function ScoresTab({ userId, projectId }: TabProps) {
+ return (
+ <ScoresTable
+ projectId={projectId}
+ userId={userId}
+ hiddenColumns={["userId"]}
+ />
+ );
+}
+
+function TracesTab({ userId, projectId }: TabProps) {
+ const { isV4 } = useReadPath();
+
+ if (isV4) {
+ return (
+ <ObservationsEventsTable
+ projectId={projectId}
+ userId={userId}
+ omittedFilter={["userId"]}
+ />
+ );
+ }
+
+ return (
+ <TracesTable
+ projectId={projectId}
+ userId={userId}
+ omittedFilter={["userId"]}
+ />
+ );
+}
+
+function SessionsTab({ userId, projectId }: TabProps) {
+ const { isV4 } = useReadPath();
+
+ return (
+ <SessionsTable
+ projectId={projectId}
+ userId={userId}
+ omittedFilter={["userIds"]}
+ isV4={isV4}
+ />
+ );
+}
diff --git a/web/src/features/users/UsersPage.tsx b/web/src/features/users/UsersPage.tsx
new file mode 100644
index 0000000000..5f4da767ae
--- /dev/null
+++ b/web/src/features/users/UsersPage.tsx
@@ -0,0 +1,698 @@
+import { useRouter } from "next/router";
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import {
+ NumberParam,
+ StringParam,
+ useQueryParam,
+ useQueryParams,
+ withDefault,
+} from "use-query-params";
+import { DataTableToolbar } from "@/src/components/table/data-table-toolbar";
+import { DataTable } from "@/src/components/table/data-table";
+import {
+ DataTableControls,
+ DataTableControlsProvider,
+} from "@/src/components/table/data-table-controls";
+import { ResizableFilterLayout } from "@/src/components/table/resizable-filter-layout";
+import { createBadgeTableColumn } from "@/src/components/design-system/table/columns/createBadgeTableColumn";
+import { createLinkTableColumn } from "@/src/components/design-system/table/columns/createLinkTableColumn";
+import { createTextTableColumn } from "@/src/components/design-system/table/columns/createTextTableColumn";
+import { type LangfuseColumnDef } from "@/src/components/table/types";
+import { getUsersFilterConfig } from "@/src/features/filters/config/users-config";
+import {
+ USERS_FIELD_REGISTRY,
+ LEGACY_USERS_FIELD_REGISTRY,
+} from "@/src/features/filters/config/usersSearchRegistry";
+import {
+ useSidebarFilterPresentation,
+ useSidebarFilterStateCore,
+ type FacetOptions,
+ type UseSidebarFilterStateOptions,
+} from "@/src/features/filters/hooks/useSidebarFilterState";
+import { buildSidebarFilterSessionContextId } from "@/src/features/filters/lib/persistedSidebarFilterQuery";
+import { sortOptionValues } from "@/src/features/filters";
+import { useDetailPageLists } from "@/src/features/navigate-detail-pages/context";
+import { useEventsFilterOptions } from "@/src/features/events/hooks/useEventsFilterOptions";
+import { useReadPath } from "@/src/features/events/hooks/useReadPath";
+import { TableSearchBar } from "@/src/features/search-bar/components/TableSearchBar";
+import { useTableViewManager } from "@/src/components/table/table-view-presets/hooks/useTableViewManager";
+import { useTableViewFilterChange } from "@/src/components/table/table-view-presets/hooks/useTableViewFilterChange";
+import useColumnOrder from "@/src/features/column-visibility/hooks/useColumnOrder";
+import useColumnVisibility from "@/src/features/column-visibility/hooks/useColumnVisibility";
+import { toObservedOptions } from "@/src/features/search-bar/lib/observed-options";
+import { api } from "@/src/utils/api";
+import { compactNumberFormatter, usdFormatter } from "@/src/utils/numbers";
+import { type RouterOutput } from "@/src/utils/types";
+import {
+ DEFAULT_SIDEBAR_IMPLICIT_ENVIRONMENT_CONFIG,
+ TableViewPresetTableName,
+ type FilterState,
+ type TimeFilter,
+} from "@langfuse/shared";
+import { joinTableCoreAndMetrics } from "@/src/components/table/utils/joinTableCoreAndMetrics";
+import { useTableDateRange } from "@/src/hooks/useTableDateRange";
+import { toAbsoluteTimeRange } from "@/src/utils/date-range-utils";
+import Page from "@/src/components/layouts/page";
+import { TableHeaderControls } from "@/src/components/table/table-header-controls";
+import { UsersOnboarding } from "@/src/components/onboarding/UsersOnboarding";
+
+type RowData = {
+ userId: string;
+ environment?: string;
+ firstEvent: string;
+ lastEvent: string;
+ totalEvents: string;
+ totalTokens: string;
+ totalCost: string;
+};
+
+export default function UsersPage() {
+ const router = useRouter();
+ const projectId = router.query.projectId as string;
+ const { isV4 } = useReadPath();
+
+ // Check if the user has any users
+ const { data: hasAnyUser, isLoading } = api.users.hasAny.useQuery(
+ { projectId },
+ {
+ enabled: !!projectId && !isV4,
+ trpc: {
+ context: {
+ skipBatch: true,
+ },
+ },
+ refetchInterval: 10_000,
+ },
+ );
+
+ const { data: hasAnyUserFromEvents, isLoading: isLoadingFromEvents } =
+ api.users.hasAnyFromEvents.useQuery(
+ { projectId },
+ {
+ enabled: !!projectId && isV4,
+ trpc: {
+ context: {
+ skipBatch: true,
+ },
+ },
+ refetchInterval: 10_000,
+ },
+ );
+
+ const hasUsers = isV4 ? hasAnyUserFromEvents : hasAnyUser;
+ const isLoadingUsers = isV4 ? isLoadingFromEvents : isLoading;
+ const showOnboarding = !isLoadingUsers && !hasUsers;
+
+ return (
+ <Page
+ headerProps={{
+ title: "Users",
+ help: {
+ description: (
+ <>
+ Attribute data in Langfuse to a user by adding a userId to your
+ traces. See{" "}
+ <a
+ href="https://langfuse.com/docs/observability/features/users"
+ target="_blank"
+ rel="noopener noreferrer"
+ className="decoration-primary/30 hover:decoration-primary underline"
+ onClick={(e) => e.stopPropagation()}
+ >
+ docs
+ </a>{" "}
+ to learn more.
+ </>
+ ),
+ href: "https://langfuse.com/docs/observability/features/users",
+ },
+ }}
+ scrollable={showOnboarding}
+ >
+ {/* Show onboarding screen if user has no users */}
+ {showOnboarding ? (
+ <UsersOnboarding />
+ ) : (
+ <UsersTable isV4={isV4} showControlsInPageHeader />
+ )}
+ </Page>
+ );
+}
+
+const UsersTable = ({
+ isV4,
+ showControlsInPageHeader = false,
+}: {
+ isV4: boolean;
+ showControlsInPageHeader?: boolean;
+}) => {
+ const router = useRouter();
+ const projectId = router.query.projectId as string;
+
+ // The two read paths answer different facet sets from different tables, so
+ // they get different configs — and different persistence keys, or a v4-only
+ // filter would rehydrate on a v3 project as a failed query.
+ const usersFilterConfig = useMemo(() => getUsersFilterConfig(isV4), [isV4]);
+
+ const { setDetailPageList } = useDetailPageLists();
+
+ const [paginationState, setPaginationState] = useQueryParams({
+ pageIndex: withDefault(NumberParam, 0),
+ pageSize: withDefault(NumberParam, 50),
+ });
+
+ // The picker renders in the page header via the header controls slot; this
+ // reads the same shared per-project range to filter the table.
+ const { timeRange, setTimeRange } = useTableDateRange(projectId);
+
+ // Convert timeRange to absolute date range for compatibility
+ const dateRange = useMemo(() => {
+ return toAbsoluteTimeRange(timeRange) ?? undefined;
+ }, [timeRange]);
+
+ // Both users queries map "Timestamp" onto their own time column
+ // (`t.timestamp` on v3, `e.start_time` on v4), so one filter serves both.
+ const dateRangeFilter = useMemo<FilterState>(
+ () =>
+ dateRange
+ ? [
+ {
+ column: "Timestamp",
+ type: "datetime",
+ operator: ">=",
+ value: dateRange.from,
+ },
+ {
+ column: "Timestamp",
+ type: "datetime",
+ operator: "<=",
+ value: dateRange.to,
+ },
+ ]
+ : [],
+ [dateRange],
+ );
+
+ const { viewControllersRef, onExplicitFilterStateChange } =
+ useTableViewFilterChange();
+
+ const filterStateOptions: UseSidebarFilterStateOptions = useMemo(
+ () => ({
+ stateLocation: "urlAndSessionStorage",
+ onExplicitFilterStateChange,
+ sessionFilterContextId: buildSidebarFilterSessionContextId(projectId),
+ // Environment is a sidebar facet here, like every other filter — the page
+ // no longer keeps its own environment selection beside the filter state.
+ implicitDefaultConfig: DEFAULT_SIDEBAR_IMPLICIT_ENVIRONMENT_CONFIG,
+ isV4,
+ }),
+ [isV4, projectId, onExplicitFilterStateChange],
+ );
+
+ // Split core/presentation so the v4 facet scan can refine its counts against
+ // the filters already applied — the presentation half needs the options the
+ // scan produces, so it cannot also be the thing that supplies the filters.
+ const filterCore = useSidebarFilterStateCore(
+ usersFilterConfig,
+ filterStateOptions,
+ );
+
+ // v3 facet options: the trace facets this page inherits, from the traces
+ // endpoint that already answers them.
+ const traceFilterOptionsResponse = api.traces.filterOptions.useQuery(
+ {
+ projectId,
+ timestampFilter:
+ dateRangeFilter.length > 0
+ ? (dateRangeFilter as TimeFilter[])
+ : undefined,
+ },
+ {
+ enabled: !isV4,
+ trpc: { context: { skipBatch: true } },
+ refetchOnMount: false,
+ refetchOnWindowFocus: false,
+ refetchOnReconnect: false,
+ staleTime: Infinity,
+ },
+ );
+
+ const environmentFilterOptions =
+ api.projects.environmentFilterOptions.useQuery(
+ {
+ projectId,
+ fromTimestamp: dateRange?.from,
+ },
+ {
+ enabled: !isV4,
+ trpc: { context: { skipBatch: true } },
+ refetchOnMount: false,
+ refetchOnWindowFocus: false,
+ refetchOnReconnect: false,
+ staleTime: Infinity,
+ },
+ );
+
+ const v3FacetOptions = useMemo<FacetOptions>(
+ () => ({
+ environment:
+ environmentFilterOptions.data?.map((value) => value.environment) ??
+ undefined,
+ traceName:
+ traceFilterOptionsResponse.data?.name?.map((n) => ({
+ value: n.value,
+ count: Number(n.count),
+ })) ?? undefined,
+ // tags don't have counts; they read A→Z
+ traceTags: sortOptionValues(
+ traceFilterOptionsResponse.data?.tags?.map((t) => t.value),
+ ),
+ userId:
+ traceFilterOptionsResponse.data?.users?.map((u) => ({
+ value: u.value,
+ count: Number(u.count),
+ })) ?? undefined,
+ sessionId:
+ traceFilterOptionsResponse.data?.sessions?.map((s) => ({
+ value: s.value,
+ count: Number(s.count),
+ })) ?? undefined,
+ }),
+ [environmentFilterOptions.data, traceFilterOptionsResponse.data],
+ );
+
+ // v4 facet options: the events facet scan, lazily per column, refined by the
+ // filters already applied.
+ const facetStartTimeFilter = useMemo<TimeFilter[]>(
+ () =>
+ dateRange
+ ? [
+ {
+ column: "startTime",
+ type: "datetime",
+ operator: ">=",
+ value: dateRange.from,
+ },
+ {
+ column: "startTime",
+ type: "datetime",
+ operator: "<=",
+ value: dateRange.to,
+ },
+ ]
+ : [],
+ [dateRange],
+ );
+
+ const {
+ filterOptions: v4FacetOptions,
+ isFilterOptionsPending: isV4FacetOptionsPending,
+ erroredColumns,
+ loadingColumns,
+ requestColumns,
+ } = useEventsFilterOptions({
+ projectId,
+ startTimeFilter: facetStartTimeFilter,
+ refiningFilter: filterCore.filterState,
+ lazy: true,
+ enabled: isV4,
+ });
+
+ const isSidebarFilterLoading = isV4
+ ? isV4FacetOptionsPending
+ : traceFilterOptionsResponse.isPending ||
+ environmentFilterOptions.isPending;
+
+ const queryFilter = useSidebarFilterPresentation(
+ filterCore,
+ usersFilterConfig,
+ isV4 ? v4FacetOptions : v3FacetOptions,
+ {
+ loading: isSidebarFilterLoading,
+ loadingColumns,
+ isV4,
+ },
+ );
+
+ // Lazy filter-options: load a facet's values when its sidebar section is
+ // expanded (also covers active filters, which auto-expand on mount).
+ const expandedFacets = queryFilter.expanded;
+ useEffect(() => {
+ requestColumns(expandedFacets);
+ }, [expandedFacets, requestColumns]);
+
+ const [searchQuery, setSearchQuery] = useQueryParam(
+ "search",
+ withDefault(StringParam, null),
+ );
+
+ const queryFilterRef = useRef(queryFilter);
+ queryFilterRef.current = queryFilter;
+
+ const setFiltersWrapper = useCallback(
+ (filters: FilterState) =>
+ queryFilterRef.current?.setFilterState(filters, { origin: "user" }),
+ [],
+ );
+
+ const observedOptions = toObservedOptions(
+ isV4 ? v4FacetOptions : v3FacetOptions,
+ isSidebarFilterLoading,
+ );
+
+ const filterState = queryFilter.effectiveFilterState.concat(dateRangeFilter);
+
+ const usersV3 = api.users.all.useQuery(
+ {
+ filter: filterState,
+ page: paginationState.pageIndex,
+ limit: paginationState.pageSize,
+ projectId,
+ searchQuery: searchQuery ?? undefined,
+ },
+ { enabled: !isV4 },
+ );
+
+ const userMetricsV3 = api.users.metrics.useQuery(
+ {
+ projectId,
+ userIds: usersV3.data?.users.map((u) => u.userId) ?? [],
+ filter: filterState,
+ },
+ {
+ enabled: usersV3.isSuccess && !isV4,
+ trpc: {
+ context: {
+ skipBatch: true,
+ },
+ },
+ },
+ );
+
+ const usersV4 = api.users.allFromEvents.useQuery(
+ {
+ filter: filterState,
+ page: paginationState.pageIndex,
+ limit: paginationState.pageSize,
+ projectId,
+ searchQuery: searchQuery ?? undefined,
+ },
+ { enabled: isV4 },
+ );
+
+ const userMetricsV4 = api.users.metricsFromEvents.useQuery(
+ {
+ projectId,
+ userIds: usersV4.data?.users.map((u) => u.userId) ?? [],
+ filter: filterState,
+ },
+ {
+ enabled: usersV4.isSuccess && isV4,
+ trpc: {
+ context: {
+ skipBatch: true,
+ },
+ },
+ },
+ );
+
+ // Select the active query based on beta state
+ const users = isV4 ? usersV4 : usersV3;
+ const userMetrics = isV4 ? userMetricsV4 : userMetricsV3;
+
+ type UserCoreOutput = RouterOutput["users"]["all"]["users"][number];
+ type UserMetricsOutput = RouterOutput["users"]["metrics"][number];
+
+ type CoreType = Omit<UserCoreOutput, "userId"> & { id: string };
+ type MetricType = Omit<UserMetricsOutput, "userId"> & { id: string };
+
+ const userRowData = joinTableCoreAndMetrics<CoreType, MetricType>(
+ users.data?.users.map((u) => ({
+ ...u,
+ id: u.userId,
+ })),
+ userMetrics.data?.map((u) => ({
+ ...u,
+ id: u.userId,
+ })),
+ );
+
+ const totalCount = users.data?.totalUsers
+ ? Number(users.data.totalUsers)
+ : null;
+
+ useEffect(() => {
+ if (users.isSuccess) {
+ setDetailPageList(
+ "users",
+ users.data.users.map((u) => ({ id: encodeURIComponent(u.userId) })),
+ );
+ }
+ // eslint-disable-next-line react-hooks/exhaustive-deps
+ }, [users.isSuccess, users.data]);
+
+ const columns: LangfuseColumnDef<RowData>[] = [
+ createLinkTableColumn<RowData>({
+ accessorKey: "userId",
+ enableColumnFilter: true,
+ header: "User ID",
+ headerTooltip: {
+ description:
+ "The unique identifier for the user that was logged in Langfuse. See docs for more details on how to set this up.",
+ href: "https://langfuse.com/docs/observability/features/users",
+ },
+ size: 150,
+ getCell: (value) => {
+ if (typeof value !== "string") return undefined;
+
+ return {
+ type: "link",
+ props: {
+ path: `/project/${projectId}/users/${encodeURIComponent(value)}`,
+ value,
+ },
+ };
+ },
+ }),
+ createBadgeTableColumn<RowData>({
+ accessorKey: "environment",
+ header: "Environment",
+ size: 150,
+ enableHiding: true,
+ }),
+ createTextTableColumn<RowData>({
+ accessorKey: "firstEvent",
+ header: "First Event",
+ headerTooltip: {
+ description: "The earliest trace recorded for this user.",
+ },
+ size: 150,
+ mapValue: (value) =>
+ userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
+ }),
+ createTextTableColumn<RowData>({
+ accessorKey: "lastEvent",
+ header: "Last Event",
+ headerTooltip: {
+ description: "The latest trace recorded for this user.",
+ },
+ size: 150,
+ mapValue: (value) =>
+ userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
+ }),
+ createTextTableColumn<RowData>({
+ accessorKey: "totalEvents",
+ header: "Total Events",
+ headerTooltip: {
+ description:
+ "Total number of events for the user, includes traces and observations. See data model for more details.",
+ href: "https://langfuse.com/docs/observability/data-model",
+ },
+ size: 120,
+ mapValue: (value) =>
+ userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
+ }),
+ createTextTableColumn<RowData>({
+ accessorKey: "totalTokens",
+ header: "Total Tokens",
+ headerTooltip: {
+ description:
+ "Total number of tokens used for the user across all generations.",
+ href: "https://langfuse.com/docs/model-usage-and-cost",
+ },
+ size: 120,
+ mapValue: (value) =>
+ userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
+ }),
+ createTextTableColumn<RowData>({
+ accessorKey: "totalCost",
+ header: "Total Cost",
+ headerTooltip: {
+ description: "Total cost for the user across all generations.",
+ href: "https://langfuse.com/docs/model-usage-and-cost",
+ },
+ size: 120,
+ mapValue: (value) =>
+ userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
+ }),
+ ];
+
+ const [columnVisibility, setColumnVisibility] = useColumnVisibility(
+ "users",
+ columns,
+ );
+ const [columnOrder, setColumnOrder] = useColumnOrder<RowData>(
+ "users",
+ columns,
+ );
+ const { isLoading: isViewLoading, ...viewControllers } = useTableViewManager({
+ tableName: TableViewPresetTableName.Users,
+ projectId,
+ stateUpdaters: {
+ setFilters: (filters) =>
+ queryFilterRef.current.setFilterState(filters, {
+ origin: "saved_view",
+ }),
+ setExpandedFilters: queryFilter.onExpandedChange,
+ setSearchQuery,
+ setColumnOrder,
+ setColumnVisibility,
+ },
+ currentFilterState: queryFilter.explicitFilterState,
+ currentExpandedFilters: queryFilter.expanded,
+ validationContext: {
+ columns,
+ filterColumnDefinition: usersFilterConfig.columnDefinitions,
+ expandableFilterColumns: usersFilterConfig.facets.map(
+ (facet) => facet.column,
+ ),
+ },
+ });
+ viewControllersRef.current = viewControllers;
+ const handleSearchChange = (query: string | null) => {
+ viewControllers.handleUserStateChange(searchQuery ?? "", query ?? "");
+ setSearchQuery(query);
+ setPaginationState({ pageIndex: 0 });
+ };
+ const handleColumnOrderChange: typeof setColumnOrder = (update) => {
+ const next = typeof update === "function" ? update(columnOrder) : update;
+ viewControllers.handleUserStateChange(columnOrder, next);
+ setColumnOrder(next);
+ };
+ const handleColumnVisibilityChange: typeof setColumnVisibility = (update) => {
+ const next =
+ typeof update === "function" ? update(columnVisibility) : update;
+ viewControllers.handleUserStateChange(columnVisibility, next);
+ setColumnVisibility(next);
+ };
+
+ return (
+ <DataTableControlsProvider tableName={usersFilterConfig.tableName}>
+ <div className="flex h-full w-full flex-col">
+ {showControlsInPageHeader && (
+ <TableHeaderControls
+ timeRange={timeRange}
+ setTimeRange={setTimeRange}
+ />
+ )}
+ {/* In bar mode the composer and the toolbar stick together as one band
+ so the toolbar cannot scroll under the composer and render
+ half-clipped. */}
+ <div className="bg-background sticky top-0 z-30 pb-1.5">
+ <TableSearchBar
+ key={`${viewControllers.filterEditorResetKey}-${queryFilter.draftResetKey}`}
+ isV4={isV4}
+ filterState={queryFilter.searchBarFilterState}
+ setFilterState={setFiltersWrapper}
+ search={{ query: searchQuery, setQuery: handleSearchChange }}
+ projectId={projectId}
+ tableName={usersFilterConfig.tableName}
+ observed={observedOptions}
+ erroredColumns={erroredColumns}
+ onRequestColumns={requestColumns}
+ registry={isV4 ? USERS_FIELD_REGISTRY : LEGACY_USERS_FIELD_REGISTRY}
+ />
+ <DataTableToolbar
+ tableName={usersFilterConfig.tableName}
+ isV4={isV4}
+ rowClassName="my-1"
+ filterState={queryFilter.explicitFilterState}
+ columns={columns}
+ timeRange={showControlsInPageHeader ? undefined : timeRange}
+ setTimeRange={showControlsInPageHeader ? undefined : setTimeRange}
+ currentSearchQuery={searchQuery ?? ""}
+ columnVisibility={columnVisibility}
+ setColumnVisibility={handleColumnVisibilityChange}
+ columnOrder={columnOrder}
+ setColumnOrder={handleColumnOrderChange}
+ viewConfig={{
+ tableName: TableViewPresetTableName.Users,
+ projectId,
+ controllers: viewControllers,
+ }}
+ />
+ </div>
+ <ResizableFilterLayout>
+ <DataTableControls
+ key={viewControllers.filterEditorResetKey}
+ queryFilter={queryFilter}
+ />
+ <div className="flex flex-1 flex-col overflow-hidden">
+ <DataTable
+ tableName="users"
+ columns={columns}
+ data={
+ users.isLoading || isViewLoading
+ ? { isLoading: true, isError: false }
+ : users.isError
+ ? {
+ isLoading: false,
+ isError: true,
+ error: users.error.message,
+ }
+ : {
+ isLoading: false,
+ isError: false,
+ data: userRowData.rows?.map((t) => {
+ return {
+ userId: t.id,
+ environment: t.environment ?? undefined,
+ firstEvent:
+ t.firstTrace?.toLocaleString() ?? "No event yet",
+ lastEvent:
+ t.lastTrace?.toLocaleString() ?? "No event yet",
+ totalEvents: compactNumberFormatter(
+ isV4
+ ? Number(t.totalObservations ?? 0)
+ : Number(t.totalTraces ?? 0) +
+ Number(t.totalObservations ?? 0),
+ ),
+ totalTokens: compactNumberFormatter(
+ t.totalTokens ?? 0,
+ ),
+ totalCost: usdFormatter(
+ t.sumCalculatedTotalCost ?? 0,
+ 2,
+ 2,
+ ),
+ };
+ }),
+ }
+ }
+ pagination={{
+ totalCount,
+ onChange: setPaginationState,
+ state: paginationState,
+ }}
+ columnVisibility={columnVisibility}
+ onColumnVisibilityChange={handleColumnVisibilityChange}
+ columnOrder={columnOrder}
+ onColumnOrderChange={handleColumnOrderChange}
+ cellPadding="comfortable"
+ />
+ </div>
+ </ResizableFilterLayout>
+ </div>
+ </DataTableControlsProvider>
+ );
+};
diff --git a/web/src/pages/project/[projectId]/users/[userId].tsx b/web/src/pages/project/[projectId]/users/[userId].tsx
index 8b0fb45cae..3734acb52f 100644
--- a/web/src/pages/project/[projectId]/users/[userId].tsx
+++ b/web/src/pages/project/[projectId]/users/[userId].tsx
@@ -1,240 +1 @@
-import { useRouter } from "next/router";
-import { api } from "@/src/utils/api";
-import {
- RouteParamsPendingFallback,
- useReadyRouteParams,
-} from "@/src/hooks/useReadyRouteParams";
-import TracesTable from "@/src/components/table/use-cases/traces";
-import ScoresTable from "@/src/components/table/use-cases/scores";
-import { compactNumberFormatter, usdFormatter } from "@/src/utils/numbers";
-import { StringParam, useQueryParam, withDefault } from "use-query-params";
-import { DetailPageNav } from "@/src/features/navigate-detail-pages/DetailPageNav";
-import SessionsTable from "@/src/components/table/use-cases/sessions";
-import { cn } from "@/src/utils/tailwind";
-import { Badge } from "@/src/components/ui/badge";
-import { ActionButton } from "@/src/components/ActionButton";
-import { LayoutDashboard } from "lucide-react";
-import Page from "@/src/components/layouts/page";
-import { useReadPath } from "@/src/features/events/hooks/useReadPath";
-import { ObservationsEventsTable } from "@/src/features/events/components";
-
-const tabs = ["Traces", "Sessions", "Scores"] as const;
-
-export default function UserPage() {
- const route = useReadyRouteParams(["projectId", "userId"]);
- if (!route.ready) return <RouteParamsPendingFallback />;
- return (
- <UserDetailPage
- projectId={route.params.projectId}
- userId={route.params.userId}
- />
- );
-}
-
-function UserDetailPage({
- projectId,
- userId,
-}: {
- projectId: string;
- userId: string;
-}) {
- const router = useRouter();
- const { isV4 } = useReadPath();
-
- const userV3 = api.users.byId.useQuery(
- {
- projectId: projectId,
- userId,
- },
- { enabled: Boolean(projectId) && Boolean(userId) && !isV4 },
- );
-
- const userV4 = api.users.byIdFromEvents.useQuery(
- {
- projectId: projectId,
- userId,
- },
- { enabled: Boolean(projectId) && Boolean(userId) && isV4 },
- );
-
- const user = isV4 ? userV4 : userV3;
-
- const [currentTab, setCurrentTab] = useQueryParam(
- "tab",
- withDefault(StringParam, tabs[0]),
- );
-
- const renderTabContent = () => {
- switch (currentTab as (typeof tabs)[number]) {
- case "Sessions":
- return <SessionsTab userId={userId} projectId={projectId} />;
- case "Traces":
- return <TracesTab userId={userId} projectId={projectId} />;
- case "Scores":
- return <ScoresTab userId={userId} projectId={projectId} />;
- default:
- return null;
- }
- };
-
- const handleTabChange = async (tab: string) => {
- if (router.query.filter || router.query.orderBy) {
- const newQuery = { ...router.query };
- delete newQuery.filter;
- delete newQuery.orderBy;
- await router.replace({ query: newQuery });
- }
- setCurrentTab(tab);
- };
-
- return (
- <Page
- headerProps={{
- title: userId,
- breadcrumb: [{ name: "Users", href: `/project/${projectId}/users` }],
- itemType: "USER",
- actionButtonsRight: (
- <>
- <ActionButton
- href={`/project/${projectId}?filter=user%3Bstring%3B%3B%3D%3B${userId}`} // dashboard filter serialization
- variant="secondary"
- icon={<LayoutDashboard className="h-4 w-4" />}
- >
- Dashboard
- </ActionButton>
- <DetailPageNav
- currentId={encodeURIComponent(userId)}
- path={(entry) =>
- `/project/${projectId}/users/${encodeURIComponent(entry.id)}`
- }
- listKey="users"
- />
- </>
- ),
- }}
- >
- <>
- {user.data && (
- <div className="flex flex-wrap gap-2 px-4 py-4">
- <Badge variant="outline">
- Observations:{" "}
- {compactNumberFormatter(user.data.totalObservations)}
- </Badge>
- <Badge variant="outline">
- Traces: {compactNumberFormatter(user.data.totalTraces)}
- </Badge>
- <Badge variant="outline">
- Total Tokens: {compactNumberFormatter(user.data.totalTokens)}
- </Badge>
- <Badge variant="outline">
- <span className="flex items-center gap-1">
- Total Cost: {usdFormatter(user.data.sumCalculatedTotalCost)}
- </span>
- </Badge>
- <Badge variant="outline">
- Active:{" "}
- {user.data.firstTrace
- ? `${user.data.firstTrace.toLocaleString()} - ${user.data.lastTrace?.toLocaleString()}`
- : isV4
- ? "No activity yet"
- : "No traces yet"}
- </Badge>
- </div>
- )}
-
- <div className="border-border border-t" />
-
- <div>
- <div className="sm:hidden">
- <label htmlFor="tabs" className="sr-only">
- Select a tab
- </label>
- <select
- id="tabs"
- name="tabs"
- className="border-border bg-background text-foreground block w-full rounded-md py-2 pr-10 pl-3 text-base focus:outline-hidden sm:text-sm"
- defaultValue={currentTab}
- onChange={(e) => handleTabChange(e.currentTarget.value)}
- >
- {tabs.map((tab) => (
- <option key={tab}>{tab}</option>
- ))}
- </select>
- </div>
- <div className="hidden sm:block">
- <div className="border-border border-b">
- <nav className="-mb-px flex" aria-label="Tabs">
- {tabs.map((tab) => (
- <button
- key={tab}
- className={cn(
- tab === currentTab
- ? "border-primary-accent text-foreground"
- : "text-muted-foreground hover:border-border hover:text-foreground border-transparent",
- "border-b-2 px-4 py-3 text-sm font-bold whitespace-nowrap",
- )}
- aria-current={tab === currentTab ? "page" : undefined}
- onClick={() => handleTabChange(tab)}
- >
- {tab}
- </button>
- ))}
- </nav>
- </div>
- </div>
- </div>
- <div className="flex flex-1 overflow-hidden">{renderTabContent()}</div>
- </>
- </Page>
- );
-}
-
-type TabProps = {
- userId: string;
- projectId: string;
-};
-
-function ScoresTab({ userId, projectId }: TabProps) {
- return (
- <ScoresTable
- projectId={projectId}
- userId={userId}
- hiddenColumns={["userId"]}
- />
- );
-}
-
-function TracesTab({ userId, projectId }: TabProps) {
- const { isV4 } = useReadPath();
-
- if (isV4) {
- return (
- <ObservationsEventsTable
- projectId={projectId}
- userId={userId}
- omittedFilter={["userId"]}
- />
- );
- }
-
- return (
- <TracesTable
- projectId={projectId}
- userId={userId}
- omittedFilter={["userId"]}
- />
- );
-}
-
-function SessionsTab({ userId, projectId }: TabProps) {
- const { isV4 } = useReadPath();
-
- return (
- <SessionsTable
- projectId={projectId}
- userId={userId}
- omittedFilter={["userIds"]}
- isV4={isV4}
- />
- );
-}
+export { default } from "@/src/features/users/UserDetailPage";
diff --git a/web/src/pages/project/[projectId]/users/index.tsx b/web/src/pages/project/[projectId]/users/index.tsx
index 5f4da767ae..2f7b7f0c57 100644
--- a/web/src/pages/project/[projectId]/users/index.tsx
+++ b/web/src/pages/project/[projectId]/users/index.tsx
@@ -1,698 +1 @@
-import { useRouter } from "next/router";
-import { useCallback, useEffect, useMemo, useRef } from "react";
-import {
- NumberParam,
- StringParam,
- useQueryParam,
- useQueryParams,
- withDefault,
-} from "use-query-params";
-import { DataTableToolbar } from "@/src/components/table/data-table-toolbar";
-import { DataTable } from "@/src/components/table/data-table";
-import {
- DataTableControls,
- DataTableControlsProvider,
-} from "@/src/components/table/data-table-controls";
-import { ResizableFilterLayout } from "@/src/components/table/resizable-filter-layout";
-import { createBadgeTableColumn } from "@/src/components/design-system/table/columns/createBadgeTableColumn";
-import { createLinkTableColumn } from "@/src/components/design-system/table/columns/createLinkTableColumn";
-import { createTextTableColumn } from "@/src/components/design-system/table/columns/createTextTableColumn";
-import { type LangfuseColumnDef } from "@/src/components/table/types";
-import { getUsersFilterConfig } from "@/src/features/filters/config/users-config";
-import {
- USERS_FIELD_REGISTRY,
- LEGACY_USERS_FIELD_REGISTRY,
-} from "@/src/features/filters/config/usersSearchRegistry";
-import {
- useSidebarFilterPresentation,
- useSidebarFilterStateCore,
- type FacetOptions,
- type UseSidebarFilterStateOptions,
-} from "@/src/features/filters/hooks/useSidebarFilterState";
-import { buildSidebarFilterSessionContextId } from "@/src/features/filters/lib/persistedSidebarFilterQuery";
-import { sortOptionValues } from "@/src/features/filters";
-import { useDetailPageLists } from "@/src/features/navigate-detail-pages/context";
-import { useEventsFilterOptions } from "@/src/features/events/hooks/useEventsFilterOptions";
-import { useReadPath } from "@/src/features/events/hooks/useReadPath";
-import { TableSearchBar } from "@/src/features/search-bar/components/TableSearchBar";
-import { useTableViewManager } from "@/src/components/table/table-view-presets/hooks/useTableViewManager";
-import { useTableViewFilterChange } from "@/src/components/table/table-view-presets/hooks/useTableViewFilterChange";
-import useColumnOrder from "@/src/features/column-visibility/hooks/useColumnOrder";
-import useColumnVisibility from "@/src/features/column-visibility/hooks/useColumnVisibility";
-import { toObservedOptions } from "@/src/features/search-bar/lib/observed-options";
-import { api } from "@/src/utils/api";
-import { compactNumberFormatter, usdFormatter } from "@/src/utils/numbers";
-import { type RouterOutput } from "@/src/utils/types";
-import {
- DEFAULT_SIDEBAR_IMPLICIT_ENVIRONMENT_CONFIG,
- TableViewPresetTableName,
- type FilterState,
- type TimeFilter,
-} from "@langfuse/shared";
-import { joinTableCoreAndMetrics } from "@/src/components/table/utils/joinTableCoreAndMetrics";
-import { useTableDateRange } from "@/src/hooks/useTableDateRange";
-import { toAbsoluteTimeRange } from "@/src/utils/date-range-utils";
-import Page from "@/src/components/layouts/page";
-import { TableHeaderControls } from "@/src/components/table/table-header-controls";
-import { UsersOnboarding } from "@/src/components/onboarding/UsersOnboarding";
-
-type RowData = {
- userId: string;
- environment?: string;
- firstEvent: string;
- lastEvent: string;
- totalEvents: string;
- totalTokens: string;
- totalCost: string;
-};
-
-export default function UsersPage() {
- const router = useRouter();
- const projectId = router.query.projectId as string;
- const { isV4 } = useReadPath();
-
- // Check if the user has any users
- const { data: hasAnyUser, isLoading } = api.users.hasAny.useQuery(
- { projectId },
- {
- enabled: !!projectId && !isV4,
- trpc: {
- context: {
- skipBatch: true,
- },
- },
- refetchInterval: 10_000,
- },
- );
-
- const { data: hasAnyUserFromEvents, isLoading: isLoadingFromEvents } =
- api.users.hasAnyFromEvents.useQuery(
- { projectId },
- {
- enabled: !!projectId && isV4,
- trpc: {
- context: {
- skipBatch: true,
- },
- },
- refetchInterval: 10_000,
- },
- );
-
- const hasUsers = isV4 ? hasAnyUserFromEvents : hasAnyUser;
- const isLoadingUsers = isV4 ? isLoadingFromEvents : isLoading;
- const showOnboarding = !isLoadingUsers && !hasUsers;
-
- return (
- <Page
- headerProps={{
- title: "Users",
- help: {
- description: (
- <>
- Attribute data in Langfuse to a user by adding a userId to your
- traces. See{" "}
- <a
- href="https://langfuse.com/docs/observability/features/users"
- target="_blank"
- rel="noopener noreferrer"
- className="decoration-primary/30 hover:decoration-primary underline"
- onClick={(e) => e.stopPropagation()}
- >
- docs
- </a>{" "}
- to learn more.
- </>
- ),
- href: "https://langfuse.com/docs/observability/features/users",
- },
- }}
- scrollable={showOnboarding}
- >
- {/* Show onboarding screen if user has no users */}
- {showOnboarding ? (
- <UsersOnboarding />
- ) : (
- <UsersTable isV4={isV4} showControlsInPageHeader />
- )}
- </Page>
- );
-}
-
-const UsersTable = ({
- isV4,
- showControlsInPageHeader = false,
-}: {
- isV4: boolean;
- showControlsInPageHeader?: boolean;
-}) => {
- const router = useRouter();
- const projectId = router.query.projectId as string;
-
- // The two read paths answer different facet sets from different tables, so
- // they get different configs — and different persistence keys, or a v4-only
- // filter would rehydrate on a v3 project as a failed query.
- const usersFilterConfig = useMemo(() => getUsersFilterConfig(isV4), [isV4]);
-
- const { setDetailPageList } = useDetailPageLists();
-
- const [paginationState, setPaginationState] = useQueryParams({
- pageIndex: withDefault(NumberParam, 0),
- pageSize: withDefault(NumberParam, 50),
- });
-
- // The picker renders in the page header via the header controls slot; this
- // reads the same shared per-project range to filter the table.
- const { timeRange, setTimeRange } = useTableDateRange(projectId);
-
- // Convert timeRange to absolute date range for compatibility
- const dateRange = useMemo(() => {
- return toAbsoluteTimeRange(timeRange) ?? undefined;
- }, [timeRange]);
-
- // Both users queries map "Timestamp" onto their own time column
- // (`t.timestamp` on v3, `e.start_time` on v4), so one filter serves both.
- const dateRangeFilter = useMemo<FilterState>(
- () =>
- dateRange
- ? [
- {
- column: "Timestamp",
- type: "datetime",
- operator: ">=",
- value: dateRange.from,
- },
- {
- column: "Timestamp",
- type: "datetime",
- operator: "<=",
- value: dateRange.to,
- },
- ]
- : [],
- [dateRange],
- );
-
- const { viewControllersRef, onExplicitFilterStateChange } =
- useTableViewFilterChange();
-
- const filterStateOptions: UseSidebarFilterStateOptions = useMemo(
- () => ({
- stateLocation: "urlAndSessionStorage",
- onExplicitFilterStateChange,
- sessionFilterContextId: buildSidebarFilterSessionContextId(projectId),
- // Environment is a sidebar facet here, like every other filter — the page
- // no longer keeps its own environment selection beside the filter state.
- implicitDefaultConfig: DEFAULT_SIDEBAR_IMPLICIT_ENVIRONMENT_CONFIG,
- isV4,
- }),
- [isV4, projectId, onExplicitFilterStateChange],
- );
-
- // Split core/presentation so the v4 facet scan can refine its counts against
- // the filters already applied — the presentation half needs the options the
- // scan produces, so it cannot also be the thing that supplies the filters.
- const filterCore = useSidebarFilterStateCore(
- usersFilterConfig,
- filterStateOptions,
- );
-
- // v3 facet options: the trace facets this page inherits, from the traces
- // endpoint that already answers them.
- const traceFilterOptionsResponse = api.traces.filterOptions.useQuery(
- {
- projectId,
- timestampFilter:
- dateRangeFilter.length > 0
- ? (dateRangeFilter as TimeFilter[])
- : undefined,
- },
- {
- enabled: !isV4,
- trpc: { context: { skipBatch: true } },
- refetchOnMount: false,
- refetchOnWindowFocus: false,
- refetchOnReconnect: false,
- staleTime: Infinity,
- },
- );
-
- const environmentFilterOptions =
- api.projects.environmentFilterOptions.useQuery(
- {
- projectId,
- fromTimestamp: dateRange?.from,
- },
- {
- enabled: !isV4,
- trpc: { context: { skipBatch: true } },
- refetchOnMount: false,
- refetchOnWindowFocus: false,
- refetchOnReconnect: false,
- staleTime: Infinity,
- },
- );
-
- const v3FacetOptions = useMemo<FacetOptions>(
- () => ({
- environment:
- environmentFilterOptions.data?.map((value) => value.environment) ??
- undefined,
- traceName:
- traceFilterOptionsResponse.data?.name?.map((n) => ({
- value: n.value,
- count: Number(n.count),
- })) ?? undefined,
- // tags don't have counts; they read A→Z
- traceTags: sortOptionValues(
- traceFilterOptionsResponse.data?.tags?.map((t) => t.value),
- ),
- userId:
- traceFilterOptionsResponse.data?.users?.map((u) => ({
- value: u.value,
- count: Number(u.count),
- })) ?? undefined,
- sessionId:
- traceFilterOptionsResponse.data?.sessions?.map((s) => ({
- value: s.value,
- count: Number(s.count),
- })) ?? undefined,
- }),
- [environmentFilterOptions.data, traceFilterOptionsResponse.data],
- );
-
- // v4 facet options: the events facet scan, lazily per column, refined by the
- // filters already applied.
- const facetStartTimeFilter = useMemo<TimeFilter[]>(
- () =>
- dateRange
- ? [
- {
- column: "startTime",
- type: "datetime",
- operator: ">=",
- value: dateRange.from,
- },
- {
- column: "startTime",
- type: "datetime",
- operator: "<=",
- value: dateRange.to,
- },
- ]
- : [],
- [dateRange],
- );
-
- const {
- filterOptions: v4FacetOptions,
- isFilterOptionsPending: isV4FacetOptionsPending,
- erroredColumns,
- loadingColumns,
- requestColumns,
- } = useEventsFilterOptions({
- projectId,
- startTimeFilter: facetStartTimeFilter,
- refiningFilter: filterCore.filterState,
- lazy: true,
- enabled: isV4,
- });
-
- const isSidebarFilterLoading = isV4
- ? isV4FacetOptionsPending
- : traceFilterOptionsResponse.isPending ||
- environmentFilterOptions.isPending;
-
- const queryFilter = useSidebarFilterPresentation(
- filterCore,
- usersFilterConfig,
- isV4 ? v4FacetOptions : v3FacetOptions,
- {
- loading: isSidebarFilterLoading,
- loadingColumns,
- isV4,
- },
- );
-
- // Lazy filter-options: load a facet's values when its sidebar section is
- // expanded (also covers active filters, which auto-expand on mount).
- const expandedFacets = queryFilter.expanded;
- useEffect(() => {
- requestColumns(expandedFacets);
- }, [expandedFacets, requestColumns]);
-
- const [searchQuery, setSearchQuery] = useQueryParam(
- "search",
- withDefault(StringParam, null),
- );
-
- const queryFilterRef = useRef(queryFilter);
- queryFilterRef.current = queryFilter;
-
- const setFiltersWrapper = useCallback(
- (filters: FilterState) =>
- queryFilterRef.current?.setFilterState(filters, { origin: "user" }),
- [],
- );
-
- const observedOptions = toObservedOptions(
- isV4 ? v4FacetOptions : v3FacetOptions,
- isSidebarFilterLoading,
- );
-
- const filterState = queryFilter.effectiveFilterState.concat(dateRangeFilter);
-
- const usersV3 = api.users.all.useQuery(
- {
- filter: filterState,
- page: paginationState.pageIndex,
- limit: paginationState.pageSize,
- projectId,
- searchQuery: searchQuery ?? undefined,
- },
- { enabled: !isV4 },
- );
-
- const userMetricsV3 = api.users.metrics.useQuery(
- {
- projectId,
- userIds: usersV3.data?.users.map((u) => u.userId) ?? [],
- filter: filterState,
- },
- {
- enabled: usersV3.isSuccess && !isV4,
- trpc: {
- context: {
- skipBatch: true,
- },
- },
- },
- );
-
- const usersV4 = api.users.allFromEvents.useQuery(
- {
- filter: filterState,
- page: paginationState.pageIndex,
- limit: paginationState.pageSize,
- projectId,
- searchQuery: searchQuery ?? undefined,
- },
- { enabled: isV4 },
- );
-
- const userMetricsV4 = api.users.metricsFromEvents.useQuery(
- {
- projectId,
- userIds: usersV4.data?.users.map((u) => u.userId) ?? [],
- filter: filterState,
- },
- {
- enabled: usersV4.isSuccess && isV4,
- trpc: {
- context: {
- skipBatch: true,
- },
- },
- },
- );
-
- // Select the active query based on beta state
- const users = isV4 ? usersV4 : usersV3;
- const userMetrics = isV4 ? userMetricsV4 : userMetricsV3;
-
- type UserCoreOutput = RouterOutput["users"]["all"]["users"][number];
- type UserMetricsOutput = RouterOutput["users"]["metrics"][number];
-
- type CoreType = Omit<UserCoreOutput, "userId"> & { id: string };
- type MetricType = Omit<UserMetricsOutput, "userId"> & { id: string };
-
- const userRowData = joinTableCoreAndMetrics<CoreType, MetricType>(
- users.data?.users.map((u) => ({
- ...u,
- id: u.userId,
- })),
- userMetrics.data?.map((u) => ({
- ...u,
- id: u.userId,
- })),
- );
-
- const totalCount = users.data?.totalUsers
- ? Number(users.data.totalUsers)
- : null;
-
- useEffect(() => {
- if (users.isSuccess) {
- setDetailPageList(
- "users",
- users.data.users.map((u) => ({ id: encodeURIComponent(u.userId) })),
- );
- }
- // eslint-disable-next-line react-hooks/exhaustive-deps
- }, [users.isSuccess, users.data]);
-
- const columns: LangfuseColumnDef<RowData>[] = [
- createLinkTableColumn<RowData>({
- accessorKey: "userId",
- enableColumnFilter: true,
- header: "User ID",
- headerTooltip: {
- description:
- "The unique identifier for the user that was logged in Langfuse. See docs for more details on how to set this up.",
- href: "https://langfuse.com/docs/observability/features/users",
- },
- size: 150,
- getCell: (value) => {
- if (typeof value !== "string") return undefined;
-
- return {
- type: "link",
- props: {
- path: `/project/${projectId}/users/${encodeURIComponent(value)}`,
- value,
- },
- };
- },
- }),
- createBadgeTableColumn<RowData>({
- accessorKey: "environment",
- header: "Environment",
- size: 150,
- enableHiding: true,
- }),
- createTextTableColumn<RowData>({
- accessorKey: "firstEvent",
- header: "First Event",
- headerTooltip: {
- description: "The earliest trace recorded for this user.",
- },
- size: 150,
- mapValue: (value) =>
- userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
- }),
- createTextTableColumn<RowData>({
- accessorKey: "lastEvent",
- header: "Last Event",
- headerTooltip: {
- description: "The latest trace recorded for this user.",
- },
- size: 150,
- mapValue: (value) =>
- userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
- }),
- createTextTableColumn<RowData>({
- accessorKey: "totalEvents",
- header: "Total Events",
- headerTooltip: {
- description:
- "Total number of events for the user, includes traces and observations. See data model for more details.",
- href: "https://langfuse.com/docs/observability/data-model",
- },
- size: 120,
- mapValue: (value) =>
- userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
- }),
- createTextTableColumn<RowData>({
- accessorKey: "totalTokens",
- header: "Total Tokens",
- headerTooltip: {
- description:
- "Total number of tokens used for the user across all generations.",
- href: "https://langfuse.com/docs/model-usage-and-cost",
- },
- size: 120,
- mapValue: (value) =>
- userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
- }),
- createTextTableColumn<RowData>({
- accessorKey: "totalCost",
- header: "Total Cost",
- headerTooltip: {
- description: "Total cost for the user across all generations.",
- href: "https://langfuse.com/docs/model-usage-and-cost",
- },
- size: 120,
- mapValue: (value) =>
- userMetrics.isSuccess ? (value ?? undefined) : { type: "loading" },
- }),
- ];
-
- const [columnVisibility, setColumnVisibility] = useColumnVisibility(
- "users",
- columns,
- );
- const [columnOrder, setColumnOrder] = useColumnOrder<RowData>(
- "users",
- columns,
- );
- const { isLoading: isViewLoading, ...viewControllers } = useTableViewManager({
- tableName: TableViewPresetTableName.Users,
- projectId,
- stateUpdaters: {
- setFilters: (filters) =>
- queryFilterRef.current.setFilterState(filters, {
- origin: "saved_view",
- }),
- setExpandedFilters: queryFilter.onExpandedChange,
- setSearchQuery,
- setColumnOrder,
- setColumnVisibility,
- },
- currentFilterState: queryFilter.explicitFilterState,
- currentExpandedFilters: queryFilter.expanded,
- validationContext: {
- columns,
- filterColumnDefinition: usersFilterConfig.columnDefinitions,
- expandableFilterColumns: usersFilterConfig.facets.map(
- (facet) => facet.column,
- ),
- },
- });
- viewControllersRef.current = viewControllers;
- const handleSearchChange = (query: string | null) => {
- viewControllers.handleUserStateChange(searchQuery ?? "", query ?? "");
- setSearchQuery(query);
- setPaginationState({ pageIndex: 0 });
- };
- const handleColumnOrderChange: typeof setColumnOrder = (update) => {
- const next = typeof update === "function" ? update(columnOrder) : update;
- viewControllers.handleUserStateChange(columnOrder, next);
- setColumnOrder(next);
- };
- const handleColumnVisibilityChange: typeof setColumnVisibility = (update) => {
- const next =
- typeof update === "function" ? update(columnVisibility) : update;
- viewControllers.handleUserStateChange(columnVisibility, next);
- setColumnVisibility(next);
- };
-
- return (
- <DataTableControlsProvider tableName={usersFilterConfig.tableName}>
- <div className="flex h-full w-full flex-col">
- {showControlsInPageHeader && (
- <TableHeaderControls
- timeRange={timeRange}
- setTimeRange={setTimeRange}
- />
- )}
- {/* In bar mode the composer and the toolbar stick together as one band
- so the toolbar cannot scroll under the composer and render
- half-clipped. */}
- <div className="bg-background sticky top-0 z-30 pb-1.5">
- <TableSearchBar
- key={`${viewControllers.filterEditorResetKey}-${queryFilter.draftResetKey}`}
- isV4={isV4}
- filterState={queryFilter.searchBarFilterState}
- setFilterState={setFiltersWrapper}
- search={{ query: searchQuery, setQuery: handleSearchChange }}
- projectId={projectId}
- tableName={usersFilterConfig.tableName}
- observed={observedOptions}
- erroredColumns={erroredColumns}
- onRequestColumns={requestColumns}
- registry={isV4 ? USERS_FIELD_REGISTRY : LEGACY_USERS_FIELD_REGISTRY}
- />
- <DataTableToolbar
- tableName={usersFilterConfig.tableName}
- isV4={isV4}
- rowClassName="my-1"
- filterState={queryFilter.explicitFilterState}
- columns={columns}
- timeRange={showControlsInPageHeader ? undefined : timeRange}
- setTimeRange={showControlsInPageHeader ? undefined : setTimeRange}
- currentSearchQuery={searchQuery ?? ""}
- columnVisibility={columnVisibility}
- setColumnVisibility={handleColumnVisibilityChange}
- columnOrder={columnOrder}
- setColumnOrder={handleColumnOrderChange}
- viewConfig={{
- tableName: TableViewPresetTableName.Users,
- projectId,
- controllers: viewControllers,
- }}
- />
- </div>
- <ResizableFilterLayout>
- <DataTableControls
- key={viewControllers.filterEditorResetKey}
- queryFilter={queryFilter}
- />
- <div className="flex flex-1 flex-col overflow-hidden">
- <DataTable
- tableName="users"
- columns={columns}
- data={
- users.isLoading || isViewLoading
- ? { isLoading: true, isError: false }
- : users.isError
- ? {
- isLoading: false,
- isError: true,
- error: users.error.message,
- }
- : {
- isLoading: false,
- isError: false,
- data: userRowData.rows?.map((t) => {
- return {
- userId: t.id,
- environment: t.environment ?? undefined,
- firstEvent:
- t.firstTrace?.toLocaleString() ?? "No event yet",
- lastEvent:
- t.lastTrace?.toLocaleString() ?? "No event yet",
- totalEvents: compactNumberFormatter(
- isV4
- ? Number(t.totalObservations ?? 0)
- : Number(t.totalTraces ?? 0) +
- Number(t.totalObservations ?? 0),
- ),
- totalTokens: compactNumberFormatter(
- t.totalTokens ?? 0,
- ),
- totalCost: usdFormatter(
- t.sumCalculatedTotalCost ?? 0,
- 2,
- 2,
- ),
- };
- }),
- }
- }
- pagination={{
- totalCount,
- onChange: setPaginationState,
- state: paginationState,
- }}
- columnVisibility={columnVisibility}
- onColumnVisibilityChange={handleColumnVisibilityChange}
- columnOrder={columnOrder}
- onColumnOrderChange={handleColumnOrderChange}
- cellPadding="comfortable"
- />
- </div>
- </ResizableFilterLayout>
- </div>
- </DataTableControlsProvider>
- );
-};
+export { default } from "@/src/features/users/UsersPage";