Cluster Logs
Queries Kubernetes pod and node journald logs in VictoriaLogs using LogsQL for rapid cluster troubleshooting.
Cluster Logs provides an efficient interface to query VictoriaLogs for Kubernetes pod logs and systemd journald entries shipped by Vector across your cluster. Designed for homelab and home-ops environments, it executes LogsQL queries via a lightweight wrapper that formats responses into concise tab-separated text or raw JSON. This compact formatting minimizes token usage in your context window while facilitating deep-dive investigations into pod crash loops, OOMKilled events, HTTP error spikes, and underlying node issues.
Key Features
010 GitHub stars
02Enables piping into standard UNIX tools like grep, cut, sort, and uniq
03Supports time duration filters, result limits, and raw JSON export
04Authenticates securely via static bearer tokens or dynamic Authentik OAuth2 credentials
05Executes LogsQL queries against VictoriaLogs or Grafana datasource proxy endpoints
06Aggregates Kubernetes container logs and node journald entries into concise tab-separated text
Use Cases
01Tracing failed HTTP requests and connection timeouts across microservices in a namespace
02Diagnosing node-level systemd journald failures, network interruptions, or OS-level errors
03Investigating Kubernetes pod restart loops, OOMKilled events, and container error spikes