A fast, local, read-only MySQL & MariaDB binlog viewer, decoder, and transaction analyzer.
Explore Website » · Quickstart · Installation · Key Features · Remote Streaming · Safety & Trust · Configuration
When replication breaks, transactions blow up your storage, or data goes missing, database engineers are forced to reach for:
mysqlbinlog --verbose --base64-output=DECODE-ROWS mysql-bin.000124 | lessThat means parsing gigabytes of text streams, guessing transaction boundaries, manually hunting for rollback flags, and dealing with decoder discrepancies between tools.
Binsight transforms raw, opaque binlog bytes into a structured, searchable SQLite metadata index with a zero-latency local browser interface:
- ⚡ Indexed & Non-Blocking: Decode once into SQLite; virtualized tables navigate millions of events instantly without locking or freezing your browser.
- 🔍 Side-by-Side Decoder Diff: Cross-compare pure Go decoders (
go-mysql) against nativemysqlbinlogoutput with per-field divergence highlighting. - 🚨 Automated Anomaly Detection: 6 built-in forensic detectors flag huge transactions, rolled-back writes, bulk row mutations, and position wrap boundaries.
- 📡 Live Replica Streaming: Mirror binlog events directly from running MySQL/MariaDB instances using the native replication protocol.
- 🔒 Safe By Default: 100% read-only, loopback
127.0.0.1binding, zero telemetry, zero CGO, and zero outbound network calls.
Filterable event stream with transaction grouping, before/after row image inspection, and inline anomaly alerts.
Point Binsight at any folder containing binary log files:
binsight serve /var/lib/mysqlOpen http://localhost:8080 in your browser.
Don't have binlogs handy? Download our prepared sample corpus:
mkdir -p samples && curl -L https://github.com/adrijshikhar/binsight/releases/latest/download/sample-binlog.tar.gz | tar -xz -C samples
binsight serve samplesbrew install adrijshikhar/tap/binsightAutomatically detects OS (Darwin / Linux) and architecture (amd64 / arm64), verifies SHA-256 checksums, and installs cleanly to ~/.local/bin without requiring sudo:
curl -fsSL https://raw.githubusercontent.com/adrijshikhar/binsight/main/install.sh | shOptions: Set BINSIGHT_VERSION=v0.2.0 to pin a specific version, or BINSIGHT_INSTALL_DIR=/usr/local/bin to customize destination.
Run standalone without installing Go:
docker run --rm -p 8080:8080 -v /path/to/binlogs:/data \
ghcr.io/adrijshikhar/binsight:0.2.0 serve /datago install github.com/adrijshikhar/binsight/cmd/binsight@v0.2.0Direct compiled binaries are available for every release on the Releases Page:
- macOS Apple Silicon (
darwin_arm64) & Intel (darwin_amd64) - Linux 64-bit (
linux_amd64) & ARM64 (linux_arm64)
When investigating corrupt rows or replication drift, discrepancies between parser implementations can lead to false conclusions. Binsight parses events using both internal decoders (go-mysql) and external native mysqlbinlog, highlighting field-level differences side-by-side:
Binsight continuously inspects transaction boundaries and event metadata for 6 critical operational anomalies:
| Detector | Trigger Criteria | Operational Impact |
|---|---|---|
| Huge Transaction (Bytes) | Exceeds byte threshold (default 50 MiB) |
Risk of replication lag, OOM, or disk saturation |
| Huge Transaction (Rows) | Row mutation count exceeds threshold (default 10,000) |
Lock contention, long-running buffer pool hold |
| Long-Running Transaction | Wall-clock span between BEGIN and XID > threshold (default 60s) |
Replica lag accumulation, undo log bloat |
| Rolled-Back Transaction | Explicit rollback or transaction boundary abort | Failed application writes consuming binlog capacity |
| Bulk Row Mutation | Single WRITE_ROWS / UPDATE_ROWS event > threshold |
Massive batch updates bypassing safe pagination |
| Position Wrap (> 4 GiB) | File position crosses |
Critical pos_wrap risk for older 32-bit tooling |
Per-file metrics breakdown including event distributions, size breakdowns, TPS throughput, and hottest tables:
- Hex Inspection: Raw byte offset viewer overlaid with structured binlog event header layouts (timestamp, type, server ID, event length, next position, flags).
- Schema / DDL Timeline: Chronological log of
CREATE,ALTER,DROP, andTRUNCATEstatements with cascade risk warnings. - Live SSE Tail: File watching via
fsnotifypushes real-time event commits straight to the browser without re-scanning files.
Instead of manually exporting binlog files from production instances, Binsight can act as a lightweight replica over the MySQL replication protocol:
┌─────────────────────────┐ MySQL Replication Protocol ┌─────────────────────────┐
│ Live MySQL / MariaDB │ ───────────────────────────────────────────> │ Binsight Streamer │
│ Source Server │ (COM_BINLOG_DUMP / GTID) │ (Stores in local spool) │
└─────────────────────────┘ └────────────┬────────────┘
│
┌────────────▼────────────┐
│ SQLite Metadata Index │
│ + Real-Time Browser UI │
└─────────────────────────┘
- Create a dedicated read-only replication user on the source:
CREATE USER 'binsight'@'%' IDENTIFIED BY 'strong_password';
GRANT REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'binsight'@'%';- Start Binsight with streaming enabled:
BINSIGHT_STREAM_ENABLED=true \
BINSIGHT_STREAM_HOST=mysql.internal \
BINSIGHT_STREAM_USER=binsight \
BINSIGHT_STREAM_PASSWORD=strong_password \
binsight serve /dataSupports GTID auto-reconnect (gtid_mode=ON) and file-offset resume at clean transaction boundaries.
Binsight was engineered from day one for strict security and isolation in production environments:
- 🔒 100% Read-Only Operation: Binsight never writes to source database tables or binlog files.
- 🏠 Loopback Binding by Default: Server binds strictly to
127.0.0.1. Remote traffic cannot access your UI unless explicitly overridden withBINSIGHT_BIND=0.0.0.0. - 🚫 Zero External Telemetry: No phone-home beacons, tracking scripts, Google Analytics, or third-party cookies.
- 📦 Pure Go & Zero CGO: Single static binary compiled with zero external C runtime dependencies.
Tested against official database engines in automated CI test matrices:
| Engine | Verified Versions | Protocol / Format |
|---|---|---|
| MySQL | 5.5, 5.6, 5.7, 8.0, 8.4 LTS |
Row-Based (RBR), Statement (SBR), Mixed, GTID |
| MariaDB | 10.6 LTS, 11.4 LTS |
MariaDB Binlog format & GTID event types |
All parameters can be configured via environment variables or CLI flags:
| Environment Variable | Default | Description |
|---|---|---|
BINSIGHT_PORT |
8080 |
HTTP listen port for the web console |
BINSIGHT_BIND |
127.0.0.1 |
Bind address. Defaults to loopback for security. Set 0.0.0.0 to expose externally |
BINSIGHT_DATA_DIR |
/var/lib/binsight |
Location for SQLite metadata index and spool files (~/.binsight locally) |
BINSIGHT_WATCH_DIR |
/data |
Binlog directory to scan (overridden by binsight serve <dir>) |
BINSIGHT_WATCH |
true |
Enable live filesystem watching (fsnotify) for incoming events |
BINSIGHT_MYSQLBINLOG_PATH |
mysqlbinlog |
Path to mysqlbinlog executable (required for Diff comparison adapter) |
BINSIGHT_STREAM_ENABLED |
false |
Enable live remote replication streaming from a database host |
BINSIGHT_STREAM_HOST |
(unset) | Remote MySQL/MariaDB server host |
BINSIGHT_STREAM_PORT |
3306 |
Remote MySQL/MariaDB server port |
BINSIGHT_STREAM_USER |
(unset) | Replication username |
BINSIGHT_STREAM_PASSWORD |
(unset) | Replication password |
BINSIGHT_STREAM_FLAVOR |
mysql |
Protocol flavor: mysql or mariadb |
BINSIGHT_STREAM_SERVER_ID |
51789 |
Replica server ID (must be unique on the replication topology) |
BINSIGHT_STREAM_MAX_SPOOL_BYTES |
2147483648 |
Maximum disk size for mirrored spool (default 2 GiB, oldest pruned) |
┌───────────────────────────┐
│ Binlog Source Files │
│ (Disk or Remote Spool) │
└─────────────┬─────────────┘
│
┌─────────────▼─────────────┐
│ Pluggable Decoder Engine │
│ (go-mysql / mysqlbinlog) │
└─────────────┬─────────────┘
│
┌─────────────▼─────────────┐
│ SQLite Metadata Index │
│ (Transactions, DDL, Pos) │
└─────────────┬─────────────┘
│
┌─────────────▼─────────────┐
│ Go HTTP Server (Chi/SSE) │
└─────────────┬─────────────┘
│
┌─────────────▼─────────────┐
│ Embedded React 19 UI │
│ (Mantine 9, Vite) │
└───────────────────────────┘
For more details on adapter interfaces and capability negotiation, see docs/pluggable-architecture.html.
Contributions are welcome! See CONTRIBUTING.md for development workflows, testing guidelines, and environment setup.
# Clone and build the full binary with embedded web UI
git clone https://github.com/adrijshikhar/binsight.git
cd binsight
# Build web frontend
make ui
# Run tests with race detector
go test -race ./...
# Start development server
go run ./cmd/binsight serve samples/Binsight is open-source software licensed under the MIT License.
Copyright © 2026 Adrij Shikhar.


