Logging Architecture

MATIH implements structured logging using structlog for Python services and Spring Boot logging for Java services. Logs are collected by Fluent-bit or Promtail and shipped to Loki for centralized storage and querying. Log lines include trace IDs for correlation with distributed traces and metrics.

Subsections

Page	Description
Structured Logging	Structured log formatting for Python and Java services
Loki Setup	Loki installation and configuration
Log Querying (LogQL)	Writing LogQL queries for log exploration
Log Aggregation	Fluent-bit and Promtail log collection

Logging Pipeline

Services --> Structured Logs --> Fluent-bit/Promtail --> Loki --> Grafana
                                                                    |
                                                          LogQL Queries
                                                          Trace Correlation

Log Levels

Level	Usage
`ERROR`	Errors requiring investigation
`WARNING`	Unexpected conditions that may indicate problems
`INFO`	Normal operational events
`DEBUG`	Detailed diagnostic information (disabled in production)

Logging Structured Logging