Files
wehub-resource-sync 1443d3fdf9
Ruff Format Check / Ruff Format & Lint (push) Failing after 7m39s
Deploy VitePress site to Pages / build (push) Failing after 9m11s
Deploy VitePress site to Pages / Deploy (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:32:26 +08:00

990 lines
38 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
Dashboard Router - Statistics and monitoring endpoints
仪表板 - 统计和监控端点
Provides centralized dashboard APIs for monitoring system-wide statistics.
提供系统级统计和监控的API接口,用于监控系统运行状态、用户活动、工具调用、知识库使用等。
"""
import traceback
from datetime import datetime, timedelta
from typing import Any
from fastapi import APIRouter, Depends, HTTPException
from pydantic import BaseModel
from sqlalchemy import Integer, String, cast, distinct, func, select, text
from sqlalchemy.ext.asyncio import AsyncSession
from server.utils.auth_middleware import get_db, get_superadmin_user
from yuxi.repositories.agent_repository import AgentRepository
from yuxi.repositories.conversation_repository import ConversationRepository
from yuxi.storage.postgres.models_business import User
from yuxi.utils.datetime_utils import UTC, ensure_shanghai, shanghai_now, utc_now
from yuxi.utils.logging_config import logger
dashboard = APIRouter(prefix="/dashboard", tags=["Dashboard"])
def _get_time_group_format(column, time_range: str) -> Any:
"""
根据数据库类型生成时间分组格式化表达式。
PostgreSQL 使用 to_char + INTERVALSQLite 使用 datetime + strftime。
"""
# 检查是否是 PostgreSQL(通过检测 engine 或使用方言)
# 这里直接使用 PostgreSQL 语法,因为所有业务数据现在都在 PostgreSQL 上
if time_range == "14hours":
# 每小时: YYYY-MM-DD HH:00
time_expr = func.to_char(column + text("INTERVAL '8 hours'"), "YYYY-MM-DD HH24:00")
elif time_range == "14weeks":
# 每周: YYYY-WW
time_expr = func.to_char(column + text("INTERVAL '8 hours'"), "YYYY-IW")
else: # 14days
# 每天: YYYY-MM-DD
time_expr = func.to_char(column + text("INTERVAL '8 hours'"), "YYYY-MM-DD")
return time_expr
# =============================================================================
# Response Models
# =============================================================================
class UserActivityStats(BaseModel):
"""用户活跃度统计"""
total_users: int
active_users_24h: int
active_users_30d: int
daily_active_users: list[dict] # 最近7天每日活跃用户
class ToolCallStats(BaseModel):
"""工具调用统计"""
total_calls: int
successful_calls: int
failed_calls: int
success_rate: float
most_used_tools: list[dict]
tool_error_distribution: dict
daily_tool_calls: list[dict] # 最近7天每日工具调用数
class KnowledgeStats(BaseModel):
"""知识库统计"""
total_databases: int
total_files: int
total_nodes: int
total_storage_size: int # 字节
databases_by_type: dict
file_type_distribution: dict
class AgentAnalytics(BaseModel):
"""AI智能体分析"""
total_agents: int
agent_conversation_counts: list[dict]
agent_satisfaction_rates: list[dict]
agent_tool_usage: list[dict]
top_performing_agents: list[dict]
agent_names: dict[str, str] = {} # agent_id -> agent_name 映射
class ConversationListItem(BaseModel):
"""Conversation list item"""
thread_id: str
uid: str
agent_id: str
title: str
status: str
message_count: int
created_at: str
updated_at: str
class ConversationDetailResponse(BaseModel):
"""Conversation detail"""
thread_id: str
uid: str
agent_id: str
title: str
status: str
message_count: int
created_at: str
updated_at: str
total_tokens: int
messages: list[dict]
# =============================================================================
# Conversation Management - 对话管理
# =============================================================================
@dashboard.get("/conversations", response_model=list[ConversationListItem])
async def get_all_conversations(
uid: str | None = None,
agent_id: str | None = None,
status: str = "active",
limit: int = 100,
offset: int = 0,
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取所有对话(超级管理员权限)"""
from yuxi.storage.postgres.models_business import Conversation, ConversationStats
try:
# Build query
query = select(Conversation, ConversationStats).outerjoin(
ConversationStats, Conversation.id == ConversationStats.conversation_id
)
# Apply filters
if uid:
query = query.filter(Conversation.uid == uid)
if agent_id:
query = query.filter(Conversation.agent_id == agent_id)
if status != "all":
query = query.filter(Conversation.status == status)
# Order and paginate
query = query.order_by(Conversation.updated_at.desc()).limit(limit).offset(offset)
result = await db.execute(query)
results = result.all()
return [
{
"thread_id": conv.thread_id,
"uid": conv.uid,
"agent_id": conv.agent_id,
"title": conv.title,
"status": conv.status,
"message_count": stats.message_count if stats else 0,
"created_at": conv.created_at.isoformat(),
"updated_at": conv.updated_at.isoformat(),
}
for conv, stats in results
]
except Exception as e:
logger.error(f"Error getting conversations: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get conversations: {str(e)}")
@dashboard.get("/conversations/{thread_id}", response_model=ConversationDetailResponse)
async def get_conversation_detail(
thread_id: str,
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取指定对话详情(超级管理员权限)"""
try:
conv_manager = ConversationRepository(db)
conversation = await conv_manager.get_conversation_by_thread_id(thread_id)
if not conversation:
raise HTTPException(status_code=404, detail="Conversation not found")
# Get messages and stats
messages = await conv_manager.get_messages(conversation.id)
stats = await conv_manager.get_stats(conversation.id)
# Format messages
message_list = []
for msg in messages:
msg_dict = {
"id": msg.id,
"role": msg.role,
"content": msg.content,
"message_type": msg.message_type,
"created_at": msg.created_at.isoformat(),
}
# Include tool calls if present
if msg.tool_calls:
msg_dict["tool_calls"] = [
{
"id": tc.id,
"tool_name": tc.tool_name,
"tool_input": tc.tool_input,
"tool_output": tc.tool_output,
"status": tc.status,
}
for tc in msg.tool_calls
]
message_list.append(msg_dict)
return {
"thread_id": conversation.thread_id,
"uid": conversation.uid,
"agent_id": conversation.agent_id,
"title": conversation.title,
"status": conversation.status,
"message_count": stats.message_count if stats else len(message_list),
"created_at": conversation.created_at.isoformat(),
"updated_at": conversation.updated_at.isoformat(),
"total_tokens": stats.total_tokens if stats else 0,
"messages": message_list,
}
except HTTPException:
raise
except Exception as e:
logger.error(f"Error getting conversation detail: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get conversation detail: {str(e)}")
# =============================================================================
# 用户活动统计(超级管理员权限)
# =============================================================================
@dashboard.get("/stats/users", response_model=UserActivityStats)
async def get_user_activity_stats(
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取用户活动统计(超级管理员权限)"""
try:
from yuxi.storage.postgres.models_business import Conversation, User
now = utc_now()
# PostgreSQL with asyncpg requires naive datetime for naive DateTime columns
naive_now = now.replace(tzinfo=None)
# Conversations may store either the numeric user primary key or the login uid string.
# Join condition accounts for both representations.
user_join_condition = Conversation.uid == User.uid
# 基础用户统计(排除已删除用户)
total_users_result = await db.execute(select(func.count(User.id)).filter(User.is_deleted == 0))
total_users = total_users_result.scalar() or 0
# 不同时间段的活跃用户数(基于对话活动,排除已删除用户)
active_users_24h_result = await db.execute(
select(func.count(distinct(User.id)))
.select_from(Conversation)
.join(User, user_join_condition)
.filter(Conversation.updated_at >= naive_now - timedelta(days=1), User.is_deleted == 0)
)
active_users_24h = active_users_24h_result.scalar() or 0
active_users_30d_result = await db.execute(
select(func.count(distinct(User.id)))
.select_from(Conversation)
.join(User, user_join_condition)
.filter(Conversation.updated_at >= naive_now - timedelta(days=30), User.is_deleted == 0)
)
active_users_30d = active_users_30d_result.scalar() or 0
# 最近7天每日活跃用户(排除已删除用户)
daily_active_users = []
for i in range(7):
day_start = naive_now - timedelta(days=i + 1)
day_end = naive_now - timedelta(days=i)
active_count_result = await db.execute(
select(func.count(distinct(User.id)))
.select_from(Conversation)
.join(User, user_join_condition)
.filter(Conversation.updated_at >= day_start, Conversation.updated_at < day_end, User.is_deleted == 0)
)
active_count = active_count_result.scalar() or 0
daily_active_users.append({"date": day_start.strftime("%Y-%m-%d"), "active_users": active_count})
return UserActivityStats(
total_users=total_users,
active_users_24h=active_users_24h,
active_users_30d=active_users_30d,
daily_active_users=list(reversed(daily_active_users)), # 按时间正序
)
except Exception as e:
logger.error(f"Error getting user activity stats: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get user activity stats: {str(e)}")
# =============================================================================
# Tool Call Statistics - 工具调用统计
# =============================================================================
@dashboard.get("/stats/tools", response_model=ToolCallStats)
async def get_tool_call_stats(
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取工具调用统计(超级管理员权限)"""
try:
from yuxi.storage.postgres.models_business import ToolCall
now = utc_now()
# PostgreSQL with asyncpg requires naive datetime for naive DateTime columns
naive_now = now.replace(tzinfo=None)
# 基础工具调用统计
total_calls_result = await db.execute(select(func.count(ToolCall.id)))
total_calls = total_calls_result.scalar() or 0
successful_calls_result = await db.execute(select(func.count(ToolCall.id)).filter(ToolCall.status == "success"))
successful_calls = successful_calls_result.scalar() or 0
failed_calls = total_calls - successful_calls
success_rate = round((successful_calls / total_calls * 100), 2) if total_calls > 0 else 0
# 最常用工具
most_used_tools_result = await db.execute(
select(ToolCall.tool_name, func.count(ToolCall.id).label("count"))
.group_by(ToolCall.tool_name)
.order_by(func.count(ToolCall.id).desc())
.limit(10)
)
most_used_tools = most_used_tools_result.all()
most_used_tools = [{"tool_name": name, "count": count} for name, count in most_used_tools]
# 工具错误分布
tool_errors_result = await db.execute(
select(ToolCall.tool_name, func.count(ToolCall.id).label("error_count"))
.filter(ToolCall.status == "error")
.group_by(ToolCall.tool_name)
)
tool_errors = tool_errors_result.all()
tool_error_distribution = {name: count for name, count in tool_errors}
# 最近7天每日工具调用数
daily_tool_calls = []
for i in range(7):
day_start = naive_now - timedelta(days=i + 1)
day_end = naive_now - timedelta(days=i)
daily_count_result = await db.execute(
select(func.count(ToolCall.id)).filter(ToolCall.created_at >= day_start, ToolCall.created_at < day_end)
)
daily_count = daily_count_result.scalar() or 0
daily_tool_calls.append({"date": day_start.strftime("%Y-%m-%d"), "call_count": daily_count})
return ToolCallStats(
total_calls=total_calls,
successful_calls=successful_calls,
failed_calls=failed_calls,
success_rate=success_rate,
most_used_tools=most_used_tools,
tool_error_distribution=tool_error_distribution,
daily_tool_calls=list(reversed(daily_tool_calls)),
)
except Exception as e:
logger.error(f"Error getting tool call stats: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get tool call stats: {str(e)}")
# =============================================================================
# 知识库统计(超级管理员权限)
# =============================================================================
@dashboard.get("/stats/knowledge", response_model=KnowledgeStats)
async def get_knowledge_stats(
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取知识库统计(超级管理员权限)"""
try:
from yuxi.repositories.knowledge_base_repository import KnowledgeBaseRepository
from yuxi.repositories.knowledge_file_repository import KnowledgeFileRepository
kb_repo = KnowledgeBaseRepository()
file_repo = KnowledgeFileRepository()
kb_rows = await kb_repo.get_all()
total_databases = len(kb_rows)
databases_by_type: dict[str, int] = {}
files_by_type: dict[str, int] = {}
total_files = 0
total_nodes = 0
total_storage_size = 0
file_type_mapping = {
"txt": "文本文件",
"pdf": "PDF文档",
"docx": "Word文档",
"doc": "Word文档",
"md": "Markdown",
"html": "HTML网页",
"htm": "HTML网页",
"json": "JSON数据",
"csv": "CSV表格",
"xlsx": "Excel表格",
"xls": "Excel表格",
"pptx": "PowerPoint",
"ppt": "PowerPoint",
"png": "PNG图片",
"jpg": "JPEG图片",
"jpeg": "JPEG图片",
"gif": "GIF图片",
"svg": "SVG图片",
"mp4": "MP4视频",
"mp3": "MP3音频",
"zip": "ZIP压缩包",
"rar": "RAR压缩包",
"7z": "7Z压缩包",
}
for kb in kb_rows:
kb_type = (kb.kb_type or "unknown").lower()
display_type = {
"faiss": "FAISS",
"milvus": "Milvus",
"dify": "Dify",
"qdrant": "Qdrant",
"elasticsearch": "Elasticsearch",
"unknown": "未知类型",
}.get(kb_type, kb.kb_type or "未知类型")
databases_by_type[display_type] = databases_by_type.get(display_type, 0) + 1
files = await file_repo.list_by_kb_id(kb.kb_id)
total_files += len(files)
for record in files:
file_ext = (record.file_type or "").lower()
display_name = file_type_mapping.get(file_ext, file_ext.upper() + "文件" if file_ext else "其他")
files_by_type[display_name] = files_by_type.get(display_name, 0) + 1
total_storage_size += int(record.file_size or 0)
return KnowledgeStats(
total_databases=total_databases,
total_files=total_files,
total_nodes=total_nodes,
total_storage_size=total_storage_size,
databases_by_type=databases_by_type,
file_type_distribution=files_by_type,
)
except Exception as e:
logger.error(f"Error getting knowledge stats: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get knowledge stats: {str(e)}")
# =============================================================================
# 智能体分析(超级管理员权限)
# =============================================================================
@dashboard.get("/stats/agents", response_model=AgentAnalytics)
async def get_agent_analytics(
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取智能体分析(超级管理员权限)"""
try:
from yuxi.storage.postgres.models_business import Conversation, Message, MessageFeedback, ToolCall
# 获取所有智能体
agents_result = await db.execute(
select(Conversation.agent_id, func.count(Conversation.id).label("conversation_count")).group_by(
Conversation.agent_id
)
)
agents = agents_result.all()
total_agents = len(agents)
agent_conversation_counts = [{"agent_id": agent_id, "conversation_count": count} for agent_id, count in agents]
# 智能体满意度统计
agent_satisfaction = []
for agent_id, _ in agents:
total_feedbacks_result = await db.execute(
select(func.count(MessageFeedback.id))
.join(Message, MessageFeedback.message_id == Message.id)
.join(Conversation, Message.conversation_id == Conversation.id)
.filter(Conversation.agent_id == agent_id)
)
total_feedbacks = total_feedbacks_result.scalar() or 0
positive_feedbacks_result = await db.execute(
select(func.count(MessageFeedback.id))
.join(Message, MessageFeedback.message_id == Message.id)
.join(Conversation, Message.conversation_id == Conversation.id)
.filter(Conversation.agent_id == agent_id, MessageFeedback.rating == "like")
)
positive_feedbacks = positive_feedbacks_result.scalar() or 0
satisfaction_rate = round((positive_feedbacks / total_feedbacks * 100), 2) if total_feedbacks > 0 else 100
agent_satisfaction.append(
{"agent_id": agent_id, "satisfaction_rate": satisfaction_rate, "total_feedbacks": total_feedbacks}
)
# 智能体工具使用统计
agent_tool_usage = []
for agent_id, _ in agents:
tool_usage_count_result = await db.execute(
select(func.count(ToolCall.id))
.join(Message, ToolCall.message_id == Message.id)
.join(Conversation, Message.conversation_id == Conversation.id)
.filter(Conversation.agent_id == agent_id)
)
tool_usage_count = tool_usage_count_result.scalar() or 0
agent_tool_usage.append({"agent_id": agent_id, "tool_usage_count": tool_usage_count})
# 表现最佳的智能体(按对话数排序)
top_performing_agents = []
for i, (agent_id, conv_count) in enumerate(agents):
# 获取满意度数据
satisfaction_data = next(
(s for s in agent_satisfaction if s["agent_id"] == agent_id), {"satisfaction_rate": 0}
)
top_performing_agents.append(
{
"agent_id": agent_id,
"conversation_count": conv_count,
"satisfaction_rate": satisfaction_data["satisfaction_rate"],
}
)
# 按对话数排序,取前5名
top_performing_agents.sort(key=lambda x: x["conversation_count"], reverse=True)
top_performing_agents = top_performing_agents[:5]
agent_slugs = [agent_id for agent_id, _ in agents if agent_id]
agent_names = {}
if agent_slugs:
agent_repo = AgentRepository(db)
agent_names = {agent.slug: agent.name for agent in await agent_repo.list_by_slugs(agent_slugs)}
return AgentAnalytics(
total_agents=total_agents,
agent_conversation_counts=agent_conversation_counts,
agent_satisfaction_rates=agent_satisfaction,
agent_tool_usage=agent_tool_usage,
top_performing_agents=top_performing_agents,
agent_names=agent_names,
)
except Exception as e:
logger.error(f"Error getting agent analytics: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get agent analytics: {str(e)}")
# =============================================================================
# 基础统计(超级管理员权限)
# =============================================================================
@dashboard.get("/stats")
async def get_dashboard_stats(
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取基础统计(超级管理员权限)"""
from yuxi.storage.postgres.models_business import Conversation, Message, MessageFeedback
try:
# Basic counts
total_conversations_result = await db.execute(select(func.count(Conversation.id)))
total_conversations = total_conversations_result.scalar() or 0
active_conversations_result = await db.execute(
select(func.count(Conversation.id)).filter(Conversation.status == "active")
)
active_conversations = active_conversations_result.scalar() or 0
total_messages_result = await db.execute(select(func.count(Message.id)))
total_messages = total_messages_result.scalar() or 0
total_users_result = await db.execute(select(func.count(User.id)).filter(User.is_deleted == 0))
total_users = total_users_result.scalar() or 0
# Feedback statistics
total_feedbacks_result = await db.execute(select(func.count(MessageFeedback.id)))
total_feedbacks = total_feedbacks_result.scalar() or 0
like_count_result = await db.execute(
select(func.count(MessageFeedback.id)).filter(MessageFeedback.rating == "like")
)
like_count = like_count_result.scalar() or 0
# Calculate satisfaction rate
satisfaction_rate = round((like_count / total_feedbacks * 100), 2) if total_feedbacks > 0 else 100
return {
"total_conversations": total_conversations,
"active_conversations": active_conversations,
"total_messages": total_messages,
"total_users": total_users,
"feedback_stats": {
"total_feedbacks": total_feedbacks,
"satisfaction_rate": satisfaction_rate,
},
}
except Exception as e:
logger.error(f"Error getting dashboard stats: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get dashboard stats: {str(e)}")
# =============================================================================
# 反馈管理(超级管理员权限)
# =============================================================================
class FeedbackListItem(BaseModel):
"""反馈列表项"""
id: int
uid: str
username: str | None
avatar: str | None
rating: str
reason: str | None
created_at: str
message_content: str
conversation_title: str | None
agent_id: str
@dashboard.get("/feedbacks", response_model=list[FeedbackListItem])
async def get_all_feedbacks(
rating: str | None = None,
agent_id: str | None = None,
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取所有反馈记录(超级管理员权限)"""
from yuxi.storage.postgres.models_business import Conversation, Message, MessageFeedback, User
try:
query = (
select(MessageFeedback, Message, Conversation, User)
.join(Message, MessageFeedback.message_id == Message.id)
.join(Conversation, Message.conversation_id == Conversation.id)
.outerjoin(User, MessageFeedback.uid == User.uid)
)
# Apply filters
if rating and rating in ["like", "dislike"]:
query = query.filter(MessageFeedback.rating == rating)
if agent_id:
query = query.filter(Conversation.agent_id == agent_id)
# Order by creation time (most recent first)
query = query.order_by(MessageFeedback.created_at.desc())
results = await db.execute(query)
results = results.all()
# Debug logging (privacy-safe)
logger.info(f"Found {len(results)} feedback records")
# Removed sensitive user data from logs for privacy compliance
return [
{
"id": feedback.id,
"message_id": feedback.message_id,
"uid": feedback.uid,
"username": user.username if user else None,
"avatar": user.avatar if user else None,
"rating": feedback.rating,
"reason": feedback.reason,
"created_at": feedback.created_at.isoformat(),
"message_content": message.content,
"conversation_title": conversation.title,
"agent_id": conversation.agent_id,
}
for feedback, message, conversation, user in results
]
except Exception as e:
logger.error(f"Error getting feedbacks: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get feedbacks: {str(e)}")
# =============================================================================
# 调用分析时间序列统计(超级管理员权限)
# =============================================================================
class TimeSeriesStats(BaseModel):
"""时间序列统计数据"""
data: list[dict] # [{"date": "2024-01-01", "data": {"item1": 50, "item2": 30}, "total": 80}, ...]
categories: list[str] # 所有类别名称
total_count: int
average_count: float
peak_count: int
peak_date: str
agent_names: dict[str, str] | None = None # agent_id -> agent_name 映射(仅 type=agents
@dashboard.get("/stats/calls/timeseries", response_model=TimeSeriesStats)
async def get_call_timeseries_stats(
type: str = "models", # models/agents/tokens/tools
time_range: str = "14days", # 14hours/14days/14weeks
db: AsyncSession = Depends(get_db),
current_user: User = Depends(get_superadmin_user),
):
"""获取调用分析时间序列统计(超级管理员权限)"""
try:
from yuxi.storage.postgres.models_business import Conversation, Message, ToolCall
# 计算时间范围(使用北京时间 UTC+8)
now = utc_now()
local_now = shanghai_now()
if time_range == "14hours":
intervals = 14
# 包含当前小时:从13小时前开始
start_time = now - timedelta(hours=intervals - 1)
group_format = _get_time_group_format(Message.created_at, time_range)
base_local_time = ensure_shanghai(start_time)
elif time_range == "14weeks":
intervals = 14
# 包含当前周:从13周前开始,并对齐到当周周一 00:00
local_start = local_now - timedelta(weeks=intervals - 1)
local_start = local_start - timedelta(days=local_start.weekday())
local_start = local_start.replace(hour=0, minute=0, second=0, microsecond=0)
start_time = local_start.astimezone(UTC)
group_format = _get_time_group_format(Message.created_at, time_range)
base_local_time = local_start
else: # 14days (default)
intervals = 14
# 包含当前天:从13天前开始
start_time = now - timedelta(days=intervals - 1)
group_format = _get_time_group_format(Message.created_at, time_range)
base_local_time = ensure_shanghai(start_time)
# Convert start_time to naive UTC datetime for PostgreSQL query
# PostgreSQL with asyncpg and naive DateTime columns requires naive datetime objects
query_start_time = start_time.replace(tzinfo=None)
# 根据类型查询数据
if type == "models":
# 模型调用统计(基于消息数量,按模型分组)
# 从message的extra_metadata中提取模型信息
category_expr = cast(Message.extra_metadata["response_metadata"]["model_name"], String)
query_result = await db.execute(
select(
group_format.label("date"),
func.count(Message.id).label("count"),
category_expr.label("category"),
)
.filter(Message.role == "assistant", Message.created_at >= query_start_time)
.filter(Message.extra_metadata.isnot(None))
.group_by(group_format, category_expr)
.order_by(group_format)
)
query = query_result.all()
elif type == "agents":
# 智能体调用统计(基于对话更新时间,按智能体分组)
# 为对话创建独立的时间格式化器(使用 PostgreSQL 兼容的 to_char + INTERVAL
conv_group_format = _get_time_group_format(Conversation.updated_at, time_range)
query_result = await db.execute(
select(
conv_group_format.label("date"),
func.count(Conversation.id).label("count"),
Conversation.agent_id.label("category"),
)
.filter(Conversation.updated_at.isnot(None))
.filter(Conversation.updated_at >= query_start_time)
.group_by(conv_group_format, Conversation.agent_id)
.order_by(conv_group_format)
)
query = query_result.all()
elif type == "tokens":
# Token消耗统计(区分input/output tokens
# 先查询input tokens
from sqlalchemy import literal
input_query_result = await db.execute(
select(
group_format.label("date"),
func.sum(
func.coalesce(
cast(cast(Message.extra_metadata["usage_metadata"]["input_tokens"], String), Integer), 0
)
).label("count"),
literal("input_tokens").label("category"),
)
.filter(
Message.created_at >= query_start_time,
Message.extra_metadata.isnot(None),
Message.extra_metadata["usage_metadata"].isnot(None),
)
.group_by(group_format)
.order_by(group_format)
)
input_query = input_query_result.all()
# 查询output tokens
output_query_result = await db.execute(
select(
group_format.label("date"),
func.sum(
func.coalesce(
cast(cast(Message.extra_metadata["usage_metadata"]["output_tokens"], String), Integer), 0
)
).label("count"),
literal("output_tokens").label("category"),
)
.filter(
Message.created_at >= query_start_time,
Message.extra_metadata.isnot(None),
Message.extra_metadata["usage_metadata"].isnot(None),
)
.group_by(group_format)
.order_by(group_format)
)
output_query = output_query_result.all()
# 合并两个查询结果
input_results = input_query
output_results = output_query
results = input_results + output_results
elif type == "tools":
# 工具调用统计(按工具名称分组)
# 为工具调用创建独立的时间格式化器(使用 PostgreSQL 兼容的 to_char + INTERVAL
tool_group_format = _get_time_group_format(ToolCall.created_at, time_range)
query_result = await db.execute(
select(
tool_group_format.label("date"),
func.count(ToolCall.id).label("count"),
ToolCall.tool_name.label("category"),
)
.filter(ToolCall.created_at >= query_start_time)
.group_by(tool_group_format, ToolCall.tool_name)
.order_by(tool_group_format)
)
query = query_result.all()
else:
raise HTTPException(status_code=422, detail=f"Invalid type: {type}")
if type != "tokens":
results = query
# 处理堆叠数据格式
# 首先收集所有类别
categories = set()
for result in results:
if hasattr(result, "category") and result.category:
categories.add(result.category)
# 如果没有类别数据,提供默认类别
if not categories:
if type == "models":
categories.add("unknown_model")
elif type == "agents":
categories.add("unknown_agent")
elif type == "tokens":
categories.update(["input_tokens", "output_tokens"])
elif type == "tools":
categories.add("unknown_tool")
categories = sorted(list(categories))
agent_names = None
if type == "agents" and categories:
agent_slugs = [c for c in categories if c]
if agent_slugs:
agent_repo = AgentRepository(db)
agent_names = {agent.slug: agent.name for agent in await agent_repo.list_by_slugs(agent_slugs)}
# 重新组织数据:按时间点分组每个类别的数据
time_data = {}
def normalize_week_key(raw_key: str) -> str:
base_date = datetime.strptime(f"{raw_key}-1", "%Y-%W-%w")
iso_year, iso_week, _ = base_date.isocalendar()
return f"{iso_year}-{iso_week:02d}"
for result in results:
date_key = result.date
if time_range == "14weeks":
date_key = normalize_week_key(date_key)
category = getattr(result, "category", "unknown")
count = result.count
if date_key not in time_data:
time_data[date_key] = {}
time_data[date_key][category] = count
# 填充缺失的时间点(使用北京时间)
data = []
# 从起始点开始(北京时间)
current_time = base_local_time
if time_range == "14hours":
delta = timedelta(hours=1)
elif time_range == "14weeks":
delta = timedelta(weeks=1)
else:
delta = timedelta(days=1)
for i in range(intervals):
if time_range == "14hours":
date_key = current_time.strftime("%Y-%m-%d %H:00")
elif time_range == "14weeks":
iso_year, iso_week, _ = current_time.isocalendar()
date_key = f"{iso_year}-{iso_week:02d}"
else:
date_key = current_time.strftime("%Y-%m-%d")
# 获取该时间点的数据
day_data = time_data.get(date_key, {})
day_total = sum(day_data.values())
# 确保所有类别都有值(缺失的补0
for category in categories:
if category not in day_data:
day_data[category] = 0
data.append({"date": date_key, "data": day_data, "total": day_total})
current_time += delta
# 计算统计指标
if type == "tools":
# 对于工具调用,显示所有时间的总数(与ToolStatsComponent保持一致)
from yuxi.storage.postgres.models_business import ToolCall
total_count_result = await db.execute(select(func.count(ToolCall.id)))
total_count = total_count_result.scalar() or 0
else:
# 其他类型使用时间序列数据的总和
total_count = sum(item["total"] for item in data)
average_count = round(total_count / intervals, 2) if intervals > 0 else 0
peak_data = max(data, key=lambda x: x["total"]) if data else {"total": 0, "date": ""}
return TimeSeriesStats(
data=data,
categories=categories,
total_count=total_count,
average_count=average_count,
peak_count=peak_data["total"],
peak_date=peak_data["date"],
agent_names=agent_names,
)
except HTTPException:
raise
except Exception as e:
logger.error(f"Error getting call timeseries stats: {e}")
logger.error(traceback.format_exc())
raise HTTPException(status_code=500, detail=f"Failed to get call timeseries stats: {str(e)}")