A CLI tool to view and summarize Kubernetes events with resource grouping and warning highlighting.
For detailed documentation, see the docs/ folder:
Usage | Configuration | Examples | Deployment | Development | Use Cases
kubectl get events |
kube-events |
|
|---|---|---|
| Output | Flat, unsorted list | Resource-grouped, warning-first display |
| Highlighting | None | Color-coded warnings with icons |
| Grouping | None | By resource, namespace, kind, or reason |
| Filtering | Limited (--field-selector) |
Namespace, kind, name, type, reason |
| Time window | Not supported | --since 5m, 1h, 24h |
| Output formats | Text only | Color, plain, JSON, Markdown, table |
| Summary | Not supported | Event counts, resource counts, warning ratio |
| Watch mode | --watch (raw) |
Filtered, formatted real-time stream |
| CI integration | Not designed for CI | JSON/Markdown output for pipelines |
# Homebrew
brew install somaz94/tap/kube-events
# Scoop (Windows)
scoop bucket add somaz94 https://github.com/somaz94/scoop-bucket
scoop install kube-events
# Krew (kubectl plugin)
kubectl krew install events2
# Binary (latest)
curl -sL https://github.com/somaz94/kube-events/releases/latest/download/kube-events_linux_amd64.tar.gz | tar xz
sudo mv kube-events /usr/local/bin/
# Binary (specific version)
curl -sL https://github.com/somaz94/kube-events/releases/download/v0.1.0/kube-events_0.1.0_linux_amd64.tar.gz | tar xz
sudo mv kube-events /usr/local/bin/
# From source
go install github.com/somaz94/kube-events/cmd@latest# Homebrew
brew update && brew upgrade kube-events
# Scoop
scoop update kube-events
# Krew
kubectl krew upgrade events2
# From source
go install github.com/somaz94/kube-events/cmd@latest# Homebrew
brew uninstall kube-events
# Scoop
scoop uninstall kube-events
# Krew
kubectl krew uninstall events2
# Manual
sudo rm /usr/local/bin/kube-events# Show all events from last 1 hour (default)
kube-events
# Show only Warning events
kube-events -t Warning
# Show events from specific namespace
kube-events -n production
# Show events for Pods only
kube-events -k Pod
# Show events from last 5 minutes
kube-events --since 5m
# Filter by resource name
kube-events -N api-server
# Filter by reason
kube-events -r BackOff,Unhealthy
# Group events by namespace
kube-events -g namespace
# Group events by kind
kube-events -g kind
# Group events by reason
kube-events -g reason
# All namespaces, JSON output
kube-events --all-namespaces -o json
# Summary only
kube-events -s
# Combine filters
kube-events -n prod -k Pod -t Warning --since 30m
# Watch events in real-time
kube-events -w -n production -t WarningPod/app-1 [default] (3 events)
! BackOff 2m Back-off restarting failed container
! Unhealthy 3m Readiness probe failed
Scheduled 5m Successfully assigned...
Deployment/api [default] (1 event)
ScalingUp 1m Scaled up replica set
Summary: 4 events, 2 resources | Warning: 2 | Normal: 2
| Flag | Short | Default | Description |
|---|---|---|---|
--kubeconfig |
~/.kube/config |
Path to kubeconfig | |
--context |
current | Kubernetes context | |
--namespace |
-n |
all | Filter by namespace (repeatable) |
--kind |
-k |
all | Filter by involved object kind |
--name |
-N |
all | Filter by involved object name |
--type |
-t |
all | Event type: Normal, Warning |
--reason |
-r |
all | Event reason (e.g., BackOff) |
--since |
1h |
Show events newer than duration | |
--output |
-o |
color |
Format: color, plain, json, markdown, table |
--group-by |
-g |
resource |
Group by: resource, namespace, kind, reason |
--summary-only |
-s |
false |
Show summary statistics only |
--all-namespaces |
false |
Show events from all namespaces | |
--watch |
-w |
false |
Watch for new events in real-time |
| Format | Flag | Use Case |
|---|---|---|
| Color | -o color |
Terminal (default) |
| Plain | -o plain |
Terminal without color support |
| JSON | -o json |
Scripting, piping to jq |
| Markdown | -o markdown |
GitHub PR comments, docs |
| Table | -o table |
Structured terminal view |
Run the demo against a live cluster:
make demo # Deploy resources → show events → detect warnings
make demo-clean # Remove demo resources from clustercmd/ # CLI entry point & Cobra commands
internal/
client/ # Kubernetes client wrapper (EventLister interface)
event/ # Event model, filtering, grouping, conversion, formatting
report/ # Color/JSON/Markdown/Table output
scripts/ # Demo and utility scripts
Contributions are welcome! See CONTRIBUTING.md for details.
This project is licensed under the Apache License 2.0 — see the LICENSE file for details.