Skip to content

Runs table overview#

Example of the runs table in the Neptune app

In the runs table, you can see all the runs of the project in one place.

Each time you track a run with neptune.init_run(), it's added to the top of the table.

The leftmost column shows the Neptune ID and the status of the run. The eye icon () indicates whether the run is selected for the comparison view mode.

Getting more space#


To enlarge the metadata area, you can:

  • Minimize the left sidebar with the button.
  • Collapse the toolbar with the icon.
  • Adjust the number of table columns shown by unpinning them or dragging to minimize the table area.
  • Enter distraction-free mode with the button, to temporarily maximize the metadata area.

Supported field types#

The table view supports simple field types and certain single values.

Out of a series of values, you can choose a particular value to display, such as the last logged value or an aggregate.


Not supported

Searching and filtering runs#

Filter input box and selection menu for date and time

You can query runs by any field (except file fields).

  • Click on the operator or value to modify it without changing the rest of the query.
  • To instantly filter by tag or owner, click on it in the respective column.

For the syntax, see Search and filter the runs table.

Configuring runs table columns#

Apart from filtering, you can customize the table columns to display the fields you are interested in.

Adding columns to the table#

To add a suggested column to the table, click the plus icon ().

  • To dismiss a suggestion, click the minus icon ().
  • To hide or show suggested columns, click the lightbulb icon ().

You can also add a field with the Add column button.

Good to know

To be featured in the parallel coordinates comparison view, the column must be present in the runs table.

Pinning columns#

Pinned columns determine which fields are included in the legend box when comparing multiple runs, for example, in charts.

  • To pin a column, click the icon and select Pin column.

    You can also drag the column to the left of the separator line.

Sorting and customizing columns#

You can:

  • Sort the table by any column that has been added.
  • Configure the column label (name), color, and numerical format.

Sorting by last edited#

Modification timestamps are stored automatically in the sys namespace.

You can sort by the following:

  • sys/ping_time – when the Neptune API interacted with the object. That is, something was logged or modified through the code.
  • sys/modification_time – when any kind of edit was made, such as editing the run metadata through the app. This can be setting a description or managing the tags.

Saving a custom view#

Once you're satisfied with the table, you can save it as a custom view by clicking Save view as new. It can then be accessed by anyone viewing the project.

Saving a custom view of the runs table

Grouping runs (groupBy)#

You can group runs by any value, such as batch size or other parameter.

For more, see Group runs (groupBy).