Skip to content

Agent Trends

GET
/api/agent-status/trends

All agents’ performance trends for the given time period.

days
Days

Trend analysis period in days

integer
default: 7 >= 1 <= 30

Trend analysis period in days

Successful Response

Response Agent Trends Api Agent Status Trends Get
object
key
additional properties
object
key
additional properties
AgentTrendsResult

Type-safe agent trends result structure.

Returned by get_agent_trends() with full trend analysis data.

Fields: agent_name: Name of analyzed agent time_period_days: Analysis time period current_metrics: Current metrics snapshot trends: Dict of trend indicators recommendations: List of optimization suggestions

object
agent_name
required
Agent Name
string
time_period_days
required
Time Period Days
integer
current_metrics
required
AgentMetricsData

Type-safe agent metrics data structure.

Provides full type safety for agent performance metrics throughout the MetricsManager service. All fields are optional (total=False) to support partial updates while maintaining type safety.

Fields: total_requests: Count of all requests processed avg_response_time: Average response time in seconds success_rate: Ratio of successful requests (0.0-1.0) last_used: ISO timestamp of most recent request (nullable) performance_score: Weighted score (60% success + 40% speed) error_count: Count of failed requests successful_requests: Count of successful requests response_times: Rolling history of response times created_at: ISO timestamp of metrics creation last_updated: ISO timestamp of last metrics update

object
total_requests
Total Requests
integer
avg_response_time
Avg Response Time
number
success_rate
Success Rate
number
last_used
Any of:
string
performance_score
Performance Score
number
error_count
Error Count
integer
successful_requests
Successful Requests
integer
response_times
Response Times
Array<number>
recent_outcomes
Recent Outcomes
Array<boolean>
request_timestamps
Request Timestamps
Array<number>
created_at
Created At
string
last_updated
Last Updated
string
current_load
Current Load
number
trends
required
TrendAnalysis

Type-safe trend analysis structure.

Used in get_agent_trends() to provide trend indicators.

Fields: response_time_trend: Trend indicator for response time success_rate_trend: Trend indicator for success rate usage_trend: Trend indicator for usage

object
response_time_trend
required
Response Time Trend
string
success_rate_trend
required
Success Rate Trend
string
usage_trend
required
Usage Trend
string
recommendations
required
Recommendations
Array<string>

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object