All Products
Search
Document Center

Tair (Redis® OSS-Compatible):Latency insights

Last Updated:Mar 28, 2026

Latency insights is a CloudDBA feature that tracks execution time across all Redis commands and up to 27 internal events in a Tair (Redis OSS-compatible) instance. Statistics are accurate to the microsecond and retained for three days, making it useful for both real-time diagnosis and retrospective analysis of latency spikes.

How it works

Redis 2.8.13 introduced built-in latency monitoring. It covers a limited set of events, retains data for only 160 seconds, and stores just one record per second (the highest-latency event).

Latency insights extends this with:

  • Persistence — data is stored for three days and latency spikes are traceable across that window

  • High precision — full events are monitored within milliseconds

  • Low overhead — implemented asynchronously with minimal impact on instance performance

  • Real-time queries — data is available for immediate query and aggregation

  • Multiple analysis dimensions — slice data by event type, time range, or latency value

Only commands and events that exceed a defined threshold are recorded. Thresholds vary by event type (30 ms, 50 ms, or 100 ms). See Appendix: Common special events for the full list.

Prerequisites

Before you begin, ensure that:

  • The instance minor version meets the minimum requirement for your edition: For instructions on updating a minor version, see Update the minor version of an instance.

    EditionMinimum minor versionNotes
    Tair (Enterprise Edition) memory-optimized1.6.9For Tair module command statistics, use 1.7.28 or later
    Redis Open-Source Edition 5.05.1.4
    Redis Open-Source Edition 6.00.1.15
    Redis Open-Source Edition 7.07.0.0.6

Billing

Latency insights is free of charge.

View latency statistics

  1. Log on to the console and go to the Instances page. In the top navigation bar, select the region where your instance is deployed. Find the instance and click its ID.

  2. In the left navigation pane, click CloudDBA > Latency Insights.

  3. On the Latency Insights page, select a time range and click Search. The default view shows statistics from the last 5 minutes. Queries can span up to three days of data, but a single query cannot cover more than one hour. For cluster and read/write splitting instances, use the Data Node and Proxy Node tabs to view statistics separately by node type.

  4. Click an event name or a count in the list to open its latency trend chart. In the chart, select additional metrics to overlay their trends.

    pqus

    Only commands and events that exceed their configured threshold are recorded. If you see high-latency events, see Suggestions for handling common latency events for remediation guidance.

Metrics reference

The Latency Insights table displays the following columns:

MetricDescription
EventThe event name. Examples: ExpireCycle, EventLoop, Ping, Scan, Commands, Info. See Appendix: Common special events.
TotalTotal number of recorded occurrences.
Average Latency (us)Mean latency across all recorded occurrences, in microseconds.
Maximum Latency (us)Highest latency observed, in microseconds.
Aggregated count (< 1 ms)Count of events with latency below 1 ms. Click the zhankai icon to expand into sub-ranges: \<1 us, \<2 us, \<4 us, \<8 us, \<16 us, \<32 us, \<64 us, \<128 us, \<256 us, \<512 us, \<1 ms.
\<2 ms, \<4 ms, ..., >33sCount of events in each latency range.

Counting rules: Each range is exclusive at the lower bound and inclusive at the upper bound. For example, \<2 us counts events with latency between 1 us and 2 us. \<2 ms counts events with latency between 1 ms and 2 ms. >33s counts events with latency above 33 seconds.

What's next

Appendix: Common special events

Events are grouped by the Redis subsystem they relate to. The threshold column shows the minimum latency that triggers recording.

Memory eviction

EventThresholdDescription
EvictionDel30 msTime to delete evicted keys in one eviction cycle.
EvictionLazyFree30 msTime for background threads to release memory in one eviction cycle.
EvictionCycle30 msTotal time for one eviction cycle, including key selection, deletion, and waiting for background threads.

Memory defragmentation

EventThresholdDescription
ActiveDefragCycle100 msTime to run one memory defragmentation cycle.

Rehash

EventThresholdDescription
Rehash100 msTime to complete a hash table rehash.

Data structure upgrade

EventThresholdDescription
ZipListConvertHash30 msTime to convert a ziplist to a dictionary using hash encoding.
IntsetConvertSet30 msTime to convert an intset to a set using set encoding.
ZipListConvertZset30 msTime to convert a ziplist to a skiplist using ziplist encoding.

Append-only file (AOF)

EventThresholdDescription
AofWriteAlone30 msTime to write an AOF under normal conditions.
AofWrite30 msTotal time to write an AOF. Each successful AOF write records this event alongside exactly one of: AofWriteAlone, AofWriteActiveChild, or AofWritePendingFsync.
AofFstat30 msTime to retrieve AOF file metadata.
AofRename30 msTime to rename an AOF file.
AofReWriteDiffWrite30 msTime for the parent process to write incremental AOF data after a child process completes an AOF rewrite.
AofWriteActiveChild30 msTime to write AOF data to disk when another child process is also writing.
AofWritePendingFsync30 msTime to write AOF data when a background process is running fsync.

RDB file

EventThresholdDescription
RdbUnlinkTempFile50 msTime to delete a temporary RDB file after the bgsave child process exits.

Other events

EventThresholdDescription
Commands30 msTime to run a command not tagged as fast.
FastCommand30 msTime to run a fast-tagged command with O(1) or O(log N) complexity. For the list of fast commands, see the FastCommands section.
EventLoop50 msTime to complete one main event loop iteration.
Fork100 msTime to call fork().
Transaction50 msExecution time of a transaction.
PipeLine50 msTime consumed by a multi-threaded pipeline.
ExpireCycle30 msTime to scan and clear expired keys in one cycle.
ExpireDel30 msTime to delete expired keys within one expiry cycle.
SlotRdbsUnlinkTempFile30 msTime to delete a slot's temporary RDB file after the bgsave child process exits.
LoadSlotRdb100 msTime to load an RDB file from a slot.
SlotreplTargetcron50 msTime to load a slot's RDB file into a temporary database and migrate it to the destination database using a child process.