Configuration

You can configure the behavior of our agents using these configuration options. They can be set from environment variables like:

env.sh

export ATLAS_APIKEY="<API_KEY>"

app.py

try:
    import heimdall
    heimdall.start()
except ImportError as e:
    pass

or inside the code as:

heimdall.start(apikey="<API_KEY>")

In the table below, you can see what each config option does and how to set them.

Except for the parameter apikey, all other configuration options are optional and have default values.

Config name in code	Config name as env variable	Purpose
apikey	ATLAS_APIKEY	This is the api key used to authenticate with CtrlB services.
application_name	ATLAS_APPLICATION_NAME	Set the name of your application to improve your experience. Defaults to git repo if available.
application_stage	ATLAS_APPLICATION_STAGE	Set this if the same application is deployed in prod, beta or dev environment to distinguish between them. Can leave unspecified if not applicable.
application_version	ATLAS_APPLICATION_VERSION	Set this if the same application name and stage have multiple versions running. Can leave unspecified if not applicable.
debug	ATLAS_DEBUG_ENABLE	Set this to "True" to enable atlas debug logs.
auto_instrumentation	ATLAS_AUTO_INSTRUMENTATION_ENABLE	This is an experimental feature to automatically generate trace ids for distrubuted requests. Disabled by default. Set this to "True" to enable it.