Retrieve dashboard widget data
GET {{baseUrl}}/dashboards/:dashboardId/widgets/:widgetId?aid=1234&window=12h&startDate=2022-07-17T22:00:54Z&endDate=2022-07-18T22:00:54Z&max=10&cursor=bGFzdFJvdW5kSWQ9MTY4MTQxMDQ4MA&sort=alertStatus&order=asc
Returns the raw data displayed within a widget in the dashboard.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
aid | number | A unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response. | |
window | string | A dynamic time interval up to the current time of the request. Specify the interval as a number followed by an optional type: s for seconds (default if no type is specified), m for minutes, h for hours, d for days, and w for weeks. | |
For a precise date range, use startDate and endDate . | |||
startDate | string | Use with the endDate parameter. Include the complete time (hours, minutes, and seconds) in UTC time zone, following the ISO 8601 date-time format. See the example for reference. Please note that this parameter can't be used with window . | |
endDate | string | Defaults to current time the request is made. Use with the startDate parameter. Include the complete time (hours, minutes, and seconds) in UTC time zone, following the ISO 8601 date-time format. See the example for reference. Please note that this parameter can't be used with window . | |
max | number | Optionally specify the maximum number of objects to retrieve. This only applies to the Alert List and Test Table Widgets. |
- The default for the Alert List widget is set by its limitBy configuration.
- The default value for the Test Table widget is 10. |
|
cursor
| string | | An optional pagination cursor. This parameter should not not be used directly. Instead, use the_links
returned by the API. This feature is only available in the Test Table widget. | |sort
| string | | Optional sorting parameter with attributes listed comma-separated. This only applies to the Alert List and Test Table Widgets. - For the Alert List widget, you can sort by
alertStatus
orstartTime
. The default isalertStatus
. - For the Test Table widget, you can sort by
alertStatus
,testName
, ortestType
. The sequence might vary from the web application. The default sort attribute isalertStatus
. | |order
| string | | Optional sorting order parameter that accepts eitherasc
(ascending) ordesc
(descending) values. This only applies to the Alert List and Test Table Widgets. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"groupLabels":[{"groupProperty":"AGENT","groupLabels":[{"groupId":"2565","groupLabel":"San Francisco, CA"},{"groupId":"2565","groupLabel":"San Francisco, CA"}]},{"groupProperty":"AGENT","groupLabels":[{"groupId":"2565","groupLabel":"San Francisco, CA"},{"groupId":"2565","groupLabel":"San Francisco, CA"}]}],"binSize":3600,"data":{"cards":[{"cardId":"lrxxr","startDate":"2023-05-16T10:14:28Z","endDate":"2023-05-16T10:14:28Z","previousValue":500,"binSize":3600,"timestamp":1567620000,"numberOfDataPoints":24192,"value":100,"status":"No data","alertSuppressionWindows":[{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"},{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"}]},{"cardId":"lrxxr","startDate":"2023-05-16T10:14:28Z","endDate":"2023-05-16T10:14:28Z","previousValue":500,"binSize":3600,"timestamp":1567620000,"numberOfDataPoints":24192,"value":100,"status":"No data","alertSuppressionWindows":[{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"},{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"}]}],"columns":[{"columnId":"938to","binSize":3600,"points":[{"timestamp":1567620000,"numberOfDataPoints":23304,"value":100,"groups":[{"groupProperty":"COUNTRY","groupValue":"US"},{"groupProperty":"COUNTRY","groupValue":"US"}]},{"timestamp":1567620000,"numberOfDataPoints":23304,"value":100,"groups":[{"groupProperty":"COUNTRY","groupValue":"US"},{"groupProperty":"COUNTRY","groupValue":"US"}]}],"status":"No data","alertSuppressionWindows":[{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"},{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"}]},{"columnId":"938to","binSize":3600,"points":[{"timestamp":1567620000,"numberOfDataPoints":23304,"value":100,"groups":[{"groupProperty":"COUNTRY","groupValue":"US"},{"groupProperty":"COUNTRY","groupValue":"US"}]},{"timestamp":1567620000,"numberOfDataPoints":23304,"value":100,"groups":[{"groupProperty":"COUNTRY","groupValue":"US"},{"groupProperty":"COUNTRY","groupValue":"US"}]}],"status":"No data","alertSuppressionWindows":[{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"},{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"}]}],"points":[{"timestamp":1567620000,"numberOfDataPoints":23304,"value":100,"groups":[{"groupProperty":"COUNTRY","groupValue":"US"},{"groupProperty":"COUNTRY","groupValue":"US"}]},{"timestamp":1567620000,"numberOfDataPoints":23304,"value":100,"groups":[{"groupProperty":"COUNTRY","groupValue":"US"},{"groupProperty":"COUNTRY","groupValue":"US"}]}],"tests":[{"testId":"68256","testName":"Http Test Name","target":"www.google.com","testType":"Web - HTTP Server","alertCount":398,"isShared":true,"graphlets":[{"metric":"Availability","testId":"68257","points":[{"x":1580403900,"y":128.249},{"x":1580403900,"y":128.249}]},{"metric":"Availability","testId":"68257","points":[{"x":1580403900,"y":128.249},{"x":1580403900,"y":128.249}]}]},{"testId":"68256","testName":"Http Test Name","target":"www.google.com","testType":"Web - HTTP Server","alertCount":398,"isShared":false,"graphlets":[{"metric":"Availability","testId":"68257","points":[{"x":1580403900,"y":128.249},{"x":1580403900,"y":128.249}]},{"metric":"Availability","testId":"68257","points":[{"x":1580403900,"y":128.249},{"x":1580403900,"y":128.249}]}]}],"startRound":1384309800,"alertSuppressionWindows":[{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"},{"id":"281474976710662","name":"Test dashboards","testIds":["281474976710661"],"startTimes":["2023-05-16T10:14:28Z"],"durationInSeconds":7200,"repeat":"custom","repeatEvery":5,"repeatUnit":"week"}],"totalAlerts":500,"activeAlerts":483,"alerts":[{"alertId":"2004945","testId":"56512","ruleId":"281724","alertSource":"Http Test","alertRule":"Http Test Rule","alertType":"web-ftp-server","startTime":"2023-06-02T08:54:00Z","durationInSeconds":25,"active":true},{"alertId":"2004945","testId":"56512","ruleId":"281724","alertSource":"Http Test","alertRule":"Http Test Rule","alertType":"dns-trace","startTime":"2023-06-02T08:54:00Z","durationInSeconds":25,"active":true}],"summary":{"online":10,"offline":2,"disabled":3},"agents":[{"agentId":"6522","status":"online","ipInfo":{"publicIp":"172.58.92.31","privateIp":"172.58.92.31","ipv6":"incididunt laboris","operativeSystemVersion":"labore consequat dolor"},"agentName":"0c3898000117","location":{"latitude":37.77493,"longitude":-122.41942,"locationName":"San Francisco, California, US"}},{"agentId":"6522","status":"online","ipInfo":{"publicIp":"172.58.92.31","privateIp":"172.58.92.31","ipv6":"aute laborum irure tempor","operativeSystemVersion":"quis Duis pariatur elit"},"agentName":"0c3898000117","location":{"latitude":37.77493,"longitude":-122.41942,"locationName":"San Francisco, California, US"}}],"status":"No data"},"startDate":"2022-07-17T22:00:54Z","endDate":"2022-07-18T22:00:54Z","_links":{"previous":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"irure mollit aliqua aute","deprecation":"enim mollit","name":"Excepteur do amet enim","profile":"ut eu consectetur","title":"enim labore ullamco amet","hreflang":"qui ea ipsum adipisicing est"},"next":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"commodo enim","deprecation":"ut nisi ullamco","name":"Duis ipsum mollit","profile":"in non eiusmod cupidatat","title":"dolore fugiat enim ea","hreflang":"sunt cupida"},"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"officia aliqua consequat","deprecation":"ea sit ex id enim","name":"tempor dolore id ad","profile":"laboris sit enim dolore","title":"dolor Duis culpa occaecat voluptate","hreflang":"aliquip id in"}}}