4 releases (breaking)

Uses old Rust 2015

0.4.0 Oct 24, 2018
0.3.0 Oct 24, 2018
0.2.0 Oct 23, 2018
0.1.0 Oct 22, 2018

#1970 in Development tools

21 downloads per month

MIT license

14KB
226 lines

K∅RQ

Kubernetes Dynamic Log Tailing Utility

Build Status Crates.io Crates.io Master API docs

K∅RQ is used for tailing pod logs concurrently and following groups at once. It was basically a need to follow logs during deployment and see how instances behave during and after deployment. This is the main motive behind K∅RQ.

Installation

Start by installing K∅RQ with Cargo.

cargo install korq

Or download it from the release tag!

Check that cargo bin path is in your PATH.

K∅RQ first looks for Kubernetes configuration file after that it will look for either CA certificates, cluster side certificates or an auth provider token for client initialization. Before that you might want to set your environment variable for configuration file which can be done via environment variable. By default it is using: $HOME/.kube/config.

$ KUBECONFIG=$HOME/somepath/admin.conf

Usage

After these steps you need to set your default project if you are going to use token. Access Token must be valid during execution. OFC. yep!

By default K∅RQ's namespace is default. You can pass this argument as a parameter to the command with --namespace flag.

For filtering the pods by name you can pass pods' base name to the --filter parameter.

Then you can invoke K∅RQ with:

korq --context <CONTEXT> --namespace <NAMESPACE> --filter <FILTER>

If you want to tail a specific container in pod group you can use:

korq --context <CONTEXT> --namespace <NAMESPACE> --filter <FILTER> --container <CONTAINER_FILTER>

Both commands in short:

korq -k <CONTEXT> -n <NAMESPACE> -f <FILTER>
korq -k <CONTEXT> -n <NAMESPACE> -f <FILTER> -c <CONTAINER_FILTER>

Enjoy the ride!

Dependencies

~76MB
~1.5M SLoC