Running PromQL queries in Query Studio (Preview)
Note
Query Studio is currently available as a Preview feature at no additional charge. For supported regions, see Supported AWS Regions.
Query Studio is an interactive query environment in the CloudWatch console where you can write, run, and visualize PromQL queries against your CloudWatch metrics. You can use Query Studio to explore metrics ingested via OTLP and AWS vended metrics, create visualizations, set up alarms, and add widgets to your CloudWatch dashboards.
You can run PromQL queries programmatically using the CloudWatch API, or interactively in Query Studio.
Running a PromQL query in Query Studio
To run a PromQL query in Query Studio
-
Open the CloudWatch console
. -
In the navigation pane, choose Query Studio (Preview).
-
In the query editor tool, select PromQL from the drop-down menu.
-
Use the Builder mode to browse and select metric names, labels, and aggregation functions.
-
Or enter your PromQL query via the Editor mode, for example
{"http.server.active_requests"}. -
(Optional) Adjust the time range using the time interval selector at the top of the page.
-
Choose Run to execute the query and view the results.
Query Studio will display the results as a time series graph. You can switch between graph and table views to analyze your data.
Creating alarms from Query Studio
After running a PromQL query that returns a single time series, you can create a CloudWatch Alarm directly from Query Studio. Choose Create alarm from the actions menu to configure alarm thresholds, evaluation periods, and notification actions based on your query results. For more information, see Using PromQL in alarms.
Adding visualizations to dashboards
You can add any Query Studio visualization to a CloudWatch dashboard. After running a query and viewing the results, choose Add to dashboard to save the visualization as a dashboard widget. The widget continues to run the PromQL query at the dashboard's refresh interval, keeping your dashboard up to date.