- Console. On Cost, Kubernetes Efficiency, Financial Commitment, and Network Flow Reports, as well as Virtual Tag filter configurations and Saved Filters, you can view and edit VQL directly in the filter builder. On Resource Reports, you can view and copy VQL.
- API. On supported endpoints, such as
/cost_reports,/resource_reports,/financial_commitment_reports,/kubernetes_efficiency_reports, and/network_flow_log_reports, you can use VQL in thefilterparameter to programmatically create and fetch reports. - Terraform provider. In supported Terraform resources, such as
vantage_saved_filterorvantage_cost_report, you can use VQL for thefilterargument to create filtered Cost Reports or saved filters.
Edit VQL in the Console
On supported reports and filter configurations, you can edit VQL directly within the Vantage console. This allows you to modify filter logic as code—making it faster to adjust complex filters, reuse queries across reports and Virtual Tags, and iterate on cost analysis without rebuilding filters from scratch.1
Navigate to a supported report, such as a Cost Report, a Virtual Tag filter configuration, or a Saved Filter.
2
Open the Filters menu. Create a filter or view an existing one.
3
At the top of the Filters menu, click View as VQL to see the current filter represented in VQL.
4
Click Edit VQL. The VQL text becomes editable.
5
Modify the VQL query as needed. You can adjust filter conditions, add or remove criteria, or paste in VQL from another source, such as a different report or a Terraform configuration.
6
Click Apply. Vantage validates the query and updates the filter configuration. If the VQL contains errors, an error message is displayed, and the filter is not updated until the query is corrected.
To edit VQL in reports, you need editor or higher permissions and access to the report. To edit VQL in Virtual Tags, you must have the Owner role.
- API
- Terraform Provider
Key Concepts
VQL is based on the following key concepts, further described in subsequent sections.- Schema
- Keywords
- Syntax
VQL uses a schema that organizes filters into namespaces. These namespaces comprise various fields that you can leverage to filter and retrieve specific cost-related data.