---
id: logging-tree
version: "1.10"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# logging-tree — Introspect and display the logger tree inside "logging"

License: permissive · Maintenance: dormant · Downloads: 235.2K/mo

## What it is and what it does

logging_tree is a diagnostic tool that introspects Python's standard logging module and displays the current logger tree in a human-readable ASCII diagram. It shows the root logger and all child loggers, their configured levels, handlers, filters, and propagation settings. The package solves the problem of understanding complex logging configurations at runtime—especially useful when debugging why certain log messages appear or disappear, or when inheriting code with unfamiliar logging setups.

The package has no runtime dependencies and works by querying the logging module's internal state. It offers both a simple `printout()` function for immediate console output and lower-level APIs (`format.build_description()`, `format.describe()`, `tree()`) for programmatic access to the tree structure. It handles edge cases like placeholder nodes (parent loggers created implicitly) and loggers with disabled propagation.

Use it for:

- Debug why a log message is or isn't appearing by visualizing the full logger hierarchy and propagation chain.
- Audit logging configuration in a running application to verify handlers and levels are set as expected.
- Understand inherited or third-party code's logging setup without reading source files.
- Verify that custom logger hierarchies (e.g., 'app.module.submodule') are structured correctly.
- Troubleshoot double-logging or missing log output caused by handler duplication or propagation settings.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Visualizes the hierarchy of loggers, handlers, and filters in Python's standard logging module, showing how messages propagate through the logger tree.

Yes. This is a low-friction, zero-dependency diagnostic tool for a common pain point (understanding logging configuration). It is stable, permissive-licensed, and works across a wide range of Python versions. Install it if you regularly debug logging setups or inherit complex applications; skip it if you never need to inspect logging state at runtime.

## Install

pip install logging-tree
uv add logging-tree
poetry add logging-tree

## Installing logging-tree

Before you install: Low friction: pure Python wheel with no runtime dependencies. Maintenance is dormant (833 days since last release) but the package is marked Mature and the repository remains active with 333 stars; suitable for stable introspection use.

License in practice: Permissive license (BSD) with no restrictions on commercial or private use.

Quickstart:

pip install logging-tree

import logging
from logging_tree import printout

logging.getLogger('app').setLevel(logging.DEBUG)
printout()

Verify before relying:

- Whether the package works correctly with Python versions newer than 3.12 (latest declared compatibility is 3.12).

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 235.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

logging tree visualization, inspect logger hierarchy, debug logging configuration, logger tree introspection, logging propagation diagram, handler and filter display, python logging structure, logging-diagnostics, introspection

[View on SkillFed](https://skillfed.io/packages/logging-tree) · [View on PyPI](https://pypi.org/project/logging-tree/)