Skip to main content

Run stats

Understand the performance of your project with run stats

Run stats help users with Can Edit permission understand a project's performance by showing cell timings and cache usage.

Run stats panel showing a 4.05s run with a timeline of cell execution times

Notebooks

Access run stats via the Run stats icon in the upper right corner of your project.

Run stats panel open beside a notebook, listing seven runs with user, run time, cache, and session type

In the panel, you’ll see all runs from the past two days. Each run of the entire project, a selection of cells, or a singular cell will create a new row labeled with the user, date and time, run scope, run time, cache, and session type.

You can sort the list by Most recent or Oldest first, and use filters to narrow runs by User, Session type, or Cache.

Published apps

From the three-dot menu in the upper right corner, select Advanced > View run stats and you’ll be redirected to the notebook. When you open the run stats panel, it opens directly to the run associated with the app session you were viewing.

Run level stats

After you select a run, the top of the panel provides general information about the run and the legend used to interpret the per cell information. Here, you’ll see the total run time and kernel initialization time - this can be impacted by the time spent loading files and imported GitHub packages

Top of the run stats panel showing a 4.05s total run time, 885ms kernel initialization, the cell timing legend, and the sort and filter controls

In the upper right corner of the panel, you can filter by cell type, search by cell name, or sort by Execution Order, Notebook Order, Slowest, or Fastest.

Cell level stats

Click into an individual cell to view the time spent preparing, executing, streaming, reading from cache, and processing.

Category summary cell expanded in run stats, showing cell stages and a warehouse query breakdown of connecting, querying, cache read, streaming, and downloaded time

The legend explains the time spent:

  • Preparing: The time spent connecting to the warehouse and preparing the query
  • Executing: The time spent executing the cell's query or code
  • Streaming: The time spent streaming query results from the warehouse
  • Cache: The time spent reading from Hex’s cache
  • Processing: The time spent processing the cell’s query or output before displaying it