Skip to main content
The Row-Level TTL metrics let you monitor the performance of your . To view these graphs, select a cluster from the , and click Metrics in the Monitoring section of the left side navigation. On the Metrics page, click the Row-Level TTL tab.

Time interval selection

The time interval selector at the top of each tab allows you to filter the view for a predefined or custom time interval. Use the navigation buttons to move to the previous, next, or current time interval. When you select a time interval, the same interval is selected for all charts on the Metrics page.

Row-Level TTL Jobs

Short NameCockroachDB Metric NameDescriptionUsage
Resume Completedjobs.row\_level\_ttl.resume\_completedNumber of row_level_ttl jobs which successfully resumed to completionIf Row Level TTL is enabled, this metric should be nonzero and correspond to the ttl_cron setting that was chosen. If this metric is zero, it means the job is not running
Runningjobs.row\_level\_ttl.currently\_runningNumber of row_level_ttl jobs currently running in Resume or OnFailOrCancel stateMonitor this metric to ensure there are not too many Row Level TTL jobs running at the same time. Generally, this metric should be in the low single digits.
Pausedjobs.row\_level\_ttl.currently\_pausedNumber of row_level_ttl jobs currently considered PausedMonitor this metric to ensure the Row Level TTL job does not remain paused inadvertently for an extended period.
Resume Failedjobs.row\_level\_ttl.resume\_failedNumber of row_level_ttl jobs which failed with a non-retriable errorThis metric should remain at zero. Repeated errors means the Row Level TTL job is not deleting data.
Failed Schedulesschedules.scheduled-row-level-ttl-executor.failedNumber of scheduled-row-level-ttl-executor jobs failedMonitor this metric to ensure the Row Level TTL job is running. If it is non-zero, it means the job could not be created.

Processing Rate

Short NameCockroachDB Metric NameDescriptionUsage
Rows selectedjobs.row\_level\_ttl.rows\_selectedNumber of rows selected for deletion by the row level TTL job.Correlate this metric with the metric jobs.row_level_ttl.rows_deleted to ensure all the rows that should be deleted are actually getting deleted.
Rows deletedjobs.row\_level\_ttl.rows\_deletedNumber of rows deleted by the row level TTL job.Correlate this metric with the metric jobs.row_level_ttl.rows_selected to ensure all the rows that should be deleted are actually getting deleted.

Estimated Rows

Short NameCockroachDB Metric NameDescriptionUsage
Total Rowsjobs.row\_level\_ttl.total\_rowsApproximate number of rows on the TTL table.See Description.
Expired Rowsjobs.row\_level\_ttl.total\_expired\_rowsApproximate number of rows that have expired the TTL on the TTL table.See Description.

Row-Level TTL Job Latency

Short NameCockroachDB Metric NameDescriptionUsage
Select Latency (P90), Select Latency (P99)jobs.row\_level\_ttl.select\_durationDuration for select requests during row level TTL.See Description.
Delete Latency (P90), Delete Latency (P99)jobs.row\_level\_ttl.delete\_durationDuration for delete requests during row level TTL.See Description.

See also