export

The openlayer export command downloads monitoring data from an inference pipeline for a specified time period. It supports flexible ways to specify date ranges and optional filters to refine the exported dataset.

Usage

openlayer export [inference_pipeline_id] [start] [end]

This will fetch your monitoring data from the inference pipeline and place a dataset.json and config.json file in ./openlayer-exports/{pipeline_name}_{start}_{end}.

Date ranges

You can specify time ranges in multiple ways:

# Date ranges (inclusive of end date)
openlayer export my-pipeline --from 2025-08-01 --to 2025-08-10
openlayer export my-pipeline --from "Aug 1, 2025" --to "Aug 10, 2025"
openlayer export my-pipeline --from 2025-08-01T10:00:00 --to 2025-08-10T18:00:00

# Unix timestamps (legacy mode)
openlayer export my-pipeline --from 1724659200 --to 1725340800

# Relative ranges
openlayer export my-pipeline --last 7d
openlayer export my-pipeline --last 2h30m

# Preset ranges
openlayer export my-pipeline --range this-week

# Legacy positional arguments (still supported)
openlayer export my-pipeline 1724659200 1725340800

Filters

You can refine the exported dataset using --filter flags or a JSON file.

Simple syntax

# Numerical comparisons
openlayer export my-pipeline --filter 'confidence_score>=0.8'
openlayer export my-pipeline --filter 'age>25' --filter 'score<=100'

# String equality
openlayer export my-pipeline --filter 'status=active' --filter 'region!=test'

# Array/list operations
openlayer export my-pipeline --filter 'region in [US,CA,UK]'
openlayer export my-pipeline --filter 'tags contains any [prod,staging]'

JSON file (advanced)

For more complex filters, pass a JSON file:

openlayer export my-pipeline --filters-file filters.json

Output format

--format (or -f) controls the file format of the exported data:

openlayer export my-pipeline --last 7d --format json   # default
openlayer export my-pipeline --last 7d --format csv
openlayer export my-pipeline --last 7d --format xlsx

Test scores

By default the export contains no score columns. Pass --include-scores all to add each test’s score and explanation as columns:

openlayer export my-pipeline --last 7d --include-scores all

This export is slower than the default one, because the scores are fetched per chunk of data. Score and explanation columns are named by a config hash, such as openlayer_llm_rubric_score_78812226. The hash keeps two tests that share a name in separate columns, and changing an evaluator starts a new column. With --include-scores all, the CLI adds metricColumns to config.json after it extracts the archive. Each entry maps a hashed column to its test name and test id:

{
  "metricColumns": [
    {
      "scoreColumn": "openlayer_llm_rubric_score_78812226",
      "testName": "Confusion",
      "testId": "t-1"
    }
  ]
}

scoreColumn is the column name in the exported rows. An entry can include other fields from the same registry. If the lookup fails, the CLI prints a warning and still keeps the export. The rows are usable without the mapping.

Combining --format csv with --include-scores all splits the output into several data_partNNNN.csv files instead of a single file. The CLI prints a note when it does.

Flags

Flag	Default	Description
`--from`	`""`	Start of the time range (date, timestamp, or relative).
`--to`	`""`	End of the time range (date, timestamp, or relative).
`--last`	`""`	Relative duration (e.g. `7d`, `2h30m`).
`--range`	`""`	Preset range (e.g. `this-week`, `last-month`).
`--output-dir`	`./openlayer-exports/...`	Directory where the exported files will be placed.
`--filter`	`[]`	Apply one or more filters using simple syntax (can be repeated).
`--filters-file`	`""`	Path to a JSON file with advanced filters.
`--format`	`json`	Output format: `json`, `csv` or `xlsx`.
`--include-scores`	`none`	Include test scores as columns: `none` or `all`. With `all`, hashed columns are mapped in `config.json` under `metricColumns`.

Reference

SDKs

CLI

REST API

Usage

Date ranges

Filters

Simple syntax

JSON file (advanced)

Output format

Test scores

Flags

​Usage

​Date ranges

​Filters

​Simple syntax

​JSON file (advanced)

​Output format

​Test scores

​Flags

Usage

Date ranges

Filters

Simple syntax

JSON file (advanced)

Output format

Test scores

Flags