Logchef 2.1 makes the Explorer usable on sources with hundreds or thousands of fields, adds eleven interface languages, and ships a Helm chart. There are no database migrations; read the upgrade notes for a few behavior changes.
Highlights
Fast on wide schemas. The results table, Fields sidebar, and Group by picker no longer render every field in the schema. On wide VictoriaLogs sources:
| Before | v2.1.0 | |
|---|---|---|
| First rows, 3,000-field source | 42 s | 1.6 s |
| Memory, 1,000 rows with all columns shown | 1.8 GB | 73 MB |
| Switch to 1,000 rows per page | 17 s | 0.4 s |
| Open Group by | 8 s | 0.09 s |
Medians of five runs on one machine. Method and fixtures: frontend/docs/table-performance.md.
Eleven languages. English, Chinese (Simplified and Traditional), Spanish, French, German, Brazilian Portuguese, Japanese, Korean, Hindi, and Italian, under Settings → Preferences. The choice is saved to your account. Non-English translations are first drafts; corrections are welcome.
Helm chart. deployment/helm deploys Logchef with Dex and ClickHouse, with optional Ingress or Gateway API routes.
Added
ai.reasoning_effortfor reasoning-capable Bedrock models (nonetomax). AI requests can now run for up to 90 seconds.- Show more in the Fields sidebar, which now lists 100 fields at a time. Search covers all fields.
- Searchable Group by picker.
Changed
- The table renders only the columns in view, and cell actions appear on hover or focus instead of on every cell (#104, #107).
- VictoriaLogs sources show six columns by default. New fields from a query are no longer added as visible columns.
- "Rows read" and "bytes read" report what ClickHouse scanned, not the number of rows returned.
- LogchefQL results include their parsed conditions, removing a second translate request per query.
- Cancelled and timed-out queries return
408instead of500. - Histograms over 5,000 buckets or 16 MiB are rejected with a hint to widen the interval, instead of returning partial results.
Fixed
- Large integers and precise decimals are no longer rounded in the browser.
- Timestamps keep nanosecond precision in sorting, surrounding logs, and field values.
- LogchefQL keeps number literals exact, compiles
= nulland!= nullto null checks, and rejects malformed queries instead of dropping conditions. - ClickHouse JSON, Dynamic, Variant, map, and byte-array values render the same in buffered and streamed results.
- Enum fields show their values, including empty ones, in the sidebar.
logchef_query_totalno longer counts each query twice.- VictoriaLogs alerts read the metric value instead of a label (#105).
- Live tail keeps up with bursts of rows that share a timestamp.
- Saved queries: "Save as new" always creates a new query, double-clicking Save no longer creates duplicates, and template variables are escaped correctly.
- Log rows open their detail panel on click again.
- Short column names such as
levelare no longer truncated to one letter. - The ClickHouse source form's auth toggle works again.
- Sidebar fields you collapse stay collapsed while others load.
Upgrade notes
- No database migrations.
- VictoriaLogs column visibility resets once. Visibility saved by older versions is discarded and replaced by the six-column default. Column order and widths are kept. ClickHouse sources are unaffected.
- Stricter LogchefQL. Quote numbers compared with string fields (
status_text="500").>,<, and~withnullare errors; use= nullor!= null. Update saved queries and alerts that rely on the old behavior. - SQL histograms using
GROUP BY,DISTINCT, or set operations must select the timestamp column explicitly. - Histogram concurrency.
query.max_concurrent_per_userandquery.max_concurrent_globalnow apply to previews and histograms separately. Histograms can return429under load. - Metrics.
logchef_query_totalroughly halves because of the double-count fix. Adjust dashboards and alerts. - Helm. The chart defaults are for evaluation. For production, pin
logchef.image.tag: v2.1.0and replace the default OIDC client secret and Dex demo users. - Building from source requires Go 1.26.
Thanks
@AndreyCreativecode for reporting and profiling the wide-schema slowdown (#106) and contributing the sidebar and Group by fixes in #107.
Install
docker pull ghcr.io/mr-karan/logchef:v2.1.0Binaries for Linux and macOS are attached below. Full changelog: https://logchef.app/changelog/#v2.1.0 · Diff: v2.0.2...v2.1.0