kwirthmagnify/kwirth repository overview

⁠Kwirth

Kwirth is the final implementation of the idea of having a simple way to retrieve Kubernetes logs, metrics (and other observability information) and manage the cluster itself. Maybe you feel comfortable with your DataDog/Grafana/Loki/Promtrail/ELK... or your K9s/Lens/Headlamp... But maybe these (and other tools) are too complex/expensive/heterogenous for you, or maybe you just need a simple realtime observability and management tool.

If this is the case, Kwirth is the answer to your needs. When we say 'observability' we mean 'logging', 'metrics', 'alerts', 'signals', etc. When we talk about 'management' we are in fact talking about real-time object management, container filesystem management, cybersecurity posture (vulns, secrets...), etc.

You can access the source code HERE⁠.

⁠Get started

You can deploy Kwirth to your Kubernetes cluster by using Helm or vanilla Kubernetes manifests.

⁠Helm

1. Add Kwirth repository to oyour local Helm:

   helm repo add kwirth https://github.com/jfvilas/kwirth/tree/master/deploy/helm
   

   Copy

2. Install Kwirth:

   helm install kwirth kwirth/kwirth -n kwirth --create-namespace
   

   Copy

You can get some help on tailoring your values HERE⁠.

⁠Manifests

Yes, one only command, just a simple 'kubectl' is enough for deploying Kwirth to your cluster.

kubectl apply -f https://raw.githubusercontent.com/jfvilas/kwirth/master/test/kwirth.yaml

If everything is ok, in no more than 8 to 10 seconds Kwirth should be up and running. So next step is to access the front application of your fresh new Kubernetes observability system. Several options exist here...

⁠Accessing

1. You can access just using command line port forwarding:

   kubectl port-forward svc/kwirth-svc 3883
   

   Copy

2. Using the port forwarding option of your favourite Kubernetes management tool, like KwirthMagnify, Lens, Headlamp, K9S...

   • With KwirthMagnify

   • With Headlamp...

     

   • With Lens...

     

   • With K9S. Just select the Kwirth pod and press Caps+F, then just accept (or change) the port sugegstions from K9s and navigate...

     

3. Using an Ingress. It is the best option if you plan to access your Kwirth from Internet and if you also plan to share Kwirth with the development team in your corporate private network. For publishing Kwirth to be accesible from outside the cluster, you must create an Ingress (be sure, you need to deploy an ingress controller before, you have info on how to perform a simple ingress installation HERE⁠).

NOTE: If you use Helm you can install the Ingress just by configuring the values.

```yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
    name: ingress-kwirth
    namespace: default
spec:
    ingressClassName: nginx
    # if you want to publish Kwirth securely you would need to add something like this:
    # tls:
    # - hosts:
    #   - www.kwirth-dns.com
    #     secretName: www.kwirth-dns.com.tls
    rules:
    - host: localhost
    http:
        paths:
        - path: /kwirth
            pathType: Prefix
            backend:
            service:
                name: kwirth-svc
                port:
                number: 3883
```

NOTE: You can change the path where to publish Kwirth, it is explained in installation section⁠.