Latency Heatmaps

ObjectiveFS supports latency heatmaps in version 4.1 and newer. The latency heatmaps are useful for performance tuning and are not for production use.

Latency Heatmap

A. How To Enable Latency Heatmaps

  1. Mount OFS in the foreground with “-v” switch.

    $ sudo mount.objectivefs mount -v <filesystem> <directory>

  2. To toggle between latency heatmaps, press Ctrl-\ to send the SIGQUIT signal to ObjectiveFS.

B. Available Heatmaps

C. How To Read Latency Heatmaps

Latency Heatmap Details

  1. Type of heatmap.
  2. Color bar to verify your terminal can display heatmap correctly. The colors are in log scale, where darker tones represent fewer events and lighter tones represent more events.
  3. During activity, rows are displayed after 5 seconds and show the cumulative events since last displayed.
  4. Latency in log scale, ranging from 0.25us to 1000s.

Latency Heatmap Details

5. 99th percentile of latency for the events on this row.
6. Total number of events on this row.


Latency Heatmap Overview 2

The disk cache read latency heatmap above shows two clusters of reads. The initial faster reads (40-80us) show hits in the kernel cache, and the second group of reads (0.5ms-1.5ms) show hits in the disk cache.

by ObjectiveFS staff, February 8, 2016
ObjectiveFS is a shared file system for OS X and Linux that automatically scales and gives you scalable cloud storage. If you have questions or article idea suggestions, please email us at