Documentation
Logthread documentation
Everything you need to send logs, traces and metrics to Logthread and to query them afterwards.
Get started
Developers overviewEvery SDK, collector pack and setup snippet in one place, with install commands and checksums.
Send your first logsCreate an ingest key in the app and copy a snippet for your stack.
Logthread SDKs
Node.jsBatched, non-blocking log delivery for Node.js 18+. No runtime dependencies, ESM and CommonJS. Captures console output and adds per-request correlation ids for Express, Fastify, Koa and plain http.
PythonStandard-library logging in, searchable logs out. No runtime dependencies, Python 3.9+, with per-request correlation ids for FastAPI/Starlette, Flask/WSGI and Django.
.NETThe non-blocking, bounded OTLP/JSON client on its own. netstandard2.1 and net8.0, no dependencies.
LiveKit
Collector packOpenTelemetry Collector config, Docker Compose service, Helm values and a metrics guide that ship a self-hosted LiveKit deployment to Logthread, with one room session read as one story.
Agents for PythonOne line in a LiveKit agent sends its traces, token and audio usage, latency metrics and correlated logs. Python 3.10+. Needs the Python logging SDK, so the command installs both.
Agents for Node.jsThe same one-line instrumentation for LiveKit Agents on Node.js 18+. Needs the Node.js logging SDK, so the command installs both.
Using Logthread
Get the full valueThe path from first logs to alerts with a channel, dashboards, pipelines and redaction, team and SSO, MCP and Pari, one step at a time.
Getting startedSign up, create a workspace and an ingest key, send your first logs, traces or metrics and find them in the app.
Send dataEvery way to send logs, traces and metrics: OTLP, Prometheus remote write, JSON lines, syslog, Fluent Forward and Fluent Bit, with limits, response codes and a checklist when nothing arrives.
Ingest keys and API keysCreate, revoke and rotate ingest keys (send-only) and API keys (scoped, for AI agents and automation), and what each can do.
KubernetesSend OTLP from your pods with the ingest key in a Secret, link logs to traces, and where cluster collection lives.
Explore and live tailSearch and filter logs, use facets and saved searches, follow a request across services and watch logs arrive live.
ThreadsFollow an order, user, job or request id through every service that logged it, as steps, with the ids connected to it, see how requests flow from message to message, and the fields that link your logs, found automatically.
Correlate logs and tracesPut trace and span ids on your logs with OpenTelemetry or the Logthread SDKs, follow one request across services and check it works.
DashboardsBuild a dashboard from a template or from scratch with panels, queries, expressions, variables, versions and JSON import and export.
Metrics and tracesChart metrics, find slow and failing traces, read the trace view and use the Database and Endpoints tabs.
Service mapSee what calls what across services, databases and external hosts, drill into the traces of a call, ask the topology graph for relationships and draw one request as a graph.
AlertsSet up alert rules, delivery channels and incidents.
Alert webhooksThe webhook alert payload, the X-Logthread-Signature check with Python and Node.js code, retries and testing.
Chart annotationsSee deploys, alert incidents and your own events as markers on time charts, and add them from the app, CI or MCP.
Pipelines and parsingParse, redact, drop and sample logs before they are stored.
Cost controlPlan limits, the daily cap, retention and rate limits, how to find what costs the most and how to send and store less.
SQL, KQL and AnalyzeWhich of the SQL console, KQL and Analyze to use to ask your logs, traces and metrics a question.
SQL consoleRead-only SQL over logs, traces and metrics: a cookbook with joins and charts, parameters, saved statements, slow queries and roles.
KQLQuery logs, spans and metrics with KQL: the verified constructs, tables and columns, how errors behave and what is not verified yet.
AnalyzePivot logs, spans and metrics by dimensions and measures without a query: a worked example, limits and measures.
ExportExport logs, traces, metrics or a SQL or KQL result as NDJSON or Parquet: sources, formats, limits and roles.
FleetConnect agents, write versioned collector configs with selectors, roll out and roll back from the app, and troubleshoot.
Team, usage and billingRoles, invitations, the usage page, plans and AI credits.
Roles and permissionsWhat Viewer, Member, Admin and Owner can do in the app and through MCP and API keys, and which actions only the app offers.
Single sign-onConnect Okta, Microsoft Entra ID, Google Workspace, OneLogin or JumpCloud: verified domains, enforced SSO, group roles and SCIM provisioning.
Data residencyWhich regions exist, where telemetry, settings and backups are stored, how a workspace gets its region and what leaves it.
Pari, your log angelThe AI assistant in Logthread: what she does, what is sent to its AI service, credits and how to turn her off.
Guides
Query languageFilter, parse, choose columns and aggregate your logs with the Logthread query language.
Parse logs at ingestTurn log lines into searchable fields at ingest: automatic JSON, every parse format and a library of ready-made parsers.
IntegrationsReady-made integrations for SQL Server, IIS, PostgreSQL, MySQL, Redis, MongoDB, Elasticsearch, Kafka, RabbitMQ, NGINX, Apache, Linux hosts, Docker and Podman, Kubernetes, Pipecat, AWS CloudWatch Logs, Cloudflare, Vercel, Heroku, Google Cloud, Microsoft Azure, Okta and GitHub: how each works, what you answer, the setup, permissions, and the dashboards and alerts it comes with.
What changed before an incidentReport deploys, config changes and flags from CI, and see the ones before each incident, scored and explained: how-to, API reference and SDK reference.
Incident memory and investigationThe fixed investigation on every incident, recording what happened, and past incidents with what fixed them.
Service ownershipRecord who owns each service, with contact and runbook, and merge names that are one service.
AI agents (MCP)Connect Claude Code, Cursor, VS Code and other AI agents to your logs, traces and metrics.
OpenTelemetry, any languageSend traces and metrics from Node.js, Python, Java, Go, .NET, Ruby or PHP with standard OpenTelemetry, and fill the Traces, Database and Endpoints views.
Zero-code tracing (eBPF)Trace services you cannot change with OpenTelemetry eBPF Instrumentation: install with docker run, Docker Compose, a Kubernetes DaemonSet, systemd or the Logthread Agent, verify it, troubleshoot and uninstall.
Docker hosts (fluentd driver)Send container logs from plain Docker or Compose hosts through an OpenTelemetry Collector to Logthread, with service names from container names, severity, verification and troubleshooting.
Private ingest (Enterprise)Send telemetry from services in OCI Mumbai to Logthread over a private network path, with the same endpoint, keys and certificate: how it works, setup with support and verification.
BenchmarksWhat was measured for ingest throughput, ingest lag, query latency, alert delay, dashboard refresh and SLOs, on which hardware, how to reproduce it, and what is not measured on production hardware yet.
.NET end to endInstrument an ASP.NET Core app, EF Core and SQL Server with Logthread, collect SQL Server, IIS and Windows Server with the Logthread Agent, and get ready dashboards and alerts.
Logthread AgentInstall the Logthread Agent on Linux, Windows, macOS or Docker: profiles for Windows Server, IIS, SQL Server, Linux hosts, containers and databases (NGINX, Apache, PostgreSQL, MySQL, Redis, MongoDB, Kafka, RabbitMQ, Elasticsearch), a local OTLP receiver, autotrace, Fleet mode and troubleshooting.