Skip to content

Histograms

A histogram metric records a whole distribution at each step — the weights of a layer, its activations, or its gradients — instead of a single number. Log one with metrana.log_histogram. In the metrics tree, histograms have a bar-chart icon, and density histograms an area-chart icon.

Histograms can be plotted on a run’s Charts view, in Compare, and in Side-by-side.

A run's Charts view showing histogram metrics as heatmaps
Histogram metrics on a run's Charts view.

A histogram chart is a heatmap:

  • Across — steps, like any other chart.
  • Up — the values the distribution covers, split into bins.
  • Shade — how many values fell into each bin at that step: the more values, the more solid the cell’s color. Shading is scaled per run, so each run’s distribution reads on its own terms.

With several runs, each step’s column is split into a slice per run, in the run’s color.

Hover the chart and a small panel follows the pointer, drawing each run’s distribution at that step as an outline — the cross-section the heatmap can’t show.

A histogram chart hovered at step 50, with a panel by the pointer drawing that step's distribution
Hovering a histogram: the panel draws the distribution at the hovered step, and the tooltip reads the bin under the pointer.

The tooltip header shows the Step and the Value under the pointer. Below it, a row per run gives:

Column What it shows
Count or Density The bin’s count (or density, for density histograms)
Share The bin’s share of the run’s values at that step
Bin The bin’s range, such as [0.1, 0.2)
Run The run

A column per label key follows when the metric has labels. As on line charts, you can hide or isolate a run from its row — except in Side-by-side, where each chart shows a single run.

  • Zoom works as on line charts: the x-range is shared with the page’s other charts, the y-range stays on the chart you zoomed.
  • Settings don’t apply: histograms have no smoothing, log scale, x-axis mode, or reference lines. Their ⋮ menu only has Export as image and Export as CSV.
  • Export as CSV downloads the bins of the runs you can see, for the zoomed range — see Exporting data.

Histograms can’t be added to dashboards, and their labels can’t be filtered.