// docs

Reference & guides.

Pick a starting point or search above.

// start here
start here

Get started

Set up your first project and send your first log.

general

Query syntax

Filter and search logs with the query language.

web-analytics

Add Web Analytics

Drop a single <script> tag — pageviews, custom events, vitals in minutes.

datasets

Use Datasets

Define typed event tables, ingest records, and query them with DuckDB-backed APIs.

cli

Install the CLI

Ship logs from any terminal, script, or CI pipeline.

tui

Run the TUI

A keyboard-driven console for live logs, alerts, pins, and docs.

mcp

Connect via MCP

Integrate Loguro with Claude and other AI agents.

// integrations external tools & surfaces
// general

General

4
Getting Started Install Loguro and send your first log in under 5 minutes.
Query Syntax Master the filter bar — search, filter, and run commands against your logs.
Alerting Configure cooldown-based alerts to notify via email, Slack, Discord, or custom webhooks.
Integrations Connect Slack, Discord, Telegram, and issue trackers to act on logs without leaving Loguro.
// commands

Commands

35
--count Show the total number of logs matching your current filters.
--top Find the most common values for any field in your logs.
--unique Count distinct values for any field in your logs.
--rate Visualize log rate over time for the current filter scope.
--diff Compare log patterns between two time periods to detect anomalies.
--downloads Export logs as CSV or Parquet and manage your exports.
--replay Replay logs for the current time range at adjustable speed.
--live Toggle the live log stream on or off.
--group Enable log pattern grouping to collapse similar log lines.
--alerts Create and manage project alerts from the filter bar.
--views Save, load, and manage named filter views.
--keys Create and manage API keys for log ingestion.
--channels Manage notification channels for alerts and messages.
--embed::status Create and manage status embed widgets for external sites.
--billing View your subscription and upgrade your plan.
--usage View your current quota and usage statistics.
--integrations::config Configure messaging and issue tracker integrations for a project.
--send Send a log summary or message to Slack, Discord, or Telegram from the filter bar.
--task Create and list issues in Jira, Linear, or GitHub directly from the filter bar.
--slow Find logs where the request or operation duration exceeded a threshold.
--sample Pull a random sample of logs matching your current filters.
--memory Search logs stored in forever memory — survives log retention.
--chart Visualize log volume over time for the current filter set.
--timeline Show a chronological timeline of logs matching your current filters.
--notifications View and delete your project notifications from the filter bar.
--severity Show a severity distribution breakdown for logs matching your current filters.
--separate::message Extract and display JSON context embedded in log message strings.
--no-group Disable log pattern grouping to see every log entry individually.
#view Expand a saved filter view by name using the hashtag shortcut.
--investigate Analyze a log with AI to identify root cause and get a suggested fix.
--explain Get a plain-language explanation of what a log entry means.
--notes List and search notes attached to logs in the current project.
--share:md Share a log as a public markdown link including trace and AI investigation.
--slack Send a Slack alert with your current filter context.
--trace:full Show all logs in a trace as a chronological timeline.
// features

Features

8
Saved Views Save and reuse filter queries as named views across your project.
Log Export Export filtered logs as CSV or Parquet files for offline analysis.
Embed Widgets Embed a live heartbeat status indicator on any external site.
Log Replay Replay a historical log window as a live stream at adjustable speed.
Issue Tracker Integration Create Jira, Linear, and GitHub issues directly from log entries.
Messaging Integrations Send log summaries and notifications to Slack and Discord.
Heartbeat Monitoring Monitor service health by sending periodic heartbeat logs and embedding live status on external sites.
Memory & Forever Logs Logs saved when creating issues survive retention and are permanently searchable.
// web-analytics

Web Analytics

14
Web Analytics — Getting Started Privacy-respecting pageviews, custom events, and Core Web Vitals from a single script tag. No cookies required, no consent banner needed by default.
Install & Configure Every data-* attribute on the loguro.js script tag — what it does, defaults, and when to change it.
Custom Events Two ways to track custom events — Loguro.track() from JavaScript, or [data-loguro-event] attributes for marketing teams without writing code.
Core Events Built-in UX signal events the SDK can fire automatically — rage clicks, dead clicks, form abandons, scroll milestones, slow routes, copy/print/download intents, back-to-search.
Pageviews & SPA How initial pageviews, SPA route changes, time-on-page, and scroll depth are tracked. Works with React Router, Next.js App Router, SvelteKit, Vue Router, etc.
Identity & Sessions How visitor_id, session_id, and user_id work — storage strategies, session expiry, identify() flows, reset() on logout.
Privacy & Consent Do Not Track, cookie-consent flows, GDPR posture, what the SDK never collects. Choose between cookie-less mode, opt-in, or full tracking.
API Reference Every method on window.Loguro — info, error, track, pageview, identify, reset, setEnabled. With signatures, examples, and edge cases.
Query API Read Loguro web analytics from your own app with a PAT: KPIs, timeseries, top pages, visitors, recent events, custom events, and sessions.
Troubleshooting Common SDK problems — events not arriving, CORS / ORB errors, sendBeacon failures, rate limit drops, debug mode.
Dashboard Overview What you see in the /web-analytics page — KPI strip, big chart with visitor pins, world map, panels for pages/referrers/countries/devices, live activity, custom events.
Filtering the Dashboard Filter syntax for the web-analytics dashboard — path, country, device, browser, OS, visitor_id, event_type, custom_event_name, free-text search, plus natural-language time ranges via from:/to:/@chrono. With OR, negation, and quoted values.
Visitor Detail Drawer Full visit history per visitor — sessions, page navigation, custom events, error/warning logs, Core Web Vitals, deep link to the logs page filtered to this visitor.
Web Vitals in the Dashboard How Core Web Vitals (LCP, FID, INP, CLS, FCP) are captured and surfaced — color-coded badges per page, median per visitor, Google threshold rules.
// datasets

Datasets

8
Getting Started Create project datasets, register a schema per dataset, ingest strict records, and query them separately from logs and web analytics.
TypeScript SDK Use @loguro/datasets to define schemas, ingest records, and query datasets with inferred TypeScript types.
Authentication Which token to use for dataset metadata, schema management, ingest, and querying.
Schema How to define the immutable typed contract for a dataset.
Ingest API Send single or batched dataset records with strict schema validation.
Query API Query typed dataset fields with filters, groups, aggregates, ordering, and limits.
Storage, Quotas, and Isolation How dataset data is stored, metered, compacted, and kept separate from logs and web analytics.
Troubleshooting Common dataset schema, ingest, query, quota, and authentication errors.