Aerobat

The documentation in this section is for users that require further details on the individual Tailslide Aerobat component.

Overview

Aerobat is responsible for querying the Redis Timeseries database for each live circuit within an application, to evaluate current error rates against developer-configured error thresholds.

Tailslide’s SDK clients (installed in the user application) will record successful and failed operation attempts to the Redis Timeseries database.

Aerobat will poll the Redis Timeseries database at a developer-defined interval in order to calculate the error rate percentage in each feature flag over a developer-defined window of time. It will compare that percentage to a user-defined error threshold percentage. If the error rate percentage is larger than specified, the circuit is tripped open.

Once a circuit is tripped open, Aerobat will wait a developer-defined amount of time before attempting to expose users to the feature again. Once that time has passed, users will be directed to the feature at a developer-defined ‘Recovery Increment’ percentage until the feature is available to the desired number of users.

Note: all developer-defined variables can be specified via Tower front-end

Running Aerobat Locally

Clone main branch of repository here

Sample .env file to add into the root directory

SDK_KEY='myToken'
NATS_SERVER='nats://127.0.0.1:4222'
NATS_STREAM='flags_ruleset'
NATS_SUBJECT="apps.*.update.manual" 

REDIS_SERVER='{"socket":{"host":"localhost"}}' 
REDIS_POLL_RATE=3000
REDIS_TIME_WINDOW=3000

Within the root directory run npm install

Run npm start

NATS JetStream and Redis Timeseries Database

Both a NATS JetStream and a Redis Timeseries Database will need to be running. See instructions in Tailslide Tower for how to start each.