{"type":"api","title":"Get Severity Histogram","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/d2f02ba2-fd0d-3a26-bcc5-feafc8f24d17","info":{"title":"Monitoring and Troubleshooting","description":"Includes API operations for the following:\n- Real-time monitoring\n- Accessing statistics APIs and statistics bulk APIs\n- Retrieving device state\n- Managing alarms and events\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Monitoring - Events"],"description":"Get event severity histogram","operationId":"getSeverityHistogram","parameters":[{"name":"deviceId","in":"query","description":"Device system ip","required":true,"schema":{"type":"array","items":{"type":"string"}}},{"name":"query","in":"query","description":"Query","allowEmptyValue":true,"schema":{"type":"string"},"examples":{"Empty":{"description":"Empty"},"Get events filter by system ip":{"description":"Get events filter by system ip","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"system_ip","operator":"in","type":"string","value":["1.1.1.1"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerEventRequestFilterBySystemIp"},"Get events filter by site-id":{"description":"Get events filter by site-id","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"site_id","operator":"in","type":"string","value":["400","500"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerEventRequestFilterBySites"},"Get events filter by hours":{"description":"Get events filter by hours","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerEventRequestFilterByHours"},"Get events filter by severity":{"description":"Get events filter by severity","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"severity_level","operator":"in","type":"string","value":["critical"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerEventRequestFilterBySeverity"},"Get events filter between dates":{"description":"Get events filter between dates","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","type":"date","value":["2024-04-30T19:30:00 UTC","2024-05-30T17:30:00 UTC"],"operator":"between"}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerEventRequestFilterBetweenDates"},"Get events filter by type":{"description":"Get events filter by type","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"eventname","operator":"in","type":"string","value":["memory-usage"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerEventRequestFilterByType"}}},{"name":"site-id","in":"query","description":"Specify the site-id to filter the events","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","$$ref":"#/components/schemas/SeveritySummary"},"examples":{"Severity":{"description":"Severity","value":{"header":{"generatedOn":1718015805314,"viewKeys":{"uniqueKey":[],"preferenceKey":"grid-DeviceEvent_histogram"},"columns":[{"title":"Event Time","property":"entry_time","displayFormat":"DD MMM YYYY h:mm:ss A z","inputFormat":"unix-time","width":200,"dataType":"date"},{"title":"Count","property":"count","width":150,"dataType":"number"},{"title":"Severity","property":"severity_level","width":150,"dataType":"string"}],"fields":[{"property":"entry_time","dataType":"date"},{"property":"count","dataType":"number"},{"property":"severity_level","dataType":"string"}],"chart":{"xAxis":["entry_time"],"yAxis":["count"],"series":["severity_level"],"title":"view.chart.clientViewEventHistogram.events","xAxisLabel":"view.chart.clientViewEventHistogram.time","yAxisLabel":"view.chart.clientViewEventHistogram.count"}},"data":[{"entry_time":1718002800000,"severity_level":"major","count":32},{"entry_time":1718006400000,"severity_level":"major","count":96},{"entry_time":1718010000000,"severity_level":"major","count":96},{"entry_time":1718013600000,"severity_level":"major","count":56}]},"$$ref":"#/components/examples/ComViptelaVmanageServerEventResponseSeveritySummary"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"get","path":"/event/severity/summary"}}