Guance Learn

Observability guides

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

Illustration of connected application signals and engineering workflows
Technical guide

OpenTelemetry Collector: architecture, configuration, and operation

Understand Collector pipelines, validate a trace configuration, choose Agent or Gateway deployment, and verify export to DataKit.

Illustration of connected application signals and engineering workflows
Technical guide

Instrument Go services with OpenTelemetry tracing

Connect Go HTTP, Redis, and SQL operations with propagated context, export through a Collector, and verify request traces in Guance.

Cover illustration for Java and OpenTelemetry metrics
Technical guide

Add OpenTelemetry metrics to a Spring Boot service

Record request counts, in-flight work, latency histograms, and downstream failures in Java, then validate the exported metrics in Guance.

Illustration of connected application signals and engineering workflows
Technical guide

OpenTelemetry metrics: instruments, Views, and export semantics

Choose metric instruments, control attributes and histogram aggregation with Views, and verify temporality and OTLP or Prometheus export.

Illustration of connected application telemetry
Technical guide

Node.js tracing with OpenTelemetry: automatic instrumentation and custom spans

Initialize OpenTelemetry before a Node.js app, configure OTLP over HTTP, add business spans, and verify async context, shutdown, and Guance trace correlation.

Illustration of connected application signals and engineering workflows
Technical guide

OpenTelemetry sampling: head decisions, tail policies, and limits

Choose head or tail sampling with explicit data-loss trade-offs, trace-aware routing, bounded memory, and verified error and latency policies.

Illustration of connected application signals and engineering workflows
Technical guide

OpenTelemetry SDK: resources, providers, and signal pipelines

Understand how the OpenTelemetry SDK connects APIs to resources, sampling, aggregation, propagation, and signal-specific export.

Illustration of connected application signals and engineering workflows
Technical guide

OpenTelemetry semantic conventions: names, types, and migrations

Apply resource, span, metric, and log conventions consistently, namespace custom attributes, and plan schema migrations safely.

Illustration of PHP application records passing through log collection
Technical guide

PHP logging: error_log, exceptions, and PSR-3

Configure PHP error reporting, distinguish SAPI and FPM destinations, preserve exception details, and move application logs toward PSR-3 and Monolog.

Illustration of container modules organized in a harbor
Technical guide

Podman logging: viewing, retention, and collection

Read Podman logs, compare journald and k8s-file, limit local storage, export records, and select a collector that understands the actual log format.

Illustration of connected application signals and engineering workflows
Technical guide

Postfix logging: trace delivery, queues, and failures

Follow Postfix queue IDs, distinguish deferred and bounced mail, inspect delivery attempts, and collect useful mail logs in Guance.

10 Python logging practices for production services illustration
Technical guide

10 Python logging practices for production services

Build useful Python logs with named loggers, centralized configuration, structured fields, exception tracebacks, safe data handling, and reliable collection.