Atlas

Introduction

Netflix/Atlas is an application for storing and querying dimensional time series data for near real-time operational insight. Atlas features in-memory data storage, allowing it to gather and report very large numbers of metrics, very quickly.

Caveats

The current Atlas Docker image is not production ready. This guide will help you get up and running quickly, but take note of the following:

• Ensure the Docker host has the correct time. Communication with the AWS APIs require the container to be within 15 minutes of actual. The current standalone build of Atlas does not leverage AWS APIs, but future releases will, for services such as CloudWatch.
• The Atlas application does not currently log and Docker images currently do not export logs off the container.
• The JVM configuration has not been tuned. The Java default max heap size is used, which is the smaller of either 1/4 system RAM or 1GB.
• The Atlas container includes some fake data so that you can work with the APIs. See Atlas Graph Examples for a variety of graphing use cases.

Pre-Requisites

There are no pre-requisites.

Configure

No additional configuration is necessary.

Run the Container

docker run -d \
  --name atlas \
  -p 7101:7101 \
  netflixoss/atlas:1.4.1

Test the Container

Test the Atlas service by querying for tags and generating a graph.

curl 'localhost:7101/api/v1/tags'
curl -Lo graph.png 'http://localhost:7101/api/v1/graph?q=name,ssCpuUser,:eq,:avg,:dup,22.8,:gt,:vspan,30,:alpha'

See the Atlas Graph API documentation or Atlas Tags API documentation for additional use cases.

Inspect the Container

docker exec -i -t atlas bash