profiling-transaction-fingerprints

Analyze crdb_internal.transaction_statistics to identify high-retry transactions and contention patterns.

18|8|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/cockroachlabs/cockroachdb-skills --skill profiling-transaction-fingerprints
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: profiling-transaction-fingerprints
Source: https://github.com/cockroachlabs/cockroachdb-skills/tree/main/skills/observability-and-diagnostics/profiling-transaction-fingerprints
Command: npx skills add https://github.com/cockroachlabs/cockroachdb-skills --skill profiling-transaction-fingerprints

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Analyzing historical transaction performance to identify high-retry transactions, contention patterns, and commit latency issues using aggregated and sampled statistics from crdb_internal.transaction_statistics, enabling root-cause analysis without DB Console access.

Core Features & Use Cases

  • Transaction-level profiling to surface bursts of retries and latency, helping identify hot rows and contention hotspots.
  • Statement-level drill-down by linking transaction fingerprints to statement statistics to reveal problematic queries within high-retry transactions.
  • Resource and performance diagnostics by correlating retry/commit latency with network, memory, and disk usage metrics for optimization.

Quick Start

Execute a set of queries to surface top transaction fingerprints from the last 24 hours, then inspect their statement composition to pinpoint bottlenecks.

Frequently Asked Questions about profiling-transaction-fingerprints

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify high-retry transactions and contention patterns in CockroachDB?

Yes, you can pinpoint problematic queries within high-retry transactions by linking transaction fingerprints to statement statistics. This statement-level drill-down reveals which specific queries drive commit latency and contention hotspots.

Can I analyze transaction latency and retries without DB Console access?

You can analyze transaction latency and retries without DB Console access by querying crdb_internal.transaction_statistics directly. This enables historical transaction profiling and root-cause analysis for contention hotspots from your SQL client.

What is the best way to mitigate commit latency and contention hotspots in transaction fingerprints?

The best way to mitigate commit latency and contention hotspots involves analyzing transaction fingerprints to apply recommended mitigations such as batching, boundary tightening, or index and query optimizations, referencing appropriate documentation for deeper guidance.

How do I correlate transaction retry metrics with resource usage for performance diagnostics?

Correlate transaction retry and commit latency metrics with network, memory, and disk usage for performance diagnostics. This resource correlation helps identify hot rows and optimize overall transaction execution.

Does profiling transaction statistics over a historical window require specific dependencies?

Profiling transaction statistics over a historical window requires no external dependencies. It relies on querying the built-in crdb_internal.transaction_statistics table to surface top transaction fingerprints from your specified historical window.