# simpledatalogs

> The simplest dashboard for your app's events and logs

POST a JSON event or a log line with one key. Counters, charts, devices and searchable logs build themselves.

## Table of Contents

### Getting started

- [Introduction](https://simpledatalogs.com/docs/guide/introduction.md): What simpledatalogs is, what it is for, and how data flows from your app to the dashboard.
- [Quick start](https://simpledatalogs.com/docs/guide/quick-start.md): Create a key and send your first event and log line with curl in about two minutes.
- [Core concepts](https://simpledatalogs.com/docs/guide/concepts.md): Organizations, projects, environments, deployments, ingest keys, and the difference between events and log lines.
- [Boards](https://simpledatalogs.com/docs/guide/boards.md): Build dashboard boards that answer feature questions — how many users, what share of users, of those who did A how many did B — from the events your app already sends.
- [Feature discovery](https://simpledatalogs.com/docs/guide/feature-discovery.md): Find out whether users discover a feature, how they reach it and whether it works for them, with three question widgets and no setup, shown on a real Mac screenshot app.
- [Web analytics](https://simpledatalogs.com/docs/guide/web-analytics.md): Visitors, visits, bounce rate, sources, journeys and funnels for your website, without cookies, next to your logs and events.
- [Share links and installs](https://simpledatalogs.com/docs/guide/share-links.md): Count how many people your users' shared links brought in, and which installs came from which share, with share_id and app_installed.
- [App and Issues](https://simpledatalogs.com/docs/guide/observability.md): Requests, jobs, scheduled tasks, slow queries, outgoing calls, traces and grouped exceptions for your app, next to its logs and events.
- [Alerts and channels](https://simpledatalogs.com/docs/guide/alerts.md): Threshold alerts by email, and on paid plans in Slack, Discord or a signed webhook, with the payload and how to check its signature.
- [Spend](https://simpledatalogs.com/docs/guide/spend.md): Price what you pay per call, such as an LLM or SMS API, and see the spend by day, deployment and price line from exact counts.
- [Public counters](https://simpledatalogs.com/docs/guide/public-counters.md): Publish one number from your events, like app installs all time or screenshots taken in the last 7 days, as JSON or an embeddable badge.
- [Import from GA4](https://simpledatalogs.com/docs/guide/ga4-import.md): Bring your Google Analytics 4 history into simpledatalogs by CSV or Google sign-in, shown beside your own numbers and marked as imported.
- [Exports](https://simpledatalogs.com/docs/guide/exports.md): Download events and log lines as gzipped CSV or JSON lines, and on Scale write them every hour or day to your own S3, R2, B2 or MinIO bucket.

### Quickstarts

- [Next.js](https://simpledatalogs.com/docs/quickstarts/nextjs.md): Add simpledatalogs to a Next.js app in one minute, with page views, sessions and errors captured by one line.
- [React (Vite)](https://simpledatalogs.com/docs/quickstarts/react-vite.md): Add simpledatalogs to a React app on Vite in one minute, with page views, sessions and errors captured by one line.
- [Vue and Nuxt](https://simpledatalogs.com/docs/quickstarts/vue-nuxt.md): Add simpledatalogs to a Vue (Vite) or Nuxt app in one minute, with page views, sessions and errors captured by one line.
- [SvelteKit](https://simpledatalogs.com/docs/quickstarts/sveltekit.md): Add simpledatalogs to a SvelteKit app in one minute, with page views, sessions and errors captured by one line.
- [Plain HTML (script tag)](https://simpledatalogs.com/docs/quickstarts/html.md): Add simpledatalogs to any website with one script tag; visitors, page views, clicks and errors are captured automatically, without cookies.
- [Node](https://simpledatalogs.com/docs/quickstarts/node.md): Send events, logs and crashes from Node to simpledatalogs in one minute, with pino and winston recipes.
- [React Native / Expo](https://simpledatalogs.com/docs/quickstarts/react-native.md): Send events, sessions and crashes from a React Native or Expo app to simpledatalogs with the JavaScript SDK.
- [iOS and macOS (Swift)](https://simpledatalogs.com/docs/quickstarts/ios-swift.md): Add simpledatalogs to an iOS or macOS app with the Swift SDK, with launches, sessions and crashes captured by one argument.
- [Laravel](https://simpledatalogs.com/docs/quickstarts/laravel.md): Send events, Eloquent model changes, sign-ins and logs from Laravel to simpledatalogs in one minute, without cron.
- [Flutter](https://simpledatalogs.com/docs/quickstarts/flutter.md): Add simpledatalogs to a Flutter app with the simpledatalogs_flutter package, with launches, sessions, errors and screen views captured by one argument.
- [Android (Kotlin)](https://simpledatalogs.com/docs/quickstarts/android.md): Add simpledatalogs to an Android app with the Kotlin SDK, with launches, sessions, crashes and screen views captured by one argument.
- [Unity](https://simpledatalogs.com/docs/quickstarts/unity.md): Add simpledatalogs to a Unity game with the Unity package, with launches, sessions, scene views and errors captured by one argument.
- [Python (Django, Flask and FastAPI)](https://simpledatalogs.com/docs/quickstarts/python.md): Send events and log lines from Django, Flask, FastAPI or any Python process to simpledatalogs in one minute.
- [Go](https://simpledatalogs.com/docs/quickstarts/go.md): Send events and slog records from Go to simpledatalogs in one minute.
- [Rails](https://simpledatalogs.com/docs/quickstarts/rails.md): Send events and Rails log lines to simpledatalogs with a small HTTP recipe and a logger device.

### Ingest API

- [Sending data](https://simpledatalogs.com/docs/api/ingest.md): The ingest endpoint, authentication, Content-Type and Content-Encoding, body shapes, browsers and CORS, and the other paths ingest serves.
- [Events and log objects](https://simpledatalogs.com/docs/api/events.md): Every field of an event or log object, field aliases from logging libraries, identity fields, props and validation limits.
- [Telemetry objects](https://simpledatalogs.com/docs/api/telemetry.md): Send requests, jobs, scheduled tasks and commands with their queries, outgoing calls and exceptions as telemetry objects on the same ingest endpoint.
- [Text log lines](https://simpledatalogs.com/docs/api/log-lines.md): Send text/plain log lines in any common format; JSON, Monolog, syslog, access logs, logfmt and timestamp-first lines are recognized, and stack traces join their entry.
- [Text templates and Unparsed](https://simpledatalogs.com/docs/api/templates.md): Read your own text line layout with a typed per-deployment template, and use the Unparsed bin to fix and re-read data that didn't fit.
- [Responses](https://simpledatalogs.com/docs/api/responses.md): Every status code ingest answers, its body, what it means, and exactly what your client must do next.
- [Writing a sender](https://simpledatalogs.com/docs/api/sender-rules.md): The six rules every client follows (batching, a durable outbox, backoff with jitter, event_id and ts, failing open, a User-Agent), with a reference implementation.

### Integrations

- [Integrations](https://simpledatalogs.com/docs/integrations.md): Switch from OpenTelemetry, Segment, Sentry, Datadog logs, Loki, Splunk HEC, Vector or Fluent Bit by changing an endpoint and a key, drain Vercel, Heroku, Fly.io and Cloudflare logs, turn webhooks into events, or count OpenRouter's LLM calls.
- [OpenTelemetry logs](https://simpledatalogs.com/docs/integrations/opentelemetry.md): Send OpenTelemetry logs over OTLP/HTTP (protobuf or JSON, gzip) from any OpenTelemetry SDK or the Collector.
- [Vector and Fluent Bit](https://simpledatalogs.com/docs/integrations/log-shippers.md): Ship log files with Vector or Fluent Bit to /v1/ingest as gzipped NDJSON, with event ids so retries count once.
- [Segment](https://simpledatalogs.com/docs/integrations/segment.md): Point Segment's server SDKs at simpledatalogs by changing the API host and using the ingest key as the write key.
- [Sentry](https://simpledatalogs.com/docs/integrations/sentry.md): Change only the Sentry DSN, and errors, messages and structured logs from any Sentry SDK arrive as countable log lines, with errors grouped into Issues.
- [Datadog logs](https://simpledatalogs.com/docs/integrations/datadog.md): Point the Datadog Agent, Vector or Fluent Bit logs output at simpledatalogs and use the ingest key as the API key.
- [Loki](https://simpledatalogs.com/docs/integrations/loki.md): Use simpledatalogs as a Loki push URL from Promtail, Grafana Alloy, Vector or Fluent Bit, with the ingest key as a bearer token or password.
- [Splunk HEC](https://simpledatalogs.com/docs/integrations/splunk.md): Use simpledatalogs as a Splunk HEC endpoint from Vector, the OpenTelemetry Collector or Fluent Bit, with the ingest key as the HEC token.
- [PostHog, Mixpanel and Amplitude](https://simpledatalogs.com/docs/integrations/payload-shapes.md): PostHog, Mixpanel and Amplitude event shapes are understood on /v1/ingest; post them with an ingest key.
- [Vercel](https://simpledatalogs.com/docs/integrations/vercel.md): Send Vercel runtime, build and request logs to simpledatalogs with a signed Log Drain, deduped on Vercel's own log ids.
- [Heroku](https://simpledatalogs.com/docs/integrations/heroku.md): Send Heroku app, router and platform logs to simpledatalogs with an HTTPS log drain, router lines as structured fields.
- [Fly.io](https://simpledatalogs.com/docs/integrations/fly.md): Ship Fly.io app logs to simpledatalogs with fly-log-shipper and a Vector sink, with ids so retries count once.
- [Cloudflare](https://simpledatalogs.com/docs/integrations/cloudflare.md): Send Cloudflare HTTP request logs and Workers trace events to simpledatalogs with a Logpush job to an HTTP destination.
- [Inbound webhooks](https://simpledatalogs.com/docs/integrations/webhooks.md): Turn Stripe, Buy Me a Coffee, Lemon Squeezy, Paddle, Gumroad, Ko-fi, Patreon, GitHub, Typeform, Tally or any JSON webhook into events, signed and deduped.
- [OpenRouter](https://simpledatalogs.com/docs/integrations/openrouter.md): Send OpenRouter's Broadcast traces to simpledatalogs, so every LLM call becomes an llm_call event with model, provider, tokens, cost and latency.
- [WordPress](https://simpledatalogs.com/docs/integrations/wordpress.md): The simpledatalogs WordPress plugin; cookie-free page views, opt-in autocapture, server-side events for users, comments and WooCommerce, and how it handles privacy.
- [Shopify](https://simpledatalogs.com/docs/integrations/shopify.md): The simpledatalogs Shopify app; a web pixel that sends storefront and checkout events with no theme edits, only with analytics consent and without personal data.

### SDKs

- [JavaScript](https://simpledatalogs.com/docs/sdks/javascript.md): The simpledatalogs JavaScript SDK for browsers, extensions, React Native and Node; install, track events, log lines and exceptions, identity, flushing, offline behaviour, caps and every option.
- [Swift](https://simpledatalogs.com/docs/sdks/swift.md): The SimpleDataLogs Swift package for macOS and iOS apps; install, configure, track, back-dated events, opt-out, flush and disable, sessions, crash redaction, the crash-safe outbox, lifecycle and caps.
- [Laravel](https://simpledatalogs.com/docs/sdks/laravel.md): Track events, Eloquent model changes and sign-ins, forward Laravel log channels, and record requests, jobs, queries and exceptions in simpledatalogs through a disk outbox, with event ids so everything counts once.
- [Flutter and Dart](https://simpledatalogs.com/docs/sdks/flutter.md): The simpledatalogs packages for Flutter apps and Dart servers; install, configure, track, screen views, errors, the opt-out, the crash-safe outbox and caps.
- [Android](https://simpledatalogs.com/docs/sdks/android.md): The simpledatalogs Android and Kotlin SDK; install, configure, track, autocapture, the opt-out, WorkManager, the JVM server client, the crash-safe outbox and caps.
- [Unity](https://simpledatalogs.com/docs/sdks/unity.md): The simpledatalogs Unity package for games and apps; install by git URL or OpenUPM, configure, track game events, autocapture sessions, scenes and errors, the opt-out, the outbox and caps.
- [Python](https://simpledatalogs.com/docs/sdks/python.md): The simpledatalogs Python package for servers, workers and scripts; install, track events, send log records, Django, Flask, FastAPI, the disk outbox, delivery and caps.
- [Go](https://simpledatalogs.com/docs/sdks/go.md): The simpledatalogs Go module for services, workers and CLIs; install, track events, a slog handler, Flush and Close, delivery and caps.

### MCP server

- [MCP server](https://simpledatalogs.com/docs/mcp.md): The simpledatalogs MCP server lets Claude, ChatGPT, Grok, Cursor and other AI assistants read your event counts and logs, and lets a coding agent set up projects and keys.
- [Connecting clients](https://simpledatalogs.com/docs/mcp/clients.md): Step-by-step setup of the simpledatalogs MCP server in Claude, ChatGPT, Grok, Claude Code, Cursor, any mcp.json client and the xAI API.
- [Tools reference](https://simpledatalogs.com/docs/mcp/tools.md): Every tool on the simpledatalogs MCP server, the read-only ones and the setup tools, with their inputs, outputs and limits.

### Coding agents

- [Set up with a coding agent](https://simpledatalogs.com/docs/agents.md): Let a coding agent add simpledatalogs to your app with the setup prompt, /llms.txt and these docs as Markdown.
- [AGENTS.md snippet](https://simpledatalogs.com/docs/agents/agents-md.md): A snippet to paste into AGENTS.md or CLAUDE.md, so every coding agent in your repo tracks events the simpledatalogs way.
- [Prompt recipes](https://simpledatalogs.com/docs/agents/recipes.md): Ready-to-paste prompts for coding agents to add simpledatalogs to Laravel, iOS and macOS, websites, Node, OpenTelemetry and Sentry setups, and to read numbers back over MCP.

### Reference

- [Privacy for senders](https://simpledatalogs.com/docs/reference/privacy.md): What senders should never send, what simpledatalogs masks or drops for you, how emails in identity fields become pseudonyms, and how to erase data.
- [Plans and limits](https://simpledatalogs.com/docs/reference/limits.md): Plans, monthly quotas and what happens past them, retention, and every request, event and MCP limit in one place.
- [Troubleshooting](https://simpledatalogs.com/docs/reference/troubleshooting.md): Fix common problems by the answer you get from ingest, and by what you see, or don't see, on the dashboard.