Query Insights overview

This page gives an overview of the Query Insights tool. To start using the tool now, see Improve query performance by using Query Insights.


Query Insights helps you detect, diagnose, and prevent query performance problems for AlloyDB databases. It provides self-service, intuitive monitoring, and diagnostic information that goes beyond detection to help you to identify the root cause of performance problems.

With Query Insights, you can monitor performance at an application level and trace the source of a problematic query across the application stack by model, view, controller, route, user, and host. The Query Insights tool can integrate with your existing application monitoring (APM) tools and Google Cloud services using open standards and APIs. This way, you can monitor and troubleshoot query problems using your favorite tool.

You view metrics for queries on the Query Insights dashboard. The dashboard provides a series of filters that help you view database load for queries by user, database, IP address, time range, CPU capacity, CPU and CPU wait, IO Wait, and Lock Wait.

Benefits of using Query Insights

Query Insights provides monitoring and diagnostics that let you detect and fix query performance problems. Query Insights dashboards help you identify query performance problems early and let you move from detection to resolution using a single interface. Built-in, visual query plans assist you in troubleshooting issues to find the root cause. You can also use in-context, end-to-end application tracing to find the source of a problematic query.

Query Insights enables you to tag queries with business logic that the query is associated with, such as payment, inventory, business analytics, or shipping so that you can monitor query performance from an application-centric perspective. Also, Query Insights provides application-centric monitoring that helps you diagnose performance problems for applications built using object-relational mappings (ORMs). The Query Insights tool uses SQL Commenter, an open source library, to automatically instrument your ORMs. This instrumentation helps you identify which application code is causing problems.

Query Insights can integrate with your existing APM tools, letting you monitor and troubleshoot query problems using your favorite tool. Query Insights supports the OpenCensus and OpenTelemetry standards and makes the query metrics and traces data available for your APM tools through the Google Cloud Observability API. Query Insights integrates with Cloud Monitoring, letting you create custom dashboards and alerts on query metrics or tags and receive notifications using email, SMS, Slack, PagerDuty, and more.


There is no additional cost for this feature. You can access one week of data on the Query Insights dashboard. For API requests, see the Cloud Monitoring Pricing. Cloud Monitoring has a tier you can use at no additional cost.


Users who have access to the AlloyDB dashboard can access Query Insights metrics on the Query Insights dashboard.

Query Insights metrics are encrypted at rest.


Query Insights stores and displays only normalized queries. All the constant values from the query string are removed. Query plan traces do not collect or store any constant values. By default, Query Insights collects IP addresses and tag information.


Query Insight's PostgreSQL extension records query metrics and execution plans implemented using postgres hooks. The metrics, and execution plans, are stored as a postgres table in a shared memory table. By avoiding using expensive Disk IO operations, Query Insights is always on, and its performance overhead is expected to be small. Query Insights uses 12 MB of RAM for a default query string size of 1024 bytes. RAM usage increases with an increase in the query string size. Metrics are expected to be available in Query Insights within minutes of query completion.


Query Insights does not occupy any storage space in your AlloyDB instance storage space. Metrics are stored in system metrics in Cloud Monitoring. It's important to review the Cloud Monitoring data retention policy.

Query Insights traces are stored in Cloud Trace. It's important to review the Cloud Trace data retention policy.


Query Insights is supported on all AlloyDB machine types and available on all Google Cloud Platform regions.

What's Next