Skip to content

Latest commit

 

History

History
83 lines (54 loc) · 2.22 KB

README.md

File metadata and controls

83 lines (54 loc) · 2.22 KB

kubectl dig

Deep kubernetes visibility from the kubectl.

kubectl dig logo kubectl dig
A simple, intuitive, and fully customizable UI to dig into your kubernetes clusters
kubectl dig <node>

asciicast

Install

go get -u github.com/sysdiglabs/kubectl-dig/cmd/kubectl-dig

Usage

Just dig

There's only one thing to do, provide the node name!

kubectl dig <node>

You just identify the node you want to dig in with kubectl get nodes and then provide it to the dig command!

kubectl dig ip-180-12-0-152.ec2.internal

dig + cluster metadata

By default, kubectl dig shows only information about the local node, if you want to dig from that node to the whole cluster you have to provide a service account that can read resources.

You can create a dig-viewer service account with:

kubectl apply -f https://github.com/sysdiglabs/kubectl-dig/raw/develop/docs/setup/read-serviceaccount.yml

Then you just use it with kubectl dig.

kubectl dig --serviceaccount dig-viewer 127.0.0.1

At this point you have access to the fancy cluster metadata, press F2 and look for the K8s views!

Project status

High-level todo

  • Basic functionalities;
  • Finish all the planned commands;
  • Merge here the functionalities of kubectl-capture;
  • Integration tests;
  • Errors detection on the kernel module;

Planned commands

  • run command, to execute digs;
  • list command, to list all the executed digs;
  • attach command, to attach to an existing dig that was previously detached;
  • delete command, to delete an existing dig;
  • where command, to execute digs where the chosen workloads are, instead of having to specify the node directly;

Analytics