get_trends
Retrieve historical trend data for device CPU, memory, load, or uptime across selectable periods, returning time-series values with min, max, avg, and current statistics.
Instructions
Get historical trend data for device metrics.
Returns time-series data for CPU, memory, load, or uptime with statistics. Data comes from RRD files updated every 5 minutes by Observium polling.
RETURNS:
hostname, metric, period
datasources: What values are in the data (e.g., load1, load5, load15)
data_points: Number of samples
statistics: For each datasource - min, max, avg, current
data: Array of timestamped values (last 100 points)
METRICS:
load: System load average (load1, load5, load15)
cpu: CPU utilization percentage
memory: Memory usage percentage or bytes
uptime: System uptime in seconds
PERIODS: 1h, 6h, 1d (default), 1w, 1m
EXAMPLE QUESTIONS:
"What's the CPU trend on the server this week?"
"Show load average history for the firewall"
"What was peak memory usage this month?"
"How has uptime looked over the past week?"
TIP: Use list_available_metrics first to see what data exists for a device
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"hostname": "<hostname>"
},
"name": "get_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metric | No | Type of metric to retrieve | load |
| period | No | Time period for historical data | 1d |
| hostname | Yes | The device hostname | |
| device_id | No | The device ID |