Environment Variables

Logly supports environment variables to control initialization and configuration.

LOGLY_AUTOINIT

Controls whether Logly automatically adds a stderr sink on import.

Default Behavior

By default, Logly adds a stderr sink with level="DEBUG" when the module is first imported:

from logly import logger
# stderr sink is already active at DEBUG level
logger.info("This prints to stderr immediately")

Disabling Auto-Init

Set LOGLY_AUTOINIT to false, 0, or no to prevent the automatic stderr sink:

export LOGLY_AUTOINIT=false

from logly import logger
# No sinks configured - you must add your own
logger.add("app.log", level="INFO")
logger.info("This only goes to app.log")

Values

Value	Behavior
true (default)	Auto-add stderr sink
false	No automatic sink
0	No automatic sink
no	No automatic sink

LOGLY_* Configuration Overrides

These environment variables override default configuration values. The LOGLY_ prefix is stripped and the remainder is lowercased.

Variable	Purpose	Example
LOGLY_LEVEL	Default log level	LOGLY_LEVEL=WARNING
LOGLY_FORMAT	Default format string	LOGLY_FORMAT="{level} | {message}"
LOGLY_COLORIZE	Enable/disable colors	LOGLY_COLORIZE=NO
LOGLY_SERIALIZE	Enable/disable JSON output	LOGLY_SERIALIZE=YES
LOGLY_BACKTRACE	Enable/disable backtrace	LOGLY_BACKTRACE=YES
LOGLY_DIAGNOSE	Enable/disable diagnose mode	LOGLY_DIAGNOSE=YES

Usage

# Disable colors
export LOGLY_COLORIZE=NO

# Force JSON output
export LOGLY_SERIALIZE=YES

# Set minimum level
export LOGLY_LEVEL=WARNING

from logly import logger
# Configuration applied from environment
logger.info("This respects env overrides")

Common Patterns

Development (default):

export LOGLY_AUTOINIT=true

Production (explicit configuration):

import os
os.environ["LOGLY_AUTOINIT"] = "false"

from logly import logger

logger.add("logs/app.log", level="INFO", rotation="daily", compression="gzip")
logger.add("logs/errors.log", level="ERROR")

Testing (disable for clean output):

LOGLY_AUTOINIT=false python -m pytest

Docker:

ENV LOGLY_AUTOINIT=false