list_alerts
Retrieve Observium alerts with status and details to troubleshoot device, port, and sensor issues; filter active or recovered alerts for monitoring.
Instructions
List alerts from Observium with status and details.
Returns active or historical alerts including device down, port down, and sensor threshold violations. Use for troubleshooting and monitoring.
RETURNS: Array of alerts with:
alert_id: Unique identifier
hostname: Affected device
alert_name: Type of alert
entity_type: What triggered it (device, port, sensor)
entity_name: Specific entity affected
status: active or recovered
timestamp: When alert was raised
duration: How long alert has been active
ALERT TYPES:
Device alerts: Device down, device rebooted
Port alerts: Port down, port errors, port utilization
Sensor alerts: Temperature high, voltage out of range
EXAMPLE QUESTIONS:
"Are there any active alerts?"
"What alerts fired this week?"
"Show me all recovered alerts"
"What's alerting on the switch?"
NEXT STEPS: Use get_alert_summary for overview, or investigate with get_device/list_sensors
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_alerts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum alerts to return (default: 50, max: 500) | |
| status | No | Filter by alert status | active |
| hostname | No | Filter by device hostname | |
| device_id | No | Filter by device ID |