Use the oevents CLI to export data

The oevents CLI is written in bash and should run on macOS and most GNU or 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 it, you will need to make sure it is executable. Assuming oevents is in your working directory. You can do this with the following command:

$ chmod +x oevents

To run oevents, specify the script's path explicitly (assuming oevents is in your working directory):

$ ./oevents help

Or you can add it to a directory in your PATH environment variable.

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

Generate a personal access token.

Generate a personal access token (PAT) within the Optimizely application by following Manage your API tokens documentation 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.