Configuration

Webapp

The Symbolication Service (aka Eliot) is run as worker processes by Gunicorn which is run by Honcho.

Gunicorn configuration:

ELIOT_GUNICORN_WORKERS
Parser:

str

Default:

“1”

Required:

No

Specifies the number of gunicorn workers.

Gunicorn docs suggest to set it to (2 x $num_cores) + 1.

https://docs.gunicorn.org/en/stable/settings.html#workers

https://docs.gunicorn.org/en/stable/design.html#how-many-workers

Used in bin/run_eliot_web.sh.

ELIOT_GUNICORN_TIMEOUT
Parser:

str

Default:

“300”

Required:

No

Specifies the timeout value.

https://docs.gunicorn.org/en/stable/settings.html#timeout

Used in bin/run_eliot_web.sh.

PORT
Parser:

str

Default:

“8000”

Required:

No

Specifies the port to listen to.

Used in bin/run_eliot_web.sh.

Webapp configuration:

Configuration

Configuration summary:

Setting

Parser

Required?

ELIOT_LOCAL_DEV_ENV

bool

ELIOT_HOSTNAME

str

ELIOT_LOGGING_LEVEL

str

ELIOT_STATSD_HOST

str

ELIOT_STATSD_PORT

int

ELIOT_STATSD_NAMESPACE

str

ELIOT_SECRET_SENTRY_DSN

str

ELIOT_SYMBOLS_CACHE_DIR

str

ELIOT_SYMBOLS_URLS

<ListOf(str)>

Configuration options:

ELIOT_LOCAL_DEV_ENV
Parser:

bool

Default:

“False”

Required:

No

Whether or not this is a local development environment.

ELIOT_HOSTNAME
Parser:

str

Default:

“build-24245877-project-834179-mozilla-eliot”

Required:

No

Unique identifier for the host that is running Eliot. This is used in logging and metrics. The default is socket.gethostname().

ELIOT_LOGGING_LEVEL
Parser:

str

Default:

“INFO”

Required:

No

The logging level to use. DEBUG, INFO, WARNING, ERROR or CRITICAL

ELIOT_STATSD_HOST
Parser:

str

Default:

“localhost”

Required:

No

Hostname for statsd server.

ELIOT_STATSD_PORT
Parser:

int

Default:

“8124”

Required:

No

Port for statsd server.

ELIOT_STATSD_NAMESPACE
Parser:

str

Default:

“”

Required:

No

Namespace for statsd metrics.

ELIOT_SECRET_SENTRY_DSN
Parser:

str

Default:

“”

Required:

No

Sentry DSN to use. If this is not set an unhandled exception logging middleware will be used instead. See https://docs.sentry.io/quickstart/#configure-the-dsn for details.

ELIOT_SYMBOLS_CACHE_DIR
Parser:

str

Default:

“/tmp/cache”

Required:

No

Location for caching symcache files.

ELIOT_SYMBOLS_URLS
Parser:

<ListOf(str)>

Default:

https://symbols.mozilla.org/try/

Required:

No

Comma-separated list of urls to pull symbols files from.

Disk cache manager

The disk cache manager is run as a single process by Honcho.

Configuration

Configuration summary:

Setting

Parser

Required?

ELIOT_LOCAL_DEV_ENV

bool

ELIOT_HOSTNAME

str

ELIOT_LOGGING_LEVEL

str

ELIOT_STATSD_HOST

str

ELIOT_STATSD_PORT

int

ELIOT_STATSD_NAMESPACE

str

ELIOT_SECRET_SENTRY_DSN

str

ELIOT_SYMBOLS_CACHE_DIR

str

ELIOT_SYMBOLS_CACHE_MAX_SIZE

everett.manager.parse_data_size

Configuration options:

ELIOT_LOCAL_DEV_ENV
Parser:

bool

Default:

“False”

Required:

No

Whether or not this is a local development environment.

ELIOT_HOSTNAME
Parser:

str

Default:

“build-24245877-project-834179-mozilla-eliot”

Required:

No

Unique identifier for the host that is running Eliot. This is used in logging and metrics. The default is socket.gethostname().

ELIOT_LOGGING_LEVEL
Parser:

str

Default:

“INFO”

Required:

No

The logging level to use. DEBUG, INFO, WARNING, ERROR or CRITICAL

ELIOT_STATSD_HOST
Parser:

str

Default:

“localhost”

Required:

No

Hostname for statsd server.

ELIOT_STATSD_PORT
Parser:

int

Default:

“8124”

Required:

No

Port for statsd server.

ELIOT_STATSD_NAMESPACE
Parser:

str

Default:

“”

Required:

No

Namespace for statsd metrics.

ELIOT_SECRET_SENTRY_DSN
Parser:

str

Default:

“”

Required:

No

Sentry DSN to use. If this is not set an unhandled exception logging middleware will be used instead.

See https://docs.sentry.io/quickstart/#configure-the-dsn for details.

ELIOT_SYMBOLS_CACHE_DIR
Parser:

str

Default:

“/tmp/cache”

Required:

No

Location for caching symcache files.

ELIOT_SYMBOLS_CACHE_MAX_SIZE
Parser:

everett.manager.parse_data_size

Default:

“1gb”

Required:

No

Max size (bytes) of symbols cache. You can use _ to group digits for legibility. You can use units like kb, mb, gb, and tb.