Korrel8r is a correlation engine for observability signals and observable resources.
It can correlate multiple domains, diverse signals, inconsistent labeling, and varied data stores.
The goals of this project include:
-
Encode domain knowledge from SREs and other experts as re-usable rules.
-
Automate navigation from symptoms to data that helps diagnose causes.
-
Connect data from diverse types of store, with different schema.
-
Reduce multiple-step manual procedures to fewer clicks or queries.
-
Help tools that gather and analyze diagnostic data to focus on relevant information.
Caution
|
Korrel8r is still in early development. There are no compatibility guarantees between versions. |
Note
|
Read the Korrel8r Documentation for more about what Korrel8r is and how to use it. |
There is a short demo video
There are scripts and examples to set up a cluster with logging, metrics and other observable signals:
-
hack/openshift for OpenShift clusters.
-
hack/kind for Kind clusters.
Log into your cluster as kubeadmin
or other admin user.
You can install and run korrel8r on your local host, it can observe your cluster from the outside.
You need to be logged-in as kubeadmin
to your cluster:
go install github.com/korrel8r/korrel8r/cmd/korrel8r@latest
korrel8r web -http :8080 &
With korrel8r running, you can browse the following URLs:
-
http://localhost:8080 - Interactive browser interface.
-
http://localhost:8080/api - REST API documentation
You can also run korrel8r as a command line tool, see korrel8r --help
for commands and options.
You can deploy the latest korrel8r image to your cluster in namespace korrel8r
You need to be logged-in as kubeadmin
to your cluster:
kubectl apply -k https://github.com/korrel8r/korrel8r/config/base
On an OpenShift cluster, you can create a route to korrel8r with make route
to connect to korrel8r.
On other types of cluster you can create a port mapping or ingress.
make route
URL=$(make route-url)
Browse the following URLs:
-
$URL
# Interactive browser interface. -
$URL/api
# REST API documentation
Documentation:
-
Korrel8r User guide and Reference for more about what Korrel8r is and how to use it.
If you are interested in helping to develop Korrel8r:
- clone this repository
- make help
will list make targets with brief explanation.
- make run
will run korrel8r directly from source using the checked-in configuration
By default, the Makefile uses quay.io/korrel8r/korrel8r
as its image repository.
Set IMG
to use a different repository:
-
make image IMG=quay.io/myaccount/mykorrel8r
build and push an image to your image repository. -
make deploy IMG=quay.io/myaccount/mykorrel8r
deploy your image to your cluster.
Important
|
you need a public image repository on a public service like quay.io or docker.io .
Some services (including quay.io ) make new repositories private by default.
You may need to log in and change settings so that your new repository is public.
|