Guance Learn

Observability guides

Practical, source-backed guides for instrumenting, operating, and improving production systems.

Colored paths carrying tasks through a shared processing hub
Technical guide

Build a Python API with Litestar and SQLAlchemy

Build a small Litestar blog API with async SQLAlchemy, explicit request and response models, dependency injection, and create, read, update, and delete routes.

Illustration of application logs flowing through a collection pipeline
Technical guide

10 Java logging practices for production services

Configure useful Java logs with SLF4J, JSON layouts, scoped MDC, measured async behavior, preserved exceptions, and verified collection in Guance.

Log events moving through collection and processing stages
Technical guide

JSON logging: structure events for reliable queries

Emit one JSON object per log event, choose consistent field types, preserve timestamps and trace context, and configure parsing and retention in Guance.

Illustration of application records passing through collection stages
Technical guide

Laravel logging: channels, JSON context, and production configuration

Configure Laravel log channels, exact-level filtering, JSON formatters, and queue-worker logging, then verify fields and alerts after collection.

Illustration of logs flowing through a collection pipeline
Technical guide

Linux authentication logs: parsing SSH events and detecting attacks

Find auth.log, secure, or journal events; parse SSH and sudo context; validate authentication alerts; and apply access controls without losing administrative access.

Illustration of records moving through buffering and delivery stages
Technical guide

Reliable log delivery: buffers, acknowledgments, and consumer offsets

Choose a log delivery architecture by its failure boundaries: durable buffering, partial responses, contiguous offset commits, retries, replay, and deduplication.

The log lifecycle, from collection and analysis to retention and archiving
Explainer

Getting started with log management

Build a practical log management workflow: structured logging, collection, access control, live search, alerts, dashboards, retention, and archives.

Illustration of connected application signals and engineering workflows
Technical guide

Migrate log platforms with dual writing, reconciliation, and rollback

Choose a migration boundary, reconcile event IDs and query behavior, and size the overlap and replay window before cutting over log platforms.

Log collectors processing and forwarding events through a telemetry pipeline
Technical guide

Choosing a log collector: Vector, Fluent Bit, or the OpenTelemetry Collector

Compare transformation failures, file checkpoints, persistent queues, rotation, and operating costs—and decide when an existing collector should stay in place.

Illustration of application logs flowing through a collection pipeline
Technical guide

Configure Log4j 2: JSON output, request context, and asynchronous logging

Set up Log4j 2 appenders and logger routing, use JSON Template Layout and scoped context, and evaluate asynchronous logging without losing sight of delivery guarantees.

Illustration of application logs moving through a collection pipeline
Technical guide

log4net: configuration, rolling files, and maintaining .NET applications

Configure log4net in C# or XML, preserve exception and request context, avoid unsafe multiprocess rotation, and collect existing .NET application logs.

Illustration of application logs flowing through a collection pipeline
Technical guide

Configure Logback for structured Java logging

Understand Logback appenders and logger routing, configure rotation and JSON output, preserve MDC context, and verify collection and alerts in Guance.