stern/stern
Stern
Stern is a Kubernetes command-line debugging tool and log aggregator designed for streaming and filtering logs from multiple pods and containers. It functions as a log tailing utility that consolidates real-time data from distributed resources into a single, color-coded output.
The tool uses regular expressions to select pods and filter log content, allowing for the isolation of specific system events. It automatically tracks the lifecycle of resources, using a watch mechanism to attach to new pods that match filter criteria and removing deleted ones from the active view.
Capabilities include filtering log streams by Kubernetes metadata, labels, and namespaces, as well as restricting output to specific resource types like deployments or jobs. The utility provides options for template-driven output formatting, content highlighting, and the ability to parse local logs from standard input.
Features
- Log Aggregation - Consolidates real-time log streams from multiple distributed pods and containers into a single output.
- Container Log Streaming - Provides real-time streaming and filtering of logs from multiple pods and containers within a Kubernetes cluster.
- Kubernetes Workload Label Filters - Restricts output based on labels, namespaces, or status conditions to isolate specific resources in large environments.
- Log-Based Debugging - Enables isolating errors across cluster resources using metadata filters and regular expressions.
- Resource Pattern Selection - Identifies and tracks pods by matching resource names against regular expression patterns for dynamic stream management.
- Dynamic Resource Watching - Uses the Kubernetes watch API to automatically detect and attach to new pods matching filter criteria.
- Dynamic Pod Pattern Tracking - Maintains an accurate resource list by selecting pods using regular expressions and automatically tracking new items.
- Asynchronous Log Streaming - Utilizes asynchronous log streaming to maintain persistent connections to multiple pods simultaneously.
- Log Event Filters - Isolates relevant information by including or excluding log lines that match specific regular expression patterns.
- Distributed Log Aggregation - Unifies log streams from multiple distributed Kubernetes resources into a color-coded view.
- Distributed Monitoring Tools - Provides tools for tracking log output across distributed sets of pods in real time.
- Log Event Filtering - Isolates relevant system events by filtering log streams based on specific nodes, container states, or pod conditions.
- Kubernetes Stream Tailing - Streams and filters logs from multiple pods and containers using regular expressions.
- Log Stream Management - Manages continuous log streams by automatically adding new resources and removing deleted ones from the active view.
- Deployment Log Filters - Narrows the search scope by restricting log output to specific resource types like deployments or jobs.
- Namespace-Based Log Filtering - Filters massive amounts of container output by namespaces, labels, and content patterns.
- Real-Time Application Log Monitoring - Streams data from multiple Kubernetes sources simultaneously with color coding for real-time debugging.
- Integrated Kubernetes Debugging Tools - Provides a single-interface CLI for streaming logs and monitoring Kubernetes workloads.
- Log Output Templates - Processes log lines through a customizable engine to apply colors and structure based on metadata.
- Stream Multiplexing - Aggregates multiple asynchronous log streams from different containers into a single synchronized output stream.
- Log Output Formatting - Transforms log data into raw text, JSON, or custom templates to control output formatting.
- Regex-Based Log Filtering - Uses regular expressions to include or exclude specific log content from Kubernetes streams.
- Log Syntax Highlighting - Accelerates visual scanning by marking specific strings and distinguishing data sources using configurable colors.
- Command Line Tools - Tails logs from multiple pods and containers simultaneously.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
