Skip to main content
Version: 1.7

Monitoring

Rancher has a Cluster Tool for Monitoring that leverages Grafana and Prometheus. You can utilize this tool and integrate it with Kubewarden to view overall metrics for a Policy Server or metrics pertaining to a given policy.

warning

Issues with Rancher Manager v2.7.1 can cause issues with the Metrics dashboard view. Version v2.7.2 or greater is recommended.

caution

You will need a cluster with at least 4 cores to install the Monitoring tool.

Prerequisites​

Cert-Manager and OpenTelemetry are required. Follow these instructions to install Cert Manager and the OpenTelemetry Operator.

Install​

1. Within the cluster explorer click on Cluster Tools in the side navigation​

  • Install the Monitoring tool
  • Edit the YAML to include a Service Monitor for Kubewarden
  • You need to specify the correct namespace where you installed Kubewarden

Adapted from here

prometheus:
  additionalPodMonitors: []
  additionalRulesForClusterRole: []
  additionalServiceMonitors:
    - name: kubewarden
      selector:
        matchLabels:
          app: kubewarden-policy-server-default
      namespaceSelector:
        matchNames:
          - cattle-kubewarden-system
      endpoints:
        - port: metrics
          interval: 10s
  annotations: {}

2. Enable telemetry for your rancher-kubewarden-controller resource​

  • Navigate to Apps & Marketplace -> Installed Apps
  • Select the Edit/Upgrade action for your rancher-kubewarden-controller resource
  • Edit the YAML for telemetry to be enabled: "true" and ensure the metrics port is correct
telemetry:
  enabled: True
  metrics:
    port: 8080
note

You may need to redeploy your Monitoring resources for the new ConfigMap to be loaded. You can easily do this from Workloads -> Deployments. Select all the resources in the cattle-monitoring-system namespace and click on the Redeploy action.

3. Add the ConfigMap for Policies and Policy Server​

note

This method is suited for air gapped installations

The dashboards are unique between Policy Server and Policies, thus will need to be created separately.

Within the detail view for a Policy Server or a specific Policy:

  • Navigate to the "Metrics" tab
  • Follow the prompt to create the ConfigMap
  • Reload the page to update the Grafana view (Grafana may be slow to acknowledge the new dashboard)

You should be able to view the metrics for a Policy Server or any given Policy on the detail page for each respective resource. You can also view the Kubewarden dashboards within the Grafana UI or the events from the Prometheus UI.