Erweiterte Query Insights-Funktionen bieten Diagnosen zur Abfrageleistung sowie alle Funktionen, die in Standard-Query Insights verfügbar sind.
Mit den erweiterten Funktionen für Abfragestatistiken können Sie Probleme mit der Datenbank- und Abfrageleistung nahezu in Echtzeit erkennen, beheben und verhindern. Anhand der Query Insights-Daten der letzten sieben Tage können Sie die Abfrageleistung auf Anwendungsebene überwachen und die Quelle problematischer Abfragen im gesamten Anwendungsstack nach Aktion, Controller, Framework, Route, Anwendung und Datenbanktreiber nachvollziehen. Mit erweiterten Query Insights-Funktionen werden Abfragepläne für alle Abfragen erfasst und bis zu 20 Abfragepläne pro Minute als Stichprobe genommen.
Mit den erweiterten Query Insights-Funktionen können Sie die Ursachen von Problemen mit der Abfrageleistung proaktiv ermitteln und beheben. Dazu haben Sie folgende Möglichkeiten:
Führen Sie Ad-hoc-Analysen durch, um schwierige Probleme zu diagnostizieren. Verwenden Sie dazu echtzeitnahe Abfragestatistiken und Korrelationsanalysen für mehrere Dimensionen wie Nutzer, Hosts und Datenbanken.
Sehen Sie sich Ihren Abfrageausführungsplan mit vollständigen SQL-Anweisungen und begleitenden Kommentaren an. Sie können Kommentare zu einer Anfrage anzeigen lassen, sofern verfügbar.
Komplexe Leistungsprobleme beheben, indem Sie Telemetriedaten wie Warteereignisse analysieren. Ein Warteereignis ist eine Komponente, die eine Verzögerung bei der Verarbeitung eines anfragebezogenen Vorgangs verursacht. Messwerte für Warteereignisse sind standardmäßig aktiviert und helfen Ihnen, Leistungsprobleme bei zeitaufwendigen Abfragen und den zugehörigen Wartezeiten zu diagnostizieren und zu beheben.
Konfigurieren Sie die Einstellungen für Query Insights. Sie können beispielsweise die Abfragelängen anpassen, die Analyse von Warteereignissen aktivieren und Abfragekommentare und Anwendungstags speichern. Sie können auf Verlaufsdaten und Daten nahezu in Echtzeit zugreifen.
Analysieren Sie Daten für einen Zeitraum von bis zu 30 Tagen, um die langfristige Leistung zu sehen.
Vorteile erweiterter Query Insights-Funktionen
Die folgenden erweiterten Query Insights-Funktionen sind verfügbar, um Ihnen beim Erkennen und Beheben von Problemen mit der Abfrageleistung zu helfen:
Vordefinierte Dashboards, mit denen Sie Probleme bei der Abfrageleistung frühzeitig erkennen und Probleme auf einer einzigen Seite in der Google Cloud Konsole identifizieren, diagnostizieren und beheben können.
Visuelle Abfragepläne, mit denen Sie Ursachen ermitteln und Probleme beheben können. Mit dem kontextbezogenen End-to-End-Anwendungs-Tracing können Sie die Quelle einer problematischen Abfrage ermitteln.
Erkenntnisse basierend auf den Angeboten von Google Cloudfür Sicherheit, Datenschutz und Compliance auf Unternehmensebene, die den operativen Aufwand reduzieren können.
Anwendungsorientiertes Monitoring und vereinfachte Leistungsdiagnose von Anwendungen, die mit objektrelationalen Mappern (ORMs) erstellt wurden. Sie können die Datenbankleistung aus Sicht der Anwendung überwachen, indem Sie Abfragen mit Geschäftslogik taggen.
Sqlcommenter, eine Open-Source-Bibliothek, instrumentiert Ihre ORMs automatisch, um den Anwendungscode zu identifizieren, der Leistungsprobleme verursacht.
So funktionieren erweiterte Query Insights-Funktionen
Erweiterte Query Insights-Funktionen werden vollständig verwaltet. Sie müssen die Funktion also nicht installieren oder aktiv verwalten.
Für erweiterte Query Insights-Funktionen wird eine Erweiterung geladen, die Abfragemesswerte und Ausführungspläne aufzeichnet, die mithilfe von Hooks implementiert werden. Die Messwerte werden in AlloyDB-Tabellen und normalisierte Ausführungspläne in Cloud Trace gespeichert.
Sie können in der Google Cloud -Konsole auf der Seite „AlloyDB Query Insights“ auf diese Messwerte zugreifen. Messwerte sollten innerhalb von 30 Sekunden nach Abschluss der Abfrage in den erweiterten Query Insights-Funktionen verfügbar sein. Metriken werden genauso wie Datenbankspeicher verschlüsselt.
In erweiterten Query Insights-Funktionen werden nur normalisierte Abfragen gespeichert und angezeigt. Alle konstanten Werte aus dem Abfragestring werden entfernt. Abfragekommentare werden nur auf Anfrage beibehalten. Diese Funktion ist optional. Traces des Abfrageplans erfassen und speichern keine konstanten Werte.
Speicher
In erweiterten Query Insights-Funktionen werden nur normalisierte Abfragen gespeichert und angezeigt. Alle konstanten Werte aus dem Abfragestring werden entfernt. Traces des Abfrageplans erfassen und speichern keine konstanten Werte. Standardmäßig werden bei erweiterten Query Insights-Funktionen keine Tag-Informationen erfasst. Wenn sie später aktiviert werden, können sie in den erweiterten Query Insights-Funktionen pro Instanzeinstellung deaktiviert werden.
Das Dashboard Query Insights enthält Daten für vier Wochen. Der Speicherbedarf für Daten von sieben Tagen beträgt etwa 36 GB.
Erweiterte Query Insights-Funktionen verwenden bis zu 10 MB RAM (gemeinsamer Speicher). Messwerte sollten innerhalb von 30 Sekunden nach Abschluss der Abfrage in den Statistiken verfügbar sein. Außerdem sind Standardmesswerte für Query Insights in Systemmesswerten in Cloud Monitoring verfügbar, damit die Funktionen von Standard-Query Insights erhalten bleiben. Weitere Informationen zur Aufbewahrungsrichtlinie für Cloud Monitoring-Systemmesswerte finden Sie unter Datenaufbewahrung.
Traces aus erweiterten Query Insights-Funktionen werden in Cloud Trace gespeichert und haben einen Aufbewahrungszeitraum von 30 Tagen. Weitere Informationen zur Cloud Trace-Richtlinie zur Datenaufbewahrung finden Sie unter Kontingente und Limits.
Beschränkungen
Die von den erweiterten Query Insights-Funktionen bereitgestellten Messwerte sind nicht über eine Cloud Monitoring API verfügbar.
Die Unterstützung von Client-IP-Adressen ist nicht verfügbar.
Sie können die erweiterten Funktionen von Query Insights nicht für Cluster mit sekundären Instanzen aktivieren. Bevor Sie eine sekundäre Instanz in einem Cluster erstellen, müssen Sie die erweiterten Query Insights-Funktionen für alle Instanzen im Cluster deaktivieren.
In AlloyDB werden Daten zu Abfrage-Insights für die primären Instanzen und Lesepoolinstanzen 30 Tage lang gespeichert. Das Speichern von Daten für primäre Instanzen beansprucht etwa 180 GB und kann je nach Anzahl der Lesepoolknoten im Cluster zunehmen. Die maximal genutzte Speichergröße beträgt 700 GB.
Das Dashboard „Query Insights“ wird zurückgesetzt, nachdem Sie erweiterte Query Insights-Funktionen aktiviert haben. Sie können aber weiterhin über die UI des Metrics Explorers auf die Standardmesswerte für Query Insights zugreifen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-25 (UTC)."],[[["\u003cp\u003eAdvanced query insights features in AlloyDB for PostgreSQL provide real-time detection, troubleshooting, and prevention of database and query performance issues.\u003c/p\u003e\n"],["\u003cp\u003eThese features allow for in-depth analysis with near real-time query statistics, including correlation across dimensions like users, hosts, and databases, as well as detailed query execution plans.\u003c/p\u003e\n"],["\u003cp\u003eThe system offers prebuilt dashboards, visual query plans, and insights based on Google Cloud's security and privacy standards, enhancing problem identification and resolution.\u003c/p\u003e\n"],["\u003cp\u003eAdvanced query insights utilize an extension to record metrics and execution plans, which are stored in AlloyDB tables and Cloud Trace, respectively, with metrics available within 30 seconds of query completion.\u003c/p\u003e\n"],["\u003cp\u003eThe system has limitations such as the unavailability of metrics via Cloud Monitoring API, no support for client IP addresses, and the need to disable advanced query insights before creating secondary instances, alongside storage considerations.\u003c/p\u003e\n"]]],[],null,["# Advanced query insights features overview\n\nThis page describes advanced query insights features in AlloyDB for PostgreSQL. For information about setting up and using advanced query insights features, see [Improve query performance using advanced query insights features](/alloydb/docs/using-advanced-query-insights).\n\nAdvanced query insights features offer query performance diagnostics as\nwell as all of the features available in [standard query insights](/alloydb/docs/query-insights-overview).\n\nAdvanced query insights features let you detect, troubleshoot, and prevent database\nand query performance problems in near real time. Based on the previous seven\ndays of Query Insights data, you can monitor query performance at the\napplication level and trace the source of problematic queries across the\napplication stack by action, controller, framework, route, application, and\ndatabase driver. Advanced query insights features capture query\nplans for all queries and samples up to 20 query plans\nper minute.\n\nTo help you proactively identify and troubleshoot root causes of query\nperformance issues, advanced query insights features let you do the following:\n\n- Perform ad hoc analysis to diagnose difficult problems using near real-time query stats and correlation analysis across multiple dimensions like users, hosts, and databases.\n- View your query execution plan using complete SQL statements, along with accompanying comments. You can opt in to view comments associated with a query, where applicable.\n- Troubleshoot complex performance issues by analyzing telemetry, like wait events. A *wait event* is a component that causes a delay in processing a query-related operation. Wait event metrics, enabled by default, help you diagnose and debug performance issues for long-running queries and their associated wait times.\n- View [index advisor recommendations](/alloydb/docs/use-index-advisor-with-query-insights) about creating indexes.\n- Configure your query insight settings. For example, you can customize query lengths, enable wait event analysis, and store query comments and application tags. You can access historical and near real-time data.\n- Analyze data for up to a 30-day period for a long term performance view.\n\nBenefits of advanced query insights features\n--------------------------------------------\n\nThe following advanced query insights features are available to help you detect and\nfix query performance problems:\n\n- Prebuilt dashboards that help you identify query performance problems early and let you identify, diagnose, and resolve issues in a single page on the Google Cloud console.\n- Visual query plans that help you identify root causes and troubleshoot issues. You can trace the source of a problematic query with in-context, end-to-end application tracing.\n- Insights based on Google Cloud's enterprise security, privacy and compliance offerings, which might reduce operational overhead.\n- Application-centric monitoring and simplified performance diagnosis of applications built using object relational mappers (ORM). You can monitor database performance with an application-centric view by tagging queries with business logic. [Sqlcommenter](https://google.github.io/sqlcommenter/spec/), an open source library, auto-instruments your ORMs to help identify the application code causing performance problems.\n\nHow advanced query insights features work\n-----------------------------------------\n\nAdvanced query insights features are fully managed, which means you don't need to install\nor actively manage the feature.\n\nAdvanced query insights features load\nan extension that records query metrics and execution plans that are\nimplemented using hooks. The metrics are stored in AlloyDB\ntables, and normalized execution plans are stored in\n[Cloud Trace](/trace/docs).\n\nYou can access these metrics in\nthe AlloyDB Query Insights page of\nthe Google Cloud console. Metrics are expected to be available in\nadvanced query insights features within 30 seconds of query completion. Metrics are\nencrypted at rest in the same way as database storage.\n\nAdvanced query insights features store and display only normalized queries. All the\nconstant values from the query string are removed. Query comments are preserved\nonly on demand, it is an opt-in feature. Query plan traces don't collect and\nstore constant values.\n\n### Storage\n\nAdvanced query insights features store and display only normalized queries. All the\nconstant values from the query string are removed. Query plan traces don't\ncollect and store any constant values. By default, advanced query insights features don't collect tags information. If enabled at a later stage, they can be disabled\nfrom advanced query insights features per instance setting.\n\nThe **Query insights** dashboard provides four weeks of data. The storage\nrequirement for seven days' worth of data is approximately 36GB.\nAdvanced query insights features use up to 10 MB of RAM (shared memory). Metrics are\nexpected to be available in insights within 30 seconds of query completion. In\naddition, standard query insights metrics are available in system metrics in\nCloud Monitoring to keep the functionalities of the standard query insights\nintact. For\nmore information about the Cloud Monitoring system metrics retention policy,\nsee [Data retention](/monitoring/quotas#data_retention_policy).\n\nTraces from advanced query insights features are stored in Cloud Trace and have a 30-day\nretention period. For more information about the Cloud Trace data retention\npolicy, see\n[Quotas and limits](/trace/docs/quotas).\n\nLimitations\n-----------\n\n- The metrics exposed by advanced query insights features aren't available using a Cloud Monitoring API.\n- Client IP address support isn't available.\n- You cannot enable advanced query insights features on clusters with secondary instances. Before creating a secondary instance on a cluster, you must disable advanced query insights features on all the instances in the cluster.\n- AlloyDB stores query insights data for its primary and read pool instances for 30 days. Storing data for primary instances consumes about 180 GB and might increase based on the number of read pool nodes present in the cluster. The maximum consumed storage size is 700 GB.\n- You must [enable advanced query insights features](/alloydb/docs/using-advanced-query-insights#enable-advanced-query-insights) on a primary instance before enabling them on a read pool instance.\n- The query insights dashboard resets after you enable advanced query insights features. However, you can still access the standard query insights metrics using the [Metrics explorer UI](/monitoring/charts/metrics-explorer).\n\nWhat's next\n-----------\n\n- [Improve query performance using query insights](/alloydb/docs/using-advanced-query-insights).\n- Learn about [AlloyDB metrics](/monitoring/api/metrics_gcp_a_b#gcp-alloydb)."]]
