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.

A. How To Enable Latency Heatmaps
Mount OFS in the foreground with "-v" switch.
$ sudo mount.objectivefs mount -v <filesystem> <directory>
To toggle between latency heatmaps, press Ctrl-\ to send the SIGQUIT signal to ObjectiveFS.
B. Available Heatmaps
- Object store PUT latency
- Object store GET latency
- FUSE response latency
- Disk cache read latency (if disk cache is enabled)
- Disk cache write latency (if disk cache is enabled)
C. How To Read Latency Heatmaps

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.

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

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.
Useful Links
- How To Mount an Instance Store on EC2 for Disk Cache
- How To Restrict S3 Bucket Policy to Only One S3 Bucket
Last updated ObjectiveFS staff
ObjectiveFS is a shared file system for macOS and Linux that automatically scales and gives you scalable cloud storage. If you have questions or article idea suggestions, please email us at support@objectivefs.com