/kubeshark

The API traffic viewer for Kubernetes providing deep visibility into all API traffic and payloads going in, out and across containers and pods inside a Kubernetes cluster. Think TCPDump and Wireshark re-invented for Kubernetes

Primary LanguageGoApache License 2.0Apache-2.0

Kubeshark: Traffic viewer for Kubernetes.

GitHub License GitHub Latest Release Docker pulls Image size Discord Slack

Mizu (by UP9) is now Kubeshark, read more about it here.

Kubeshark, the API Traffic Viewer for kubernetes, provides deep visibility and monitoring of all API traffic and payloads going in, out and across containers and pods inside a Kubernetes cluster.

Think of a combination of Chrome Dev Tools, TCPDump and Wireshark, re-invented for Kubernetes.

Simple UI

Download

Kubeshark uses a ~45MB pre-compiled executable binary to communicate with the Kubernetes API. We recommend downloading the kubeshark CLI by using one of these options:

  • Choose the right binary, download and use directly from the latest stable release.

  • Use the shell script below 👇 to automatically download the right binary for your operating system and CPU architecture:

sh <(curl -Ls https://kubeshark.co/install)
  • Compile it from source using make command then use ./bin/kubeshark__ executable.

Run

Use the kubeshark CLI to capture and view streaming API traffic in real time.

kubeshark tap

Troubleshooting Installation

If something doesn't work or simply to play it safe prior to installing;

Make sure you have access to https://hub.docker.com/

Make sure kubeshark executable in your PATH.

Select Pods

Monitoring a Specific Pod:

kubeshark tap catalogue-b87b45784-sxc8q

Monitoring a Set of Pods Using Regex:

kubeshark tap "(catalo*|front-end*)"

Specify the Namespace

By default, Kubeshark is deployed into the default namespace. To specify a different namespace:

kubeshark tap -n sock-shop

Specify All Namespaces

The default deployment strategy of Kubeshark waits for the new pods to be created. To simply deploy to all existing namespaces run:

kubeshark tap -A

Documentation

Visit our documentation website: docs.kubeshark.co

The documentation resources are open-source and can be found on GitHub: kubeshark/docs

Contributing

We ❤️ pull requests! See CONTRIBUTING.md for the contribution guide.

Code of Conduct

This project is for everyone. We ask that our users and contributors take a few minutes to review our Code of Conduct.