Use the oevents CLI to export data
Instructions on how to export Experimentation Event Export data using the Optimizely Experimentation oevents
command line interface.
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.
Updated 16 days ago