增加性能统计

This commit is contained in:
feie9456 2026-04-15 11:46:42 +08:00
parent 20ae332706
commit 6bb80d7c8c
5 changed files with 343 additions and 20 deletions

View File

@ -2,8 +2,9 @@ import Link from "next/link";
import { ArrowUpRight, Clock3, Smartphone, Sparkles } from "lucide-react";
import { DashboardCharts } from "@/components/admin/dashboard-charts";
import type { DashboardData } from "@/lib/analytics/contracts";
import { getDashboardData, parseDashboardQuery } from "@/lib/analytics/server";
import { formatDateTime, formatNumber } from "@/lib/utils";
import { formatDateTime, formatDurationMs, formatNumber } from "@/lib/utils";
export const dynamic = "force-dynamic";
@ -14,6 +15,41 @@ const ranges = [
{ label: "90 天", value: "90" },
] as const;
type RecentEventItem = DashboardData["recentEvents"][number];
type ConversationItem = DashboardData["recentConversations"][number];
function describeConversationMode(mode: string | null) {
if (mode === "clone") {
return "专属音色模式";
}
if (mode === "standard") {
return "标准模式";
}
return null;
}
function buildEventNote(event: RecentEventItem) {
const notes = [
event.durationMs && event.durationMs > 0 ? `耗时 ${formatDurationMs(event.durationMs)}` : null,
event.value?.trim() || null,
event.elementText?.trim() || null,
].filter(Boolean);
return notes[0] ?? "无额外说明";
}
function buildConversationNote(item: ConversationItem) {
const notes = [
item.turnIndex ? `${item.turnIndex}` : null,
describeConversationMode(item.mode),
item.durationMs && item.durationMs > 0
? `${item.role === "用户发言" ? "识别完成" : "文本完成"} ${formatDurationMs(item.durationMs)}`
: null,
].filter(Boolean);
return notes.join(" · ");
}
type AdminPageProps = {
searchParams: Promise<{
range?: string;
@ -44,7 +80,7 @@ export default async function AdminPage({ searchParams }: AdminPageProps) {
</h1>
</div>
<p className="max-w-3xl text-base leading-8 text-[var(--ink-2)]">
Android 使便使
Android 使便
</p>
</div>
@ -93,6 +129,27 @@ export default async function AdminPage({ searchParams }: AdminPageProps) {
<DashboardCharts activityTrend={data.activityTrend} topEvents={data.topEvents} />
<section className="soft-card p-6">
<div className="mb-5 flex items-center justify-between gap-4">
<div>
<p className="eyebrow"></p>
<h2 className="text-2xl font-semibold text-[var(--ink-1)]"></h2>
</div>
<p className="text-sm text-[var(--ink-3)]"></p>
</div>
<div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
{data.performanceMetrics.map((metric) => (
<article key={metric.label} className="rounded-[24px] border border-[var(--line-soft)] bg-white/80 px-5 py-5 shadow-[var(--shadow-card)]">
<p className="mb-2 text-sm text-[var(--ink-3)]">{metric.label}</p>
<strong className="text-3xl font-semibold text-[var(--ink-1)]">{formatDurationMs(metric.valueMs)}</strong>
<p className="mt-3 text-sm leading-7 text-[var(--ink-2)]">{metric.hint}</p>
<p className="mt-2 text-xs text-[var(--ink-3)]">{metric.sampleCount > 0 ? `基于 ${formatNumber(metric.sampleCount)} 次记录` : "暂无样本"}</p>
</article>
))}
</div>
</section>
<section className="grid gap-6 xl:grid-cols-[1.05fr_0.95fr]">
<article className="soft-card p-6">
<div className="mb-5 flex items-center justify-between gap-4">
@ -155,6 +212,38 @@ export default async function AdminPage({ searchParams }: AdminPageProps) {
</article>
</section>
<section className="soft-card p-6">
<div className="mb-5 flex items-center justify-between gap-4">
<div>
<p className="eyebrow"></p>
<h2 className="text-2xl font-semibold text-[var(--ink-1)]"></h2>
</div>
<p className="text-sm text-[var(--ink-3)]"></p>
</div>
<div className="grid gap-4 lg:grid-cols-2">
{data.recentConversations.length > 0 ? (
data.recentConversations.map((item) => (
<article key={item.id} className="rounded-[24px] border border-[var(--line-soft)] bg-white/80 px-5 py-5 shadow-[var(--shadow-card)]">
<div className="mb-3 flex items-center justify-between gap-3">
<span className="inline-flex rounded-full bg-[var(--surface-2)] px-3 py-1 text-sm font-medium text-[var(--ink-1)]">
{item.role}
</span>
<span className="text-xs text-[var(--ink-3)]">{formatDateTime(item.occurredAt)}</span>
</div>
<p className="text-base leading-8 text-[var(--ink-1)]">{item.text}</p>
<p className="mt-3 text-sm text-[var(--ink-3)]">{buildConversationNote(item) || "已自动归档到聊天记录"}</p>
<p className="mt-1 text-xs text-[var(--ink-3)]"> {item.sessionKey.slice(0, 18)}...</p>
</article>
))
) : (
<div className="rounded-[24px] border border-dashed border-[var(--line-soft)] bg-white/60 px-5 py-8 text-sm text-[var(--ink-3)] lg:col-span-2">
</div>
)}
</div>
</section>
<section className="soft-card p-6">
<div className="mb-5 flex items-center justify-between gap-4">
<div>
@ -189,7 +278,7 @@ export default async function AdminPage({ searchParams }: AdminPageProps) {
<p className="mt-1 text-xs text-[var(--ink-3)]">{event.component ?? "无额外标签"}</p>
</td>
<td className="rounded-r-[20px] px-4 py-4">
<p>{event.elementText ?? "无额外说明"}</p>
<p>{buildEventNote(event)}</p>
<p className="mt-1 text-xs text-[var(--ink-3)]"> {event.sessionKey.slice(0, 18)}...</p>
</td>
</tr>

View File

@ -65,6 +65,13 @@ export interface DashboardStat {
hint: string;
}
export interface DashboardPerformanceMetric {
label: string;
valueMs: number | null;
sampleCount: number;
hint: string;
}
export interface DashboardTrendPoint {
bucket: string;
total: number;
@ -85,10 +92,23 @@ export interface DashboardRecentEvent {
pathname: string | null;
component: string | null;
elementText: string | null;
value: string | null;
durationMs: number | null;
occurredAt: string;
metadata: JsonValue | null;
}
export interface DashboardConversationItem {
id: string;
sessionKey: string;
role: string;
text: string;
mode: string | null;
turnIndex: number | null;
durationMs: number | null;
occurredAt: string;
}
export interface DashboardRecentSession {
sessionKey: string;
platform: AnalyticsPlatform;
@ -101,10 +121,12 @@ export interface DashboardRecentSession {
export interface DashboardData {
stats: DashboardStat[];
performanceMetrics: DashboardPerformanceMetric[];
activityTrend: DashboardTrendPoint[];
topEvents: DashboardTopItem[];
topPaths: DashboardTopItem[];
recentEvents: DashboardRecentEvent[];
recentConversations: DashboardConversationItem[];
recentSessions: DashboardRecentSession[];
}

View File

@ -1,5 +1,6 @@
const EVENT_LABELS: Record<string, string> = {
screen_view: "打开页面",
digital_human_init_ready: "数字人准备完成",
voice_clone_entry_tap: "进入音色克隆",
avatar_selected: "选择数字人形象",
call_page_opened: "进入陪伴通话",
@ -30,7 +31,7 @@ const EVENT_LABELS: Record<string, string> = {
ai_conversation_error: "陪伴通话异常",
user_transcript_received: "收到用户语音文本",
assistant_transcript_completed: "陪伴回复已生成",
assistant_response_done: "陪伴回复结束",
assistant_response_done: "整轮回复完成",
ai_conversation_stopped: "陪伴通话已结束",
clone_tts_started: "开始播放专属音色",
clone_tts_finished: "专属音色播放完成",
@ -38,6 +39,9 @@ const EVENT_LABELS: Record<string, string> = {
camera_enabled: "打开摄像头",
camera_disabled: "关闭摄像头",
camera_capture_error: "摄像头采集失败",
camera_first_frame_ready: "摄像头画面就绪",
user_message_uploaded: "用户聊天记录已上传",
assistant_message_uploaded: "助手聊天记录已上传",
};
const PATH_LABELS: Record<string, string> = {
@ -79,9 +83,24 @@ export function describeAnalyticsType(type: string) {
return "页面浏览";
case "interaction":
return "操作记录";
case "performance":
return "性能指标";
case "conversation":
return "聊天记录";
case "error":
return "异常提醒";
default:
return humanizeFallback(type);
}
}
export function describeConversationRole(role: string | null | undefined) {
switch ((role ?? "").toLowerCase()) {
case "assistant":
return "助手回复";
case "user":
return "用户发言";
default:
return "对话记录";
}
}

View File

@ -12,6 +12,7 @@ import type {
} from "@/lib/analytics/contracts";
import { ANALYTICS_RANGE_OPTIONS } from "@/lib/analytics/contracts";
import {
describeConversationRole,
describeAnalyticsEventName,
describeAnalyticsPath,
describeAnalyticsType,
@ -165,6 +166,14 @@ function countResult(rows: Array<{ total: bigint | number | string | null | unde
return Number(total ?? 0);
}
function averageResult(rows: Array<{ average: number | null; total: bigint | number | string | null | undefined }>) {
const average = rows[0]?.average;
return {
average: average == null ? null : Number(average),
total: Number(rows[0]?.total ?? 0),
};
}
function formatBucket(bucket: Date, days: number) {
return new Intl.DateTimeFormat("zh-CN", {
month: "2-digit",
@ -188,6 +197,43 @@ function buildDeviceLabel(session: {
return browser || "未标记设备";
}
function readMetadataObject(metadata: unknown) {
if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
return null;
}
return metadata as Record<string, JsonValue>;
}
function readMetadataString(metadata: unknown, key: string) {
const object = readMetadataObject(metadata);
const value = object?.[key];
return typeof value === "string" && value.trim() ? value.trim() : null;
}
function readMetadataNumber(metadata: unknown, key: string) {
const object = readMetadataObject(metadata);
const value = object?.[key];
if (typeof value === "number" && Number.isFinite(value)) {
return value;
}
if (typeof value === "string" && value.trim()) {
const parsed = Number(value);
return Number.isFinite(parsed) ? parsed : null;
}
return null;
}
function compactText(value: string, max = 220) {
const normalized = value.trim().replace(/\s+/g, " ");
if (!normalized) {
return "";
}
return normalized.length > max ? `${normalized.slice(0, max)}...` : normalized;
}
export function parseDashboardQuery(raw: { range?: string }): DashboardQuery {
const parsedDays = Number(raw.range ?? 7);
const days = ANALYTICS_RANGE_OPTIONS.includes(parsedDays as (typeof ANALYTICS_RANGE_OPTIONS)[number])
@ -303,6 +349,7 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
const rangeStart = new Date(now.getTime() - query.days * 24 * 60 * 60 * 1000);
const sessionFilter = buildRangeFilter("lastSeenAt", rangeStart);
const eventFilter = buildRangeFilter("occurredAt", rangeStart);
const usageEventFilter = `${eventFilter} AND lower("type") NOT IN ('conversation', 'performance')`;
const sessionWhere = {
lastSeenAt: { gte: rangeStart },
platform: "ANDROID" as const,
@ -315,13 +362,18 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
const [
sessionCountRows,
visitorCountRows,
eventCountRows,
errorCountRows,
responseDurationRows,
connectDurationRows,
assistantTextDurationRows,
assistantFirstAudioRows,
cloneCreateDurationRows,
activityTrendRows,
topEventRows,
topPathRows,
recentSessions,
recentEvents,
recentConversations,
] = await Promise.all([
prisma.$queryRawUnsafe<Array<{ total: bigint }>>(`
SELECT COUNT(*)::bigint AS total
@ -333,11 +385,6 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
FROM "AnalyticsSession"
WHERE ${sessionFilter}
`),
prisma.$queryRawUnsafe<Array<{ total: bigint }>>(`
SELECT COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
`),
prisma.$queryRawUnsafe<Array<{ total: bigint }>>(`
SELECT COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
@ -348,11 +395,50 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
OR lower("name") LIKE '%fail%'
)
`),
prisma.$queryRawUnsafe<Array<{ average: number | null; total: bigint }>>(`
SELECT AVG("durationMs")::double precision AS average,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
AND "name" = 'assistant_response_done'
AND "durationMs" IS NOT NULL
`),
prisma.$queryRawUnsafe<Array<{ average: number | null; total: bigint }>>(`
SELECT AVG("durationMs")::double precision AS average,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
AND "name" = 'ai_conversation_connected'
AND "durationMs" IS NOT NULL
`),
prisma.$queryRawUnsafe<Array<{ average: number | null; total: bigint }>>(`
SELECT AVG("durationMs")::double precision AS average,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
AND "name" = 'assistant_message_uploaded'
AND "durationMs" IS NOT NULL
`),
prisma.$queryRawUnsafe<Array<{ average: number | null; total: bigint }>>(`
SELECT AVG(NULLIF("metadata"->>'firstAudioLatencyMs', '')::double precision) AS average,
COUNT(*) FILTER (WHERE NULLIF("metadata"->>'firstAudioLatencyMs', '') IS NOT NULL)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
AND "name" = 'assistant_response_done'
`),
prisma.$queryRawUnsafe<Array<{ average: number | null; total: bigint }>>(`
SELECT AVG("durationMs")::double precision AS average,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
AND "name" = 'voice_clone_create_succeeded'
AND "durationMs" IS NOT NULL
`),
prisma.$queryRawUnsafe<Array<{ bucket: Date; total: bigint }>>(`
SELECT date_trunc('${query.days <= 2 ? "hour" : "day"}', "occurredAt") AS bucket,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
WHERE ${usageEventFilter}
GROUP BY 1
ORDER BY 1 ASC
`),
@ -361,7 +447,7 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
MIN("type") AS detail,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
WHERE ${usageEventFilter}
GROUP BY "name"
ORDER BY total DESC
LIMIT 8
@ -370,7 +456,7 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
SELECT COALESCE(NULLIF("pathname", ''), '(未标记页面)') AS label,
COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
WHERE ${usageEventFilter}
GROUP BY 1
ORDER BY total DESC
LIMIT 8
@ -393,7 +479,10 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
},
}),
prisma.analyticsEvent.findMany({
where: eventWhere,
where: {
...eventWhere,
type: { not: "conversation" },
},
orderBy: { occurredAt: "desc" },
take: 18,
select: {
@ -405,6 +494,26 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
pathname: true,
component: true,
elementText: true,
value: true,
durationMs: true,
occurredAt: true,
metadata: true,
},
}),
prisma.analyticsEvent.findMany({
where: {
...eventWhere,
type: "conversation",
},
orderBy: { occurredAt: "desc" },
take: 12,
select: {
id: true,
sessionKey: true,
name: true,
elementText: true,
value: true,
durationMs: true,
occurredAt: true,
metadata: true,
},
@ -413,8 +522,12 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
const sessionCount = countResult(sessionCountRows);
const uniqueVisitors = countResult(visitorCountRows);
const eventCount = countResult(eventCountRows);
const errorCount = countResult(errorCountRows);
const responseDuration = averageResult(responseDurationRows);
const connectDuration = averageResult(connectDurationRows);
const assistantTextDuration = averageResult(assistantTextDurationRows);
const assistantFirstAudio = averageResult(assistantFirstAudioRows);
const cloneCreateDuration = averageResult(cloneCreateDurationRows);
return {
stats: [
@ -429,9 +542,12 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
hint: "按安装标识或会话编号去重后的实际使用主体",
},
{
label: "互动记录",
value: eventCount,
hint: sessionCount > 0 ? `平均每台设备 ${(eventCount / sessionCount).toFixed(1)}` : "当前还没有数据",
label: "平均回复耗时(ms)",
value: responseDuration.average == null ? 0 : Math.round(responseDuration.average),
hint:
responseDuration.total > 0
? `基于 ${responseDuration.total} 次已完成回复,从老人说完到整轮回复结束`
: "还没有可计算的回复耗时",
},
{
label: "异常提醒",
@ -439,6 +555,32 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
hint: "连接、播放、录音和资源准备失败都会在这里体现",
},
],
performanceMetrics: [
{
label: "连接成功",
valueMs: connectDuration.average,
sampleCount: connectDuration.total,
hint: "从点击开始对话到建立实时连接",
},
{
label: "文字回复完成",
valueMs: assistantTextDuration.average,
sampleCount: assistantTextDuration.total,
hint: "从老人停顿到拿到完整文字回复",
},
{
label: "开始出声",
valueMs: assistantFirstAudio.average,
sampleCount: assistantFirstAudio.total,
hint: "标准陪伴通话从停顿到第一段声音到达",
},
{
label: "专属音色生成",
valueMs: cloneCreateDuration.average,
sampleCount: cloneCreateDuration.total,
hint: "从提交录音到拿到可用专属音色",
},
],
activityTrend: activityTrendRows.map((row: { bucket: Date; total: bigint | number | string }) => ({
bucket: formatBucket(row.bucket, query.days),
total: Number(row.total),
@ -461,6 +603,8 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
pathname: string | null;
component: string | null;
elementText: string | null;
value: string | null;
durationMs: number | null;
occurredAt: Date;
metadata: unknown;
}) => ({
@ -472,9 +616,37 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
pathname: describeAnalyticsPath(event.pathname),
component: event.component,
elementText: event.elementText,
value: event.value,
durationMs: event.durationMs,
occurredAt: event.occurredAt.toISOString(),
metadata: (event.metadata ?? null) as DashboardData["recentEvents"][number]["metadata"],
})),
recentConversations: recentConversations.map((event: {
id: string;
sessionKey: string;
name: string;
elementText: string | null;
value: string | null;
durationMs: number | null;
occurredAt: Date;
metadata: unknown;
}) => {
const role = readMetadataString(event.metadata, "role") ?? (event.name.startsWith("assistant") ? "assistant" : "user");
const fullText = readMetadataString(event.metadata, "text") ?? event.elementText ?? event.value ?? "";
const mode = readMetadataString(event.metadata, "mode");
const turnIndex = readMetadataNumber(event.metadata, "turnIndex");
return {
id: event.id,
sessionKey: event.sessionKey,
role: describeConversationRole(role),
text: compactText(fullText),
mode,
turnIndex: turnIndex == null ? null : Math.round(turnIndex),
durationMs: event.durationMs,
occurredAt: event.occurredAt.toISOString(),
};
}),
recentSessions: recentSessions.map((session: {
sessionKey: string;
platform: AnalyticsPlatform;
@ -501,12 +673,13 @@ export async function getDashboardData(query: DashboardQuery): Promise<Dashboard
export async function getPublicAnalyticsSnapshot(): Promise<PublicAnalyticsSnapshot> {
const rangeStart = new Date(Date.now() - 24 * 60 * 60 * 1000);
const eventFilter = buildRangeFilter("occurredAt", rangeStart);
const usageEventFilter = `${eventFilter} AND lower("type") NOT IN ('conversation', 'performance')`;
const sessionFilter = buildRangeFilter("lastSeenAt", rangeStart);
const [eventRows, sessionRows, topActionRows] = await Promise.all([
prisma.$queryRawUnsafe<Array<{ total: bigint }>>(`
SELECT COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
WHERE ${usageEventFilter}
`),
prisma.$queryRawUnsafe<Array<{ total: bigint }>>(`
SELECT COUNT(*)::bigint AS total
@ -516,7 +689,7 @@ export async function getPublicAnalyticsSnapshot(): Promise<PublicAnalyticsSnaps
prisma.$queryRawUnsafe<Array<{ label: string; total: bigint }>>(`
SELECT "name" AS label, COUNT(*)::bigint AS total
FROM "AnalyticsEvent"
WHERE ${eventFilter}
WHERE ${usageEventFilter}
GROUP BY 1
ORDER BY total DESC
LIMIT 1

View File

@ -15,4 +15,24 @@ export function formatDateTime(value: string | Date) {
hour: "2-digit",
minute: "2-digit",
}).format(new Date(value));
}
export function formatDurationMs(value: number | null | undefined) {
if (value == null || !Number.isFinite(value)) {
return "暂无";
}
if (value < 1000) {
return `${Math.round(value)} ms`;
}
const seconds = value / 1000;
if (seconds < 60) {
const rounded = seconds >= 10 ? seconds.toFixed(1) : seconds.toFixed(2);
return `${rounded.replace(/\.0+$/, "")} s`;
}
const minutes = Math.floor(seconds / 60);
const remainSeconds = Math.round(seconds % 60);
return `${minutes}${remainSeconds}`;
}