Track Requests in Cloud Agent

The Requests tab tracks the asynchronous requests you submit in Cloud Agent, such as report downloads, on-demand scan submissions, and remote log collection. Use it to check the status of each request and to download or delete a completed report.

This feature has limited availability. To activate it for your subscription, contact your Technical Account Manager or Qualys Support.

What can you do with the Requests tab?

Before this tab existed, the Cloud Agent user interface gave you no way to track these actions. The tab now helps you with:

Track all submitted requests, request IDs, and processing status in one place.
Get instant confirmation of agent report download and on-demand scan progress.
Track any request to view processing details for an individual Cloud Agent.
Review agent-level information for on-demand scan progress and status.
Download an agent report from the Quick Actions menu.
Filter the requests you need by using the search tokens on the tab.

What does the Requests tab show?

Each row is one request you submitted. The following table describes the columns.

Column	Description
Request ID	Request ID for your on-demand scan or report downloads.
Requested Status	The current state of the request. A request in Processing is still running. A request in the Completed state has finished, and its output is ready.
File Format	The file format of the generated report, such as the format you selected when you submitted the request.
Operations	Request operations such as Processing, Successful, Failed, and Filtered.

View Scan Request Details

From the application selector, select Cloud Agent.
Go to the Requests tab.
Locate the request you want, and confirm that its status is Completed.
Select View Details from the Quick Actions menu. The Requests View page opens.

Currently, the Request tab only tracks Vulnerability Management on-demand scan requests. We will extend this scope to other scan types in our future releases.

Download a Completed Report

In the Cloud Agent user interface, navigate to the Agent Management.
Go to the Requests tab.
Locate the request you want to view details for. You can also search the request using search tokens.
Select Download from the Quick Actions menu. The report is downloaded on your machine.

Search and Filter Requests

Use the search field at the top of the Requests tab to narrow the list. The search field uses Qualys Query Language (QQL) tokens.

We introduced the following new tokens in the Requests tab to filter the report download and scan requests.

Search Token	Syntax	Description
request.requestType	`request.requestType:<request_type>` Valid values - AGENT_REPORT, ODS	Search the requests based on the request type, such as report download or on demand scan.
request.status	`request.status:<status_value>`	Search agent hosts based on the request status, such as Accepted, Completed, Error, and so on.