Documentation — Guides & API Reference
Smart log analysis for Russian businesses. Find guides, API specs, and integration instructions.
Categories
Browse documentation by topic. Each category contains step-by-step guides, reference tables, and code samples.
Quick Start
Install the LogTrace collector agent on Linux or Windows, configure your first pipeline, and forward logs to the dashboard in under 10 minutes. Includes Docker Compose boilerplate and a sample logtrace.yaml for nginx + PostgreSQL stacks.
Topics: agent installation, YAML config reference, first query, dashboard walkthrough, sample datasets.
API Reference
REST and gRPC endpoints for ingesting, querying, and managing log streams. Full OpenAPI 3.1 spec, authentication via JWT or API key, pagination, and response schemas. Rate limits: 12 000 req/min for Standard, 50 000 req/min for Enterprise.
Topics: /v1/logs, /v1/streams, /v1/queries, webhook callbacks, SDKs for Python, Go, and Java.
Integrations
Connect LogTrace with your existing stack out of the box. Native connectors for Kafka 3.x, ElasticSearch 8+, ClickHouse 23+, Grafana 10, and Telegram alerts. Pre-built dashboards for nginx, Apache, Tomcat, and .NET Core applications.
Topics: connector config, field mapping, TLS/mTLS setup, webhook routing, alerting rules.
Best Practices
Production-hardened recommendations from the LogTrace engineering team. Structured logging patterns, trace_id propagation across microservices, log rotation strategies, PII redaction with regex pipelines, and cost-optimization tips for high-throughput environments (500 MB/s+).
Topics: log levels strategy, sampling, retention policies, multi-tenant isolation, performance tuning.
Agent Repositories
Open-source collector agents maintained by the LogTrace team. All agents are published under the Apache 2.0 license.
lt-collector (Go)
Primary agent for Linux and Windows. Supports file tailing, syslog, and named pipes. Binary size: ~14 MB. Used in production by 2 300+ teams.
lt-collector-python
Python 3.9+ agent for instrumenting application-level logging. Integrates with logging, structlog, and loguru. Adds automatic trace_id injection via context vars.
lt-collector-java
lt-collector-java
Java agent (JDK 11+) that attaches to running JVMs without code changes. Supports SLF4J, Logback, and java.util.logging. Adds structured fields and correlation IDs to every log event.
Recent Updates
Latest changes to documentation, API, and agent releases.
2025-06-10 — API v1.4: Query Builder & Aggregations
New /v1/queries/build endpoint for programmatic query construction. Added count(), avg(), percentile(95), and histogram() aggregation functions. Updated Python SDK to 2.8.1.
2025-06-03 — ClickHouse Connector 3.2
Native ClickHouse integration now supports materialized views and ReplacingMergeTree engines. Reduced ingestion latency by 40% (from 1.2 s to 720 ms at 100 k events/sec). Added schema auto-discovery for JSON logs.
2025-05-22 — Best Practices: PII Redaction Guide
New guide covering regex-based redaction pipelines for Russian passport numbers (11-digit format), INN, OGRN, and payment card numbers. Includes pre-tested patterns and a performance benchmark (0.3 ms/log line on Intel Xeon E-2336).