Skip to content


The kobs demo can be used to try out the kobs. Within the demo you will deploy Istio via the Istio Operator, Prometheus, Elasticsearch, Jaeger, Kiali and the Bookinfo Application.

Create a Kubernetes Cluster using Kind

The demo uses kind to create a local Kubernetes cluster, to deploy the mentioned services.


If you are using minikube, please check the minikube and Istio documentation to expose kobs and the Bookinfo Application to access them via your browser.

To create a Kubernetes cluster using kind your can run the script. The script will create a kind cluster with one node, configures a local Docker registry and sets the correct port mappings, so that you can access kobs via your browser later.


When your cluster is ready, you should see the following message:

Creating cluster "kobs-demo" ...
 ✓ Ensuring node image (kindest/node:v1.19.1) đŸ–ŧ
 ✓ Preparing nodes đŸ“Ļ
 ✓ Writing configuration 📜
 ✓ Starting control-plane 🕹ī¸
 ✓ Installing CNI 🔌
 ✓ Installing StorageClass 💾
Set kubectl context to "kind-kobs-demo"
You can now use your cluster with:

kubectl cluster-info --context kind-kobs-demo

To use the cluster you can switch your kubectl context using kubectl cluster-info --context kind-kobs-demo.

Install all Services

Now we can deploy all the CRDs for kobs, the metrics-server and the kube-state-metrics:

kustomize build deploy/kustomize/crds | kubectl apply -f -
kustomize build deploy/demo/kube-system | kubectl apply -f -

Now we can deploy all resources for the istio-operator and istio-system namespace. We are using Istio to get some nice Prometheus metrics for the Bookinfo Application and for the integration with Jaeger to get some traces. To install the Operator and Istio run the following commands, this will also deploy Prometheus, Jaeger and Kiali in the istio-system namespace:

kustomize build deploy/demo/istio-operator | kubectl apply -f -
kustomize build deploy/demo/istio-system | kubectl apply -f -

When Istio is up and running, we can install Elasticsearch and Filebeat to collect the logs for the Bookinfo Application and kobs to have all our observability tools in one UI:

kustomize build deploy/demo/elastic-system | kubectl apply -f -
kustomize build deploy/demo/kobs/main | kubectl apply -f -

The above commands are also installing kobs, with the incluster provider and the correct configuration for the Prometheus, Elasticsearch and Jaeger plugin. The complete configuration file looks as follows:

    - provider: incluster
        name: kobs-demo

    - name: prometheus
      displayName: Prometheus
      description: "From metrics to insight: Power your metrics and alerting with a leading open-source monitoring solution."
      address: http://prometheus.istio-system.svc.cluster.local:9090

    - name: elasticsearch
      displayName: Elasticsearch
      description: "A distributed, RESTful search and analytics engine capable of addressing a growing number of use cases."
      address: http://elasticsearch-es-http.elastic-system.svc.cluster.local:9200

    - name: jaeger
      displayName: Jaeger
      description: "Open-source, end-to-end distributed tracing: Monitor and troubleshoot transactions in complex distributed systems"
      address: http://tracing.istio-system.svc.cluster.local:80/jaeger

The last step, befor you can explore the functions of kobs, is to install the Bookinfo Application. The application displays information about a book, similar to a single catalog entry of an online book store. Displayed on the page is a description of the book, book details (ISBN, number of pages, and so on), and a few book reviews. To deploy the application run the following command:

kustomize build deploy/demo/bookinfo | kubectl apply -f -

If all components were installed correctly you can run kubectl get pods -A to get a list of all Pods. The output should look similar to the following:

NAMESPACE            NAME                                              READY   STATUS    RESTARTS   AGE
bookinfo             details-v1-789f56cd8f-qwhmp                       2/2     Running   0          2m10s
bookinfo             productpage-v1-58889757cf-75f4z                   2/2     Running   0          2m10s
bookinfo             ratings-v1-6bb88c887c-4p7gd                       2/2     Running   0          2m10s
bookinfo             reviews-v1-6d9cd465c6-znl5z                       2/2     Running   0          2m10s
bookinfo             reviews-v2-5b5f79977b-gzwxh                       2/2     Running   0          2m10s
bookinfo             reviews-v3-57cd59df96-5vtfw                       2/2     Running   0          2m10s
elastic-system       elastic-operator-0                                2/2     Running   0          8m10s
elastic-system       elasticsearch-es-elasticsearch-0                  2/2     Running   0          7m8s
elastic-system       filebeat-beat-filebeat-bjd5s                      1/1     Running   0          7m7s
istio-operator       istio-operator-86cd56f99f-g6n9k                   1/1     Running   0          10m
istio-system         istio-ingressgateway-74fbb47646-z7nz7             1/1     Running   0          9m54s
istio-system         istiod-7c8d96f664-nvlgb                           1/1     Running   0          10m
istio-system         jaeger-7f78b6fb65-mg5tz                           1/1     Running   0          10m
istio-system         kiali-85c8cdd5b5-4r5mw                            1/1     Running   0          10m
istio-system         prometheus-69f7f4d689-fcqmt                       2/2     Running   0          10m
kobs                 kobs-69995cbd79-6z4nl                             2/2     Running   0          2m39s
kube-system          coredns-f9fd979d6-7gmkr                           1/1     Running   0          12m
kube-system          coredns-f9fd979d6-7j79d                           1/1     Running   0          12m
kube-system          etcd-kobs-demo-control-plane                      1/1     Running   0          12m
kube-system          kindnet-55dl6                                     1/1     Running   0          12m
kube-system          kube-apiserver-kobs-demo-control-plane            1/1     Running   0          12m
kube-system          kube-controller-manager-kobs-demo-control-plane   1/1     Running   0          12m
kube-system          kube-proxy-4ppq2                                  1/1     Running   0          12m
kube-system          kube-scheduler-kobs-demo-control-plane            1/1     Running   0          12m
kube-system          kube-state-metrics-5f694c7886-dbvfw               1/1     Running   0          12m
kube-system          metrics-server-6778f49766-x88mz                   1/1     Running   0          12m
local-path-storage   local-path-provisioner-78776bfc44-59fhc           1/1     Running   0          12m

Access kobs and the Bookinfo Application

If you want to access kobs and the Bookinfo Application via your browser, you have to add the following entries to your /etc/hosts file: kobs.demo bookinfo.demo

After you have adjusted the hosts file, you can open http://bookinfo.demo/productpage in your browser. You should see the productpage for the Bookinfo Application. When you refresh the page, the reviews section of the page should change with every request. To generate some traffic to get more metrics, logs and traces you can run the following command in your terminal:

while :; do curl -s "http://bookinfo.demo/productpage" | grep -o "<title>.*</title>"; sleep 1; done

Now you can take a look at kobs. Open http://kobs.demo to view the kobs frontend. You should see the home page with the five items:

  • Applications: Is the section to view all applications, which are define via the Application CRD.
  • Resources: Can be used to view all Kubernetes resources, like Deployments, Pods, StatefulSets and Custom Resources.
  • Prometheus: Is the page for the Prometheus plugin, which can be used to directly query the configured Prometheus instance.
  • Elasticsearch: Can be used to retrieve the logs of the Pods via the Elasticsearch plugin.
  • Jaeger: View the traces of the Bookinfo Application via the Jaeger plugin.


Let's focus on the Applications section for this demo. When you select the bookinfo namespace you should see four applications: details, productpage, rating and reviews. You can click on the links to view the corresponding Application CR.







To delete the created Kubernetes cluster and the local Docker registry, when you are done with the demo, you can run the following commands. This will delete the kind cluster and the Docker container for the local Docker registry:

kind delete cluster --name kobs-demo
docker stop kind-registry
docker rm kind-registry