{"type":"api","title":"Get By Severities","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 alarms by severity","operationId":"getBySeverities","parameters":[{"name":"severity-level","in":"query","description":"Severity level","required":true,"schema":{"type":"array","items":{"type":"string"}},"examples":{"critical":{"description":"critical","value":"critical"},"major":{"description":"major","value":"major"},"minor":{"description":"minor","value":"minor"},"medium":{"description":"medium","value":"medium"}}},{"name":"deviceId","in":"query","description":"Device System IP","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":"array","properties":{"empty":{"type":"boolean"}},"items":{"type":"object","properties":{"component":{"type":"string","example":"System"},"details":{"type":"string","example":"host-name=vm12; user-name=admin; user-id=2276"},"entry_time":{"type":"string"},"eventname":{"type":"string","example":"system-login-change"},"host_name":{"type":"string","example":"vm12"},"severity_level":{"type":"string","enum":["MINOR","MAJOR","MEDIUM","CRITICAL"]},"system_ip":{"type":"string","example":"172.16.255.22"}},"$$ref":"#/components/schemas/EventsBySeverity"},"$$ref":"#/components/schemas/EventSeverityResponse"},"examples":{"Events":{"description":"Events","value":{"data":[{"entry_time":1717494474191,"system_ip":"172.16.255.11","eventname":"cpu-usage","host_name":"vm1","component":"System","severity_level":"minor","details":"host-name=vm1; cpu-status=usage-healthy; warning=System CPU usage is back to normal level (below 60%); cpu-1min-percentage=100; cpu-5min-percentage=59.00"},{"entry_time":1717494424040,"system_ip":"172.16.255.11","eventname":"cpu-usage","host_name":"vm1","component":"System","severity_level":"minor","details":"host-name=vm1; cpu-status=usage-notice; warning=System CPU usage is above 60%; cpu-1min-percentage=100; cpu-5min-percentage=68.00"},{"entry_time":1717494036440,"system_ip":"172.16.255.22","eventname":"security-root-cert-chain-installed","host_name":"vm12","component":"Security","severity_level":"minor","details":"host-name=vm12"},{"entry_time":1717494028056,"system_ip":"172.16.255.26","eventname":"security-root-cert-chain-installed","host_name":"vm16","component":"Security","severity_level":"minor","details":"host-name=vm16"},{"entry_time":1717493916930,"system_ip":"172.16.255.21","eventname":"dhcp-address-renewed","host_name":"vm11","component":"VPN","severity_level":"minor","details":"host-name=vm11; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:1f; ip=10.0.1.31"},{"entry_time":1717493882579,"system_ip":"172.16.255.16","eventname":"dhcp-address-renewed","host_name":"vm6","component":"VPN","severity_level":"minor","details":"host-name=vm6; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:10; ip=10.0.1.16"},{"entry_time":1717493881309,"system_ip":"172.16.255.20","eventname":"dhcp-address-renewed","host_name":"vm10","component":"VPN","severity_level":"minor","details":"host-name=vm10; vpn-id=0; if-name=eth0; client-mac=00:50:56:00:01:1e; ip=10.0.1.30"},{"entry_time":1717493517448,"system_ip":"172.16.255.22","eventname":"system-login-change","host_name":"vm12","component":"System","severity_level":"minor","details":"host-name=vm12; user-name=admin; user-id=-28374"},{"entry_time":1717493517448,"system_ip":"172.16.255.22","eventname":"system-login-change","host_name":"vm12","component":"System","severity_level":"minor","details":"host-name=vm12; user-name=admin; user-id=-28374"},{"entry_time":1717493018537,"system_ip":"172.16.255.26","eventname":"dhcp-address-renewed","host_name":"vm16","component":"VPN","severity_level":"minor","details":"host-name=vm16; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:24; ip=10.0.1.36"},{"entry_time":1717493018537,"system_ip":"172.16.255.26","eventname":"dhcp-address-renewed","host_name":"vm16","component":"VPN","severity_level":"minor","details":"host-name=vm16; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:24; ip=10.0.1.36"},{"entry_time":1717492082508,"system_ip":"172.16.255.16","eventname":"dhcp-address-renewed","host_name":"vm6","component":"VPN","severity_level":"minor","details":"host-name=vm6; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:10; ip=10.0.1.16"},{"entry_time":1717491129726,"system_ip":"172.16.255.15","eventname":"cpu-usage","host_name":"vm5","component":"System","severity_level":"minor","details":"host-name=vm5; cpu-status=usage-healthy; warning=System CPU usage is back to normal level (below 60%); cpu-1min-percentage=42.00; cpu-5min-percentage=59.00"},{"entry_time":1717491119767,"system_ip":"172.16.255.15","eventname":"cpu-usage","host_name":"vm5","component":"System","severity_level":"minor","details":"host-name=vm5; cpu-status=usage-notice; warning=System CPU usage is above 60%; cpu-1min-percentage=50.00; cpu-5min-percentage=61.00"},{"entry_time":1717491109539,"system_ip":"172.16.255.15","eventname":"cpu-usage","host_name":"vm5","component":"System","severity_level":"minor","details":"host-name=vm5; cpu-status=usage-healthy; warning=System CPU usage is back to normal level (below 60%); cpu-1min-percentage=41.00; cpu-5min-percentage=60.00"},{"entry_time":1717490271278,"system_ip":"172.16.255.15","eventname":"dhcp-address-renewed","host_name":"vm5","component":"VPN","severity_level":"minor","details":"host-name=vm5; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:0f; ip=10.0.1.15"},{"entry_time":1717488474843,"system_ip":"172.16.255.19","eventname":"dhcp-address-renewed","host_name":"vm9","component":"VPN","severity_level":"minor","details":"host-name=vm9; vpn-id=0; if-name=eth0; client-mac=00:50:56:00:01:13; ip=10.0.1.19"},{"entry_time":1717488471237,"system_ip":"172.16.255.15","eventname":"dhcp-address-renewed","host_name":"vm5","component":"VPN","severity_level":"minor","details":"host-name=vm5; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:0f; ip=10.0.1.15"},{"entry_time":1717488462547,"system_ip":"172.16.255.14","eventname":"dhcp-address-renewed","host_name":"vm4","component":"VPN","severity_level":"minor","details":"host-name=vm4; vpn-id=512; if-name=eth0; client-mac=00:50:56:00:01:0e; ip=10.0.1.14"},{"entry_time":1717483994936,"system_ip":"172.16.255.22","eventname":"dhcp-address-renewed","host_name":"vm12","component":"VPN","severity_level":"minor","details":"host-name=vm12; vpn-id=0; if-name=eth0; client-mac=00:50:56:00:01:20; ip=10.0.1.32"}]},"$$ref":"#/components/examples/ComViptelaVmanageServerEventResponseSeverity"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Events-read","method":"get","path":"/event/severity"}}