jettask 0.2.14__py3-none-any.whl → 0.2.16__py3-none-any.whl

jettask/api/v1/analytics.py

@@ -0,0 +1,323 @@
+"""
+分析模块 - 数据分析、查询和报表
+提供轻量级的路由入口，业务逻辑在 AnalyticsService 中实现
+"""
+from fastapi import APIRouter, HTTPException, Request, Query
+from typing import List, Dict, Optional, Any
+from datetime import datetime
+import logging
+
+from jettask.schemas import TimeRangeQuery
+from jettask.services.analytics_service import AnalyticsService
+from jettask.backend.namespace_data_access import get_namespace_data_access
+
+router = APIRouter(prefix="/analytics", tags=["analytics"])
+logger = logging.getLogger(__name__)
+
+# 获取全局数据访问实例
+data_access = get_namespace_data_access()
+
+
+# ============ 命名空间管理 ============
+
+@router.get("/namespaces")
+async def get_all_namespaces():
+    """
+    获取所有配置的命名空间列表
+    """
+    try:
+        namespaces = await data_access.get_all_namespaces()
+        return {
+            "success": True,
+            "data": namespaces
+        }
+    except Exception as e:
+        logger.error(f"获取命名空间列表失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 队列统计 ============
+
+@router.get("/queue-stats/{namespace}")
+async def get_queue_stats(namespace: str):
+    """
+    获取指定命名空间的队列统计信息
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        stats = await data_access.get_queue_stats(namespace)
+        return {
+            "success": True,
+            "data": stats
+        }
+    except Exception as e:
+        logger.error(f"获取队列统计失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/queue-trends/{namespace}")
+async def get_queue_trends(namespace: str, request: Request):
+    """
+    获取队列趋势数据
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        # 解析请求体
+        body = await request.json() if await request.body() else {}
+        
+        # 从请求体中获取参数
+        time_range = body.get('time_range', '1h')
+        queue_name = body.get('queue_name')
+        granularity = body.get('granularity', 'minute')
+        
+        # TODO: 实现队列趋势分析
+        return {
+            "success": True,
+            "namespace": namespace,
+            "time_range": time_range,
+            "queue_name": queue_name,
+            "data": [],
+            "granularity": granularity
+        }
+    except Exception as e:
+        logger.error(f"获取队列趋势失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 任务分析 ============
+
+@router.post("/task-analysis/{namespace}")
+async def analyze_tasks(namespace: str, request: Request):
+    """
+    分析任务执行情况
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        body = await request.json()
+        
+        # TODO: 实现任务分析逻辑
+        return {
+            "success": True,
+            "data": {
+                "total_tasks": 0,
+                "success_rate": 0.0,
+                "avg_execution_time": 0.0,
+                "error_distribution": {}
+            }
+        }
+    except Exception as e:
+        logger.error(f"任务分析失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/task-distribution/{namespace}")
+async def get_task_distribution(
+    namespace: str,
+    time_range: str = Query("24h", description="时间范围")
+):
+    """
+    获取任务分布情况
+    
+    Args:
+        namespace: 命名空间名称
+        time_range: 时间范围
+    """
+    try:
+        # TODO: 实现任务分布统计
+        return {
+            "success": True,
+            "data": {
+                "by_queue": {},
+                "by_status": {},
+                "by_worker": {},
+                "by_hour": []
+            }
+        }
+    except Exception as e:
+        logger.error(f"获取任务分布失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 性能分析 ============
+
+@router.get("/performance-metrics/{namespace}")
+async def get_performance_metrics(
+    namespace: str,
+    time_range: str = Query("1h", description="时间范围")
+):
+    """
+    获取性能指标
+    
+    Args:
+        namespace: 命名空间名称
+        time_range: 时间范围
+    """
+    try:
+        # TODO: 实现性能指标收集
+        return {
+            "success": True,
+            "data": {
+                "throughput": 0,
+                "latency": {
+                    "p50": 0,
+                    "p95": 0,
+                    "p99": 0
+                },
+                "error_rate": 0,
+                "queue_depth": 0
+            }
+        }
+    except Exception as e:
+        logger.error(f"获取性能指标失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/bottlenecks/{namespace}")
+async def identify_bottlenecks(namespace: str):
+    """
+    识别系统瓶颈
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        # TODO: 实现瓶颈分析
+        return {
+            "success": True,
+            "data": {
+                "slow_queues": [],
+                "high_error_queues": [],
+                "high_latency_tasks": [],
+                "recommendations": []
+            }
+        }
+    except Exception as e:
+        logger.error(f"识别瓶颈失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 报表生成 ============
+
+@router.post("/reports/generate/{namespace}")
+async def generate_report(
+    namespace: str,
+    request: Request
+):
+    """
+    生成分析报表
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        body = await request.json()
+        report_type = body.get("report_type", "daily")
+        start_time = body.get("start_time")
+        end_time = body.get("end_time")
+        
+        # TODO: 实现报表生成
+        return {
+            "success": True,
+            "data": {
+                "report_id": f"report_{namespace}_{datetime.now().strftime('%Y%m%d%H%M%S')}",
+                "report_type": report_type,
+                "status": "generated",
+                "url": None
+            }
+        }
+    except Exception as e:
+        logger.error(f"生成报表失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/reports/{report_id}")
+async def get_report(report_id: str):
+    """
+    获取报表内容
+    
+    Args:
+        report_id: 报表ID
+    """
+    try:
+        # TODO: 实现报表获取
+        return {
+            "success": True,
+            "data": {
+                "report_id": report_id,
+                "content": {},
+                "generated_at": datetime.now().isoformat()
+            }
+        }
+    except Exception as e:
+        logger.error(f"获取报表失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 实时监控 ============
+
+@router.get("/realtime/{namespace}/stats")
+async def get_realtime_stats(namespace: str):
+    """
+    获取实时统计数据
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        # TODO: 实现实时统计
+        return {
+            "success": True,
+            "data": {
+                "timestamp": datetime.now().isoformat(),
+                "active_tasks": 0,
+                "queued_tasks": 0,
+                "completed_last_minute": 0,
+                "failed_last_minute": 0,
+                "avg_processing_time": 0.0
+            }
+        }
+    except Exception as e:
+        logger.error(f"获取实时统计失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 数据导出 ============
+
+@router.post("/export/{namespace}")
+async def export_data(
+    namespace: str,
+    request: Request
+):
+    """
+    导出分析数据
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        body = await request.json()
+        export_format = body.get("format", "csv")
+        data_type = body.get("data_type", "tasks")
+        
+        # TODO: 实现数据导出
+        return {
+            "success": True,
+            "data": {
+                "export_id": f"export_{namespace}_{datetime.now().strftime('%Y%m%d%H%M%S')}",
+                "format": export_format,
+                "status": "pending",
+                "url": None
+            }
+        }
+    except Exception as e:
+        logger.error(f"导出数据失败: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+__all__ = ['router']

jettask/api/v1/namespaces.py

@@ -0,0 +1,134 @@
+"""
+命名空间管理路由
+提供命名空间的增删改查和管理功能
+"""
+from fastapi import APIRouter, HTTPException, Query
+from typing import Optional, List
+import logging
+import traceback
+
+from jettask.schemas import NamespaceCreate, NamespaceUpdate, NamespaceResponse
+from jettask.services.settings_service import SettingsService
+
+logger = logging.getLogger(__name__)
+
+# 创建独立的命名空间路由，设置 /namespaces 前缀
+router = APIRouter(prefix="/namespaces", tags=["namespaces"])
+
+
+@router.get("/", response_model=List[NamespaceResponse])
+async def list_namespaces(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=100),
+    is_active: Optional[bool] = None
+):
+    """
+    列出所有命名空间
+    
+    Args:
+        page: 页码（从1开始）
+        page_size: 每页数量
+        is_active: 是否只返回激活的命名空间
+    """
+    try:
+        return await SettingsService.list_namespaces(page, page_size, is_active)
+    except Exception as e:
+        logger.error(f"获取命名空间列表失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/", response_model=NamespaceResponse, status_code=201)
+async def create_namespace(namespace: NamespaceCreate):
+    """
+    创建新的命名空间
+    
+    Args:
+        namespace: 命名空间创建信息
+    """
+    try:
+        return await SettingsService.create_namespace(namespace)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"创建命名空间失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/{namespace_name}", response_model=NamespaceResponse)
+async def get_namespace(namespace_name: str):
+    """
+    获取指定命名空间的详细信息
+    
+    Args:
+        namespace_name: 命名空间名称
+    """
+    try:
+        return await SettingsService.get_namespace(namespace_name)
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except Exception as e:
+        logger.error(f"获取命名空间失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.put("/{namespace_name}", response_model=NamespaceResponse)
+async def update_namespace(namespace_name: str, namespace: NamespaceUpdate):
+    """
+    更新命名空间配置
+    
+    Args:
+        namespace_name: 命名空间名称
+        namespace: 更新的配置信息
+    """
+    try:
+        return await SettingsService.update_namespace(namespace_name, namespace)
+    except ValueError as e:
+        status_code = 404 if "不存在" in str(e) else 400
+        raise HTTPException(status_code=status_code, detail=str(e))
+    except Exception as e:
+        logger.error(f"更新命名空间失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.delete("/{namespace_name}")
+async def delete_namespace(namespace_name: str):
+    """
+    删除命名空间
+    
+    Args:
+        namespace_name: 命名空间名称
+    """
+    try:
+        return await SettingsService.delete_namespace(namespace_name)
+    except ValueError as e:
+        status_code = 400 if "默认命名空间" in str(e) else 404
+        raise HTTPException(status_code=status_code, detail=str(e))
+    except Exception as e:
+        logger.error(f"删除命名空间失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+
+@router.get("/{namespace_name}/statistics")
+async def get_namespace_statistics(namespace_name: str):
+    """
+    获取命名空间统计信息
+    
+    Args:
+        namespace_name: 命名空间名称
+    """
+    try:
+        return await SettingsService.get_namespace_statistics(namespace_name)
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except Exception as e:
+        logger.error(f"获取命名空间统计信息失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+__all__ = ['router']

jettask/api/v1/overview.py

@@ -0,0 +1,136 @@
+"""
+概览模块 - 系统总览、健康检查和仪表板统计
+提供轻量级的路由入口，业务逻辑在 OverviewService 中实现
+"""
+from fastapi import APIRouter, HTTPException, Query
+from typing import Optional
+import logging
+import traceback
+
+from jettask.schemas import TimeRangeQuery
+from jettask.services.overview_service import OverviewService
+
+logger = logging.getLogger(__name__)
+
+# 创建概览路由，添加 /overview 前缀
+router = APIRouter(prefix="/overview", tags=["overview"])
+
+
+# ============ 健康检查和根路径 ============
+
+@router.get("/")
+async def root():
+    """根路径"""
+    return OverviewService.get_root_info()
+
+
+@router.get("/health")
+async def health_check():
+    """健康检查"""
+    return OverviewService.get_health_status()
+
+
+# ============ 系统统计 ============
+
+@router.get("/system-stats/{namespace}")
+async def get_system_stats(namespace: str):
+    """
+    获取指定命名空间的系统统计信息
+    
+    Args:
+        namespace: 命名空间名称
+    """
+    try:
+        return await OverviewService.get_system_stats(namespace)
+    except Exception as e:
+        logger.error(f"获取系统统计信息失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 仪表板统计 ============
+
+@router.get("/dashboard-stats/{namespace}")
+async def get_dashboard_stats(
+    namespace: str,
+    time_range: str = "24h",
+    queues: Optional[str] = Query(None, description="逗号分隔的队列名称列表")
+):
+    """
+    获取仪表板统计数据（任务总数、成功数、失败数、成功率、吞吐量等）
+    
+    Args:
+        namespace: 命名空间名称
+        time_range: 时间范围（如'1h', '24h', '7d'）
+        queues: 逗号分隔的队列名称列表
+    """
+    try:
+        return await OverviewService.get_dashboard_stats(namespace, time_range, queues)
+    except Exception as e:
+        logger.error(f"获取仪表板统计数据失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ============ 队列排行榜 ============
+
+@router.get("/top-queues/{namespace}")
+async def get_top_queues(
+    namespace: str,
+    metric: str = Query("backlog", description="指标类型: backlog(积压) 或 error(错误率)"),
+    limit: int = 10,
+    time_range: str = "24h",
+    queues: Optional[str] = Query(None, description="逗号分隔的队列名称列表")
+):
+    """
+    获取队列排行榜 - 支持积压和错误率两种指标
+    
+    Args:
+        namespace: 命名空间名称
+        metric: 指标类型 (backlog/error)
+        limit: 返回的队列数量限制
+        time_range: 时间范围
+        queues: 逗号分隔的队列名称列表
+    """
+    try:
+        return await OverviewService.get_top_queues(namespace, metric, limit, time_range, queues)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"获取队列排行榜失败: {e}")
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+
+# ============ 概览统计数据 ============
+
+@router.post("/dashboard-overview-stats/{namespace}")
+async def get_dashboard_overview_stats(namespace: str, query: TimeRangeQuery):
+    """
+    获取概览页面的统一统计数据
+    包含：任务处理趋势、任务并发数量、任务处理时间、任务执行延时
+    
+    Args:
+        namespace: 命名空间名称
+        query: 时间范围查询参数
+    
+    Returns:
+        统一的时间序列数据，包含所有概览图表需要的指标和granularity字段
+    """
+    try:
+        return await OverviewService.get_dashboard_overview_stats(namespace, query)
+    except Exception as e:
+        logger.error(f"获取概览统计数据失败: {e}")
+        traceback.print_exc()
+        # 返回空数据而不是抛出异常
+        return {
+            "task_trend": [],
+            "concurrency": [],
+            "processing_time": [],
+            "creation_latency": [],
+            "granularity": "minute"
+        }
+
+
+__all__ = ['router']