Azure DevOps Data Stream Parameters

The Azure DevOps plugin provides configurable data streams to fetch build and release data and metrics.

Each configurable data stream exposes a set of parameters that lets you filter the data you retrieve. The following information describes the available configurable data streams and their parameters in detail.

Agent Pool Consumption (Microsoft-Hosted)

Parameter
Description
Report
Select how to display the results. Choose from:
  • Private: Show the usage alongside the concurrency.
  • Agent: Shows the usage within your project.

Agent Pool Consumption (Self-Hosted)

Parameter
Description
Report
Select how to display the results. Choose from:
  • Private: Show the usage alongside the concurrency.
  • Agent: Shows the usage within your project.

Agent Pool Diagnostic Logs

Parameter
Description
Log level
Select specific logs levels to return (Error, Warning, Info).
Operation
Choose specific operation types to return.

Analytics Query

Parameter
Description
Entity Type (Endpoint)
Specify the starting point of your query by selecting the Analytics entity (similar to a table) you want to pull data from.
This is the only required parameter, however if no additional query options are set then the API may return excessively large results and a warning will be issued.
Query
Enter your analytics query. Allows you to specify filtering, grouping, or sorting logic in OData query format to shape the dataset you retrieve.
Columns
Specify which fields (columns) to return from the chosen entity. Useful for limiting the response to only the data you need, improving performance and readability.
Top
Specify maximum number of records to return by the query, helping you manage data volume and performance.
Skip
Specify the number of records to tells the query to bypass before starting to return results. Often used in combination with Top to implement paging.

Analytics Query (Filter by Object)

Parameter
Description
Entity Type (Endpoint)
Specify the starting point of your query by selecting the Analytics entity (similar to a table) you want to pull data from.
This is the only required parameter, however if no additional query options are set then the API may return excessively large results and a warning will be issued.
Query
Enter your analytics query. Allows you to specify filtering, grouping, or sorting logic in OData query format to shape the dataset you retrieve.
Columns
Specify which fields (columns) to return from the chosen entity. Useful for limiting the response to only the data you need, improving performance and readability.
Top
Specify maximum number of records to return by the query, helping you manage data volume and performance.
Skip
Specify the number of records to tells the query to bypass before starting to return results. Often used in combination with Top to implement paging.

Build Commits

Parameter
Description
Limit results
Specify the maximum number of commits returned. Helps control data size by returning only the specified number of records. This field is mandatory.
Build result
Select the outcome of the associated build run to filter results by (e.g., Succeeded, Failed, Partially Succeeded). Use this to focus only on commits tied to specific build results.
Build status
Select the current state of the associated build run to filter results by (e.g., In Progress, Completed, Cancelling). Note that some statuses cannot be combined with results—for example, an In Progress build will not have a result yet.
Build trigger
Specify the event that initiated the build run (e.g., Continuous Integration, Manual, Scheduled) to filter associated commits by their trigger source.

Build Runs

Parameter
Description
Top
Specify the maximum number of build runs to return. Helps control data size and improve performance.
Trigger
Specify the event that initiated the build run (e.g., Continuous Integration, Manual, Scheduled) to filter results by trigger source.
Result
Specify the outcome of the build run (e.g., Succeeded, Failed, Partially Succeeded) to filter returned runs.
Status
Specify the current state of the build run (e.g., In Progress, Completed, Cancelling) to filter results. Some statuses cannot be combined with results—for example, an In Progress build will not have a result yet.
Build IDs
Specify a comma-separated list of build IDs to return only those matching build runs.
Branch
Specify the branch to filter build runs. The branch name must begin with the prefix refs/heads/ to function correctly.

Commits

Parameter
Description
Branch name
Specify the branch to filter commits. Defaults to the repository’s default branch if not specified. This parameter is relevant when using Repo(s) or Repo Folder(s) as your object.
Author
Specify the author to return only commits made by that user.
Top
Specify the maximum number of commits to return. Helps control data size and improve performance.

Pull Requests

Parameter
Description
Limit results
Specify the maximum number of pull requests to return. Helps control data size and improve performance.
Creator
Specify the user to return only pull requests created by that person.
Reviewer
Specify the user to return only pull requests where that person is a reviewer or has provided a review
Tag(s)
Specify one or more tags to return only pull requests associated with those tags.
Build status
Specify a build status to filter pull requests (e.g., based on the success or failure of linked builds).
Use timeframe
Select to enable filtering of pull requests by the tile timeframe. Activating this option also enables the Timeframe column field.
Timeframe column
Specify whether to filter by the pull request’s Created time or Closed time when Use timeframe is enabled.

Release Runs

If you experience timeouts with this data stream, try disabling Show tags, Show artifacts, and Show stages, as each adds additional API cost.

Parameter
Description
Limit results
Specify the maximum number of release runs to return. Useful when you only want the most recent release(s).
Status
Specify the status to filter release runs (e.g., Active, Abandoned, Completed).
Show stages
Enable the display of individual release stages and their statuses. Choose a column style:
  • Detail: Displays stage columns with headers that reflect stage names and shows statuses in the column cells.
  • Summary: Displays stage columns with numeric headers and shows statuses in the column cells. Useful when data includes releases with varying stages, as it significantly reduces the number of columns. Hover over a status cell to view the stage name.
Show artifacts
Enable display of the artifacts used in the release.
Show tags
Enable display of the release pipeline’s tags

WIQL Query

Parameter
Description
WIQL query
Specify a WIQL query to return work items for. For help with writing WIQL queries, see the following:

WIQL Query (Filter by Object)

Parameter
Description
WIQL query
Specify a WIQL query to return work items for. For help with writing WIQL queries, see the following:

Work Item Queries

Parameter
Description
Flatten
Select how non-flat queries should be handled.

Work Items

Parameter
Description
Limit results
Specify the maximum number of work items to return. Helps control data size and performance.
Type
Specify the work item type (e.g., Bug, Task, User Story) to filter results.
State
Specify the work item state (e.g., New, Active, Closed) to filter results.
Assigned to
Specify the name of an assignee to return only work items assigned to that user.
Area
Specify an area path to return only work items within that area.
Tags
Specify one or more tags to filter work items by associated labels.
Keyword
Specify keywords to filter work items by text matching in fields such as title or description.
Timeframe column
Specify which date column (e.g., Created Date, Closed Date) should be used when applying the tile timeframe filter. Only work items with dates that fall within the selected timeframe will be returned.

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket