Skip to content
Framedash Docs

Performance Heatmaps

Performance heatmaps are a core Framedash feature that overlays performance data on your game maps.

Overview

Section titled “Overview”

Performance samples collected by the SDK include position information (world coordinates). Heatmaps plot this data on a map image, visualized with a color gradient.

Available Metrics

Section titled “Available Metrics”
  • FPS — Frame rate distribution. Red areas indicate low performance
  • Frame Time — Processing time per frame
  • GPU Time — Identify rendering bottlenecks
  • Memory Usage — Discover memory leaks

Filtering

Section titled “Filtering”

Heatmaps can be filtered by the following criteria:

  • Build Version — View performance for a specific build
  • Device Profile — Compare low-end vs. high-end devices
  • Date Range — Limit data to a specific time period
  • Session — Detailed analysis of individual sessions

Build Comparison

Section titled “Build Comparison”

Compare heatmaps from two builds side by side. Useful for visually confirming the impact of optimizations.

Map Images

Section titled “Map Images”

Map images used as heatmap backgrounds can be registered in the following ways:

  1. Manual Upload — Upload images from the dashboard or via the API
  2. CI Auto-Capture — Auto-generate images with world-coordinate metadata from the build pipeline

Next Steps

Section titled “Next Steps”