Kubeshark is an observability and monitoring tool for Kubernetes, enabling dynamic analysis of the microservices, detecting anomalies and triggering functions when certain patterns appear in runtime.

Think of Kubeshark as a Kubernetes-aware combination of Wireshark, BPF Compiler Collection (BCC) tools and beyond.

Quickstart

Installing Kubeshark can't be any easier. Either choose the right binary, download and use directly from the releases section, or use a shell script to download the right binary for your operating system and CPU architecture:

sh <(curl -Ls https://kubeshark.co/install)

Deploy

Once you have the Kubeshark CLI installed on your system, run the command below to deploy the Kubeshark container into your Kubernetes cluster.

kubeshark tap

Troubleshooting Installation

If something doesn't work or simply to play it safe prior to installing, make sure that:

Kubeshark images are hosted on Docker Hub. 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.