Use the oevents CLI to export data

The oevents CLI is written in bash and runs on macOS and most GNU/Linux distributions. See the GitHub repository for detailed installation and usage instructions.

Prerequisites

jq
curl
the Amazon AWS CLI (v2+)

Download

You can download a zipped directory containing the oevents CLI from the oevents GitHub repository.

Install

oevents is a bash script. To run oevents, first make it executable. Assuming oevents is in your working directory, run:

$ chmod +x oevents

To run oevents, specify the script's path explicitly:

$ ./oevents help

Alternatively, add oevents to a directory in your PATH.

$ sudo cp oevents /usr/local/bin/
$ oevents help

Generate a personal access token

Generate a Personal Access Token (PAT) in Optimizely by following the Manage your API tokens instructions.

Store your Personal Access Token in the OPTIMIZELY_API_TOKEN environment variable.

export OPTIMIZELY_API_TOKEN=<token>

Explore and download your data

You can use the oevents CLI to acquire temporary AWS credentials.

oevents auth

Explore your data.

oevents ls \
    --type events \
    --date 2020-07-01

Download your data.

oevents load \
    --type decisions \
    --start 2020-07-01 \
    --end 2020-07-05 \
    --experiment 12345

📘
Note
The date and time is in UTC.