Get Agent Metrics
GET /api/agents/metrics
Get comprehensive performance metrics for individual agents or all agents.
Retrieves detailed performance analytics including request counts, response times, success rates, performance scores, and specialization information for agent optimization and load balancing decisions.
Query Parameters:
agent_name: Optional specific agent name to get metrics for
Returns:
- AgentMetricsResponse: Single agent metrics when agent_name provided
- AllAgentMetricsResponse: System-wide metrics when no agent_name
Raises:
- HTTPException 500: For unexpected errors during metrics retrieval
Example Response (Single Agent):
{
"agent_id": "HAWKEN",
"agent_name": "HAWKEN",
"total_requests": 1250,
"successful_requests": 1225,
"failed_requests": 25,
"avg_response_time": 0.45,
"success_rate": 0.98,
"status": "online",
"performance_score": 0.95
}Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Responses
Section titled “ Responses ”Successful Response
Agent performance metrics response model.
Provides comprehensive performance metrics for a single agent including request statistics, success rates, response times, and operational status. Used for agent performance monitoring and analytics endpoints.
Fields:
agent_id: Unique agent identifier (e.g., “HAWKEN”, “LAGAN”)agent_name: Human-readable agent nametotal_requests: Total number of requests processed lifetimesuccessful_requests: Number of successfully completed requestsfailed_requests: Number of failed requestsavg_response_time: Average response time in secondssuccess_rate: Success rate as decimal (0.0-1.0, e.g., 0.98 = 98%)performance_score: Overall performance score (0.0-1.0, higher is better)status: Current operational status (online, offline, busy, error)capabilities: List of agent capabilities and specializationslast_used: ISO 8601 timestamp of last usagelast_activity: ISO 8601 timestamp of last activitymodel_used: AI model being used (e.g., “gpt-4”, “llama3”)specialization: Agent specialization area
Usage: GET /api/agent-communication/agents/{agent_id}/metrics returns this response model.
JSON Example:
{
"agentId": "hawken",
"agentName": "HAWKEN",
"totalRequests": 1542,
"successfulRequests": 1510,
"failedRequests": 32,
"avgResponseTime": 1.2,
"successRate": 0.98,
"performanceScore": 0.95,
"status": "online",
"capabilities": ["creative_writing", "storytelling"],
"lastUsed": "2025-01-31T10:30:00Z",
"lastActivity": "2025-01-31T10:30:00Z",
"modelUsed": "llama3",
"specialization": "creative_writing"
}object
ID of the agent being reported on
Agent name
Total number of requests processed
Number of successfully completed requests
Number of failed requests
Average response time in seconds
Success rate (0.0-1.0)
Performance score (0.0-1.0)
Current operational status (online, offline, busy, error)
List of agent capabilities and specializations
AI model being used
Agent specialization area
System-wide agent metrics response model.
Provides comprehensive performance metrics for all registered agents in the system. Returns metrics dictionary indexed by agent ID with total agent count for system-wide monitoring and analytics. Used by dashboards for fleet-wide performance overview.
Fields:
status: Operation status (success/error)metrics: Dictionary of agent metrics indexed by agent IDtotal_agents: Total number of agents with tracked metrics
Example:
{
"status": "success",
"metrics": {
"lorekeeper": {
"total_requests": 1250,
"avg_response_time": 2.45,
"success_rate": 0.976
},
"creative": {
"total_requests": 890,
"avg_response_time": 3.12,
"success_rate": 0.945
}
},
"total_agents": 12
}object
Operation status
Agent metrics by ID
object
Comprehensive agent performance metrics data.
Tracks individual agent performance including request counts, response times, success rates, and resource utilization for monitoring and optimization.
Fields: total_requests: Total requests handled by agent successful_requests: Number of successful requests failed_requests: Number of failed requests avg_response_time_ms: Average response time in milliseconds success_rate: Success rate as percentage (0.0-100.0) last_active: ISO timestamp of last activity current_load: Current workload level (0.0-1.0)
Used By: - AllAgentMetricsResponse.metrics - EnhancedAgentResponse.performance_metrics - Agent dashboards and monitoring
object
Total agents count
Validation Error