Skip to content

Logging Base Module

This is a small Python package designed to simplify the process of enabling consistent logging across multiple projects. Instead of copying code from one project to another, this package provides a simple, reusable solution.

Install

uv add "ki-logging @ git+https://github.com/DLR-KI/ki-logging.git@main"

pip install -U "git+https://github.com/DLR-KI/ki-logging.git@main"

dependencies = [
  "ki-logging @ git+https://github.com/DLR-KI/ki-logging.git@main",
]

install_requires = [
    "ki-logging @ git+https://github.com/DLR-KI/ki-logging.git@main",
]

[tool.poetry.dependencies]
ki-logging = { git = "git+https://github.com/DLR-KI/ki-logging.git", branch = "main" }

Usage

Default configuration

import logging
from dlr.ki.logging import load_default

load_default("logs/app.log")
logging.info("Hello World!")

Advanced: Manipulate default configuration

import logging
import logging.config
from dlr.ki.logging import get_default_logging_dict

# get default logging configuration
log_config = get_default_logging_dict("logs/app.log")

# manipulate logging configuration
# e.g. add an additional handler like loki
#      and set the log level from urllib3 to warning
log_config["handlers"]["loki"] = {
    "level": "DEBUG",
    "class": "logging_loki.LokiHandler",
    "url": "http://localhost:3100/loki/api/v1/push",
    "tags": {
        "app": "fl.server",
    },
    "auth": ["admin", "admin"],
    "version": "1",
}
log_config["loggers"][""]["handlers"].append("loki")
log_config["loggers"]["urllib3"] = {"level": "WARNING"}

# load config
logging.config.dictConfig(log_config)
logging.info("Hello World!")