Buckets:
AnonymousSpottedToad/candidate_bucket / codebase /python /CIRISAI_CIRISAgent /ciris_sdk /telemetry_responses.py
| """ | |
| Response models for telemetry API endpoints. | |
| These models provide type-safe alternatives to Dict[str, Any] return types. | |
| """ | |
| from __future__ import annotations | |
| from datetime import datetime | |
| from typing import Any, Dict, List, Optional | |
| from pydantic import BaseModel, ConfigDict, Field, field_serializer | |
| from .telemetry_models import MetricAggregate, MetricData, MetricTrend, ThoughtData | |
| class TelemetryOverviewResponse(BaseModel): | |
| """Response from telemetry overview endpoint.""" | |
| # Core metrics | |
| uptime_seconds: float = Field(..., description="System uptime") | |
| cognitive_state: str = Field(..., description="Current cognitive state") | |
| messages_processed_24h: int = Field(default=0, description="Messages in last 24h") | |
| thoughts_processed_24h: int = Field(default=0, description="Thoughts in last 24h") | |
| tasks_completed_24h: int = Field(default=0, description="Tasks completed in last 24h") | |
| errors_24h: int = Field(default=0, description="Errors in last 24h") | |
| # Resource usage | |
| tokens_per_hour: float = Field(default=0.0, description="Average tokens per hour") | |
| cost_per_hour_cents: float = Field(default=0.0, description="Average cost per hour in cents") | |
| carbon_per_hour_grams: float = Field(default=0.0, description="Carbon footprint per hour in grams") | |
| memory_mb: float = Field(default=0.0, description="Current memory usage MB") | |
| cpu_percent: float = Field(default=0.0, description="Current CPU percentage") | |
| # Service health | |
| healthy_services: int = Field(default=0, description="Number of healthy services") | |
| degraded_services: int = Field(default=0, description="Number of degraded services") | |
| error_rate_percent: float = Field(default=0.0, description="Error rate percentage") | |
| # Agent activity | |
| current_task: Optional[str] = Field(None, description="Current task description") | |
| reasoning_depth: int = Field(default=0, description="Current reasoning depth") | |
| active_deferrals: int = Field(default=0, description="Active deferrals") | |
| recent_incidents: int = Field(default=0, description="Recent incidents") | |
| model_config = ConfigDict(extra="allow") | |
| class DetailedMetric(BaseModel): | |
| """Detailed metric with trends and breakdowns.""" | |
| name: str = Field(..., description="Metric name") | |
| current_value: float = Field(..., description="Current value") | |
| unit: Optional[str] = Field(None, description="Unit of measurement") | |
| trend: MetricTrend = Field(..., description="Trend information") | |
| hourly_average: float = Field(default=0.0, description="Hourly average") | |
| daily_average: float = Field(default=0.0, description="Daily average") | |
| by_service: Dict[str, float] = Field(default_factory=dict, description="Values by service") | |
| recent_data: List[MetricData] = Field(default_factory=list, description="Recent data points") | |
| model_config = ConfigDict(extra="allow") | |
| class TelemetryMetricsResponse(BaseModel): | |
| """Response from metrics endpoint.""" | |
| metrics: List[DetailedMetric] = Field(..., description="Detailed metrics") | |
| summary: MetricAggregate = Field(..., description="Summary statistics") | |
| period: str = Field(..., description="Time period") | |
| model_config = ConfigDict(extra="allow") | |
| class ReasoningTrace(BaseModel): | |
| """Reasoning trace showing thought process.""" | |
| trace_id: str = Field(..., description="Unique trace ID") | |
| task_id: Optional[str] = Field(None, description="Associated task ID") | |
| task_description: Optional[str] = Field(None, description="Task description") | |
| start_time: datetime = Field(..., description="Start time") | |
| duration_ms: float = Field(..., description="Duration in milliseconds") | |
| thought_count: int = Field(default=0, description="Number of thoughts") | |
| decision_count: int = Field(default=0, description="Number of decisions") | |
| reasoning_depth: int = Field(default=0, description="Maximum reasoning depth") | |
| thoughts: List[ThoughtData] = Field(default_factory=list, description="Thought details") | |
| outcome: Optional[str] = Field(None, description="Trace outcome") | |
| def serialize_datetime(self, dt: Optional[datetime], _info: Any) -> Optional[str]: | |
| return dt.isoformat() if dt else None | |
| class TelemetryTracesResponse(BaseModel): | |
| """Response from traces endpoint.""" | |
| traces: List[ReasoningTrace] = Field(..., description="Reasoning traces") | |
| total_count: int = Field(..., description="Total matching traces") | |
| has_more: bool = Field(default=False, description="More traces available") | |
| model_config = ConfigDict(extra="allow") | |
| class LogEntry(BaseModel): | |
| """System log entry.""" | |
| timestamp: datetime = Field(..., description="Log timestamp") | |
| level: str = Field(..., description="Log level: DEBUG|INFO|WARNING|ERROR|CRITICAL") | |
| service: str = Field(..., description="Service name") | |
| message: str = Field(..., description="Log message") | |
| trace_id: Optional[str] = Field(None, description="Associated trace ID") | |
| context: Dict[str, str] = Field(default_factory=dict, description="Additional context") | |
| def serialize_datetime(self, dt: Optional[datetime], _info: Any) -> Optional[str]: | |
| return dt.isoformat() if dt else None | |
| class TelemetryLogsResponse(BaseModel): | |
| """Response from logs endpoint.""" | |
| logs: List[LogEntry] = Field(..., description="Log entries") | |
| total_count: int = Field(..., description="Total matching logs") | |
| has_more: bool = Field(default=False, description="More logs available") | |
| model_config = ConfigDict(extra="allow") | |
| class TelemetryQueryResult(BaseModel): | |
| """Result from a telemetry query.""" | |
| query_type: str = Field(..., description="Type of query executed") | |
| total_results: int = Field(..., description="Total results found") | |
| returned_results: int = Field(..., description="Results returned") | |
| execution_time_ms: float = Field(..., description="Query execution time") | |
| model_config = ConfigDict(extra="allow") | |
| class MetricsQueryResult(TelemetryQueryResult): | |
| """Result from metrics query.""" | |
| metrics: List[MetricData] = Field(..., description="Metric data") | |
| aggregations: Optional[MetricAggregate] = Field(None, description="Aggregated statistics") | |
| class TracesQueryResult(TelemetryQueryResult): | |
| """Result from traces query.""" | |
| traces: List[ReasoningTrace] = Field(..., description="Reasoning traces") | |
| class LogsQueryResult(TelemetryQueryResult): | |
| """Result from logs query.""" | |
| logs: List[LogEntry] = Field(..., description="Log entries") | |
| class IncidentData(BaseModel): | |
| """Incident information.""" | |
| incident_id: str = Field(..., description="Incident ID") | |
| timestamp: datetime = Field(..., description="Incident time") | |
| severity: str = Field(..., description="Severity: low|medium|high|critical") | |
| service: str = Field(..., description="Affected service") | |
| message: str = Field(..., description="Incident message") | |
| resolved: bool = Field(..., description="Whether resolved") | |
| resolved_at: Optional[datetime] = Field(None, description="Resolution time") | |
| def serialize_datetime(self, dt: Optional[datetime], _info: Any) -> Optional[str]: | |
| return dt.isoformat() if dt else None | |
| class IncidentsQueryResult(TelemetryQueryResult): | |
| """Result from incidents query.""" | |
| incidents: List[IncidentData] = Field(..., description="Incidents") | |
| class InsightData(BaseModel): | |
| """System insight.""" | |
| insight_id: str = Field(..., description="Insight ID") | |
| timestamp: datetime = Field(..., description="Generation time") | |
| category: str = Field(..., description="Insight category") | |
| title: str = Field(..., description="Insight title") | |
| description: str = Field(..., description="Detailed description") | |
| recommendations: List[str] = Field(default_factory=list, description="Recommendations") | |
| severity: str = Field(..., description="Severity: info|warning|critical") | |
| def serialize_datetime(self, dt: Optional[datetime], _info: Any) -> Optional[str]: | |
| return dt.isoformat() if dt else None | |
| class InsightsQueryResult(TelemetryQueryResult): | |
| """Result from insights query.""" | |
| insights: List[InsightData] = Field(..., description="System insights") | |
Xet Storage Details
- Size:
- 8.38 kB
- Xet hash:
- 74e1e4245b5f915092a57bcec2fcd76183cf55d21e684baed6795a9848c58649
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.