NestJS Enterprise Backend APIs · Lesson

Database Performance Monitoring

Utilize Supabase tools and PostgreSQL features to monitor database performance, identify bottlenecks, and track key metrics.

Database Performance Monitoring is a free NestJS Enterprise Backend APIs lesson on CoddyKit — lesson 2 of 6. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the NestJS Enterprise Backend APIs learning path, one of 6 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Why Monitor Database Performance?

Imagine your app suddenly feels slow. Users are complaining, and operations are timing out. Database performance monitoring is your diagnostic tool!

It helps you:

Identify slow queries causing bottlenecks.
Understand resource usage (CPU, RAM).
Prevent outages by spotting issues early.
Optimize your database for speed and efficiency.

Key Performance Indicators (KPIs)

To monitor effectively, you need to know what to look for. These are your key performance indicators:

CPU Usage: How much processing power your database is using. High CPU can mean complex queries or too many connections.
Memory Usage: How much RAM is consumed. Excessive usage can lead to slower disk I/O.
Disk I/O: The rate at which data is read from and written to disk. High I/O can indicate inefficient queries or missing indexes.
Active Connections: The number of clients currently connected to your database. Too many can overwhelm the server.
Query Latency: The time it takes for queries to execute. This directly impacts user experience.

Supabase Dashboard: Metrics Overview

Supabase provides built-in monitoring tools right in your project dashboard. Navigate to the 'Metrics' section to see a high-level overview of your database's health.

Here you'll find graphs and charts for CPU, memory, network, and disk usage. This is your first stop for a quick health check!

Dashboard: Resource Graphs Deep Dive

The 'Metrics' section details historical performance. Look for:

CPU Usage: Spikes often correlate with heavy query loads.
Memory Usage: A steady increase might indicate memory leaks or inefficient caching.
Disk I/O: High read/write activity can point to queries scanning large tables without proper indexes.
Network Usage: Shows data transfer in and out, useful for understanding client-server communication load.

Analyzing trends over time helps you understand normal behavior and spot anomalies.

Dashboard: Query Performance Insights

Beyond resource graphs, the Supabase dashboard often includes a 'Query Performance' or 'Insights' section. This tool is invaluable for identifying your slowest queries.

It aggregates data on query execution times, frequency, and total time spent. This allows you to quickly pinpoint which SQL statements are consuming the most resources and need optimization.

PostgreSQL: pg_stat_activity

For real-time insights into what your database is doing *right now*, you can use PostgreSQL's pg_stat_activity view. It shows every active connection and the query it's currently running (or waiting on).

This is great for spotting long-running queries or connections that are idle in transaction.

SELECT
  pid,
  datname,
  usename,
  state,
  query_start,
  query
FROM pg_stat_activity
WHERE state = 'active'
ORDER BY query_start DESC;

PostgreSQL: pg_stat_statements

While pg_stat_activity is for real-time, pg_stat_statements helps you track *historical* aggregated statistics for all executed queries. It's an extension that you enable.

It records metrics like total execution time, call count, and standard deviation for each unique query, making it perfect for finding consistently slow queries over time.

Enabling and Using pg_stat_statements

To use pg_stat_statements, you first need to enable it in your Supabase project's database settings (under Extensions) or via SQL in the SQL Editor.

After enabling, run some queries, then query the view to see the stats:

CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

SELECT
  query,
  calls,
  total_time,
  mean_time,
  stddev_time
FROM pg_stat_statements
ORDER BY total_time DESC
LIMIT 10;

Interpreting pg_stat_statements Results

When examining pg_stat_statements output, focus on:

total_time: Queries with the highest total execution time are your primary targets for optimization.
mean_time: High average execution time indicates a consistently slow query.
calls: A frequently called query, even if fast, can contribute significantly to overall load if its total_time is high.

Use these insights to identify which queries need attention, perhaps by adding indexes or rewriting them.

Monitoring Tools Check

You've learned about various tools and metrics for monitoring your Supabase database. Let's test your knowledge!

Recap: Keeping Your Database Healthy

In this lesson, we explored how to monitor your Supabase database's performance. We covered:

The importance of monitoring and key KPIs like CPU, memory, and query latency.
Utilizing the Supabase Dashboard's Metrics and Query Performance sections.
Leveraging powerful PostgreSQL views like pg_stat_activity for real-time insights.
Implementing and interpreting pg_stat_statements for historical query analysis.

Regular monitoring helps you proactively maintain a fast and responsive application. Next up, we'll dive into optimizing those slow queries!

Frequently asked questions

Is the “Database Performance Monitoring” lesson free?

Yes — the full text of “Database Performance Monitoring” is free to read here on the web, and the NestJS Enterprise Backend APIs course includes 6 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the NestJS Enterprise Backend APIs course, upgrade to CoddyKit PRO.

What will I learn in “Database Performance Monitoring”?

Utilize Supabase tools and PostgreSQL features to monitor database performance, identify bottlenecks, and track key metrics. You practise NestJS Enterprise Backend APIs with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start NestJS Enterprise Backend APIs?

No prior experience is required. NestJS Enterprise Backend APIs on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 6, so you can start here or from the beginning and move at your own pace.

How long does the “Database Performance Monitoring” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this NestJS Enterprise Backend APIs lesson?

Yes. Every NestJS Enterprise Backend APIs lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to NestJS Enterprise Backend APIs