Skip to content
Telemetry
For teams connecting application failures and latency to database behavior

Database reliability monitoring with SQL

Track safe query fingerprints, pool pressure, transaction rollbacks, lock contention, replication lag, and migration outcomes without collecting raw SQL parameters.

Reviewed by the Telemetry product team on . We checked the event fields, suggested queries, and data to exclude. Who reviews this page

Why this works
  • Connect database symptoms to the service, release, and workflow that users experience.
  • Keep pool wait, query duration, lock wait, and replication delay as separate phases.
  • Use normalized operation labels and controlled errors instead of raw statements, parameters, or connection details.
How to test this use case

Measure Database reliability monitoring with SQL and check the results

To measure database reliability monitoring with sql, choose one workflow and its owner. Define the events, test them with known inputs, and write a query that answers a specific question.

  1. 1

    Choose when to log

    Choose one database-dependent workflow and define its safe operation fingerprints.

  2. 2

    Capture the outcome

    Begin with database_query_completed, database_pool_sampled, database_transaction_completed and document the grain of each event.

  3. 3

    Check the stored rows

    Review rates and thresholds with the database owner before enabling alerts.

  4. 4

    Make the decision

    Which normalized database operations are slow most often?

Use case versus template

Choose what to measure

Use this guide to choose what to measure and when to log it. For a shorter setup prompt, open the matching template.

Open Database reliability monitoring template

Agent prompt

Paste this into your coding agent

Replace YOUR_API_KEY after signup, then ask the agent to run the product flow and verify the first events.

agent prompt

Database reliability monitoring with SQL setup prompt

text
Instrument database reliability with Telemetry.

Use /skill.md and this Telemetry API key: YOUR_API_KEY

Add structured events around the application's database boundary for:
1. Completed queries with query_fingerprint, service, database_name, status, duration_ms, rows_returned, release, and environment.
2. Connection-pool samples with active_connections, idle_connections, max_connections, waiting callers, acquisition wait, and timeout outcome.
3. Terminal transactions with transaction_id, status, controlled error_type, duration_ms, and workflow context.
4. Lock waits, replication or CDC lag, and migration outcomes where the application already has an approved signal.

Create a dashboard for slow-query rate, pool wait rate, transaction rollback rate, lock waits, replication lag, and migration failures. Add alerts only after minimum volume and sustained-duration thresholds are reviewed.

Do not log raw SQL parameters, unrestricted statement text, connection strings, credentials, database error dumps, or customer records.

Setup steps

  1. 1Choose one database-dependent workflow and define its safe operation fingerprints.
  2. 2Add events to the database wrapper, connection pool, transaction commits and rollbacks, and migration job.
  3. 3Send synthetic success, timeout, rollback, lock-wait, and lag examples.
  4. 4Review rates and thresholds with the database owner before enabling alerts.

Events to capture

database_query_completeddatabase_pool_sampleddatabase_transaction_completeddatabase_lock_wait_observeddatabase_replication_sampleddatabase_migration_completed

Questions you can answer

  • Which normalized database operations are slow most often?
  • Which pools make callers wait or time out?
  • Did a release change rollback, lock, migration, or replication behavior?

Example event schemas

Check what each event records, when to send it, and which field types it needs. Review the example payload and privacy checklist before using it in production.

Use these queries in Telemetry

Learn about SQL query API

Run read-only DataFusion SQL over structured-event tables and reuse the result.

Related SQL recipes

More SQL recipes

Run the query using this workflow's event fields and check the example result. Save the result to a dashboard or set up an alert.

Browse all recipes
Database reliabilityIntermediate

Detect N+1 database query patterns

Which route and query combinations repeat suspiciously within a request?

Open recipe
Database reliabilityBeginner

Find slow database queries by fingerprint

Which database operations are consistently slow enough to investigate?

Open recipe
Database reliabilityBeginner

Measure database connection-pool saturation

Which application pools are making callers wait for a database connection?

Open recipe
Database reliabilityIntermediate

Calculate database transaction rollback rate

Which services roll back an unusual share of database transactions?

Open recipe
Database reliabilityIntermediate

Find database lock waits and deadlocks

Which database operations create the most serious lock contention?

Open recipe
Database reliabilityBeginner

Measure database replication and CDC lag

Which replicas or CDC consumers are falling behind their source database?

Open recipe
Database reliabilityBeginner

Track database migration failures by release

Which releases contain failed or rolled-back database migrations?

Open recipe
Database reliabilityBeginner

Rank database queries by total time impact

Which database operation consumes the most cumulative request time?

Open recipe
Database reliabilityIntermediate

Measure long-running database transactions

Which application transaction classes remain open the longest?

Open recipe
Database reliabilityBeginner

Analyze database errors by SQLSTATE and release

Which database error classes increased after an application release?

Open recipe
Database reliabilityIntermediate

Measure database connection timeouts and churn

Which services and regions show unhealthy database connection churn?

Open recipe
Database reliabilityAdvanced

Measure database replica staleness by region

Which replica regions are serving stale or failed reads?

Open recipe
Recipe collectionsDatabase reliability SQL

Customer evidence

Related customer stories

Next step

Create the API key your agent will use

The free plan is enough to run the prompt, send test events, and review the first dashboard.

Related pages