All Products
Search
Document Center

PolarDB:Performance Insight

Last Updated:Mar 30, 2026

Performance insight helps you identify the root causes of database performance issues by analyzing active workloads on your PolarDB for PostgreSQL cluster. When your database experiences high load or latency, Performance insight shows you which SQL statements or session types are driving that load and guides you to the corrective action.

Performance insight is part of the diagnostics feature, which integrates capabilities from Database Autonomy Service (DAS).

How it works

Performance insight collects data based on your instance configuration:

  • If performance_schema is enabled, Performance insight collects and analyzes data from performance_schema.

  • If performance_schema is disabled, Performance insight collects and analyzes data from active sessions.

Prerequisites

Before you begin, ensure that you have:

Enable Performance insight

  1. Log on to the PolarDB console.

  2. In the upper-left corner, select the region where your cluster is deployed.

  3. On the Clusters page, click the ID of the cluster you want to manage.

  4. In the left-side navigation pane, choose Diagnostics and Optimization > Quick Diagnostics.

  5. Click the Performance Insight tab.

  6. Click Enable Performance Insight.

  7. In the dialog box that appears, click Confirm.

Understand the dashboard

After enabling Performance insight, the dashboard shows two sections:

Section What it shows How to use it
Performance Insight Time-series charts for metrics such as CPU utilization Select a time range to isolate an incident window; click Details in the upper-right corner of any metric to drill into that metric
Average Active Session A trend chart of active sessions broken down by session type Identify which session type dominated load during the incident window; view database workloads from multiple dimensions to identify root causes
Metric data is available for the latest seven days only.

Diagnose performance issues

Use the following workflow to move from a symptom to a root cause:

  1. Identify the incident window. In the Performance Insight section, select a time range and look for spikes or sustained elevation in metrics such as CPU utilization. Click Details on any metric to examine it in more detail.

  2. Identify the dominant session type. In the Average Active Session section, review the trend chart to find which session type accounts for the most load during the incident window.

  3. Narrow down the workload. In the Average Active Session section, view database workloads from multiple dimensions to isolate the specific sessions or queries driving the issue.

  4. Take corrective action. Based on your findings, address the identified session type or workload pattern.

Constraints

  • Metric data is available for the latest seven days. Data older than seven days is not accessible in the dashboard.