installation.md

Installation of Hubble

Requirements

• Cilium >= 1.7.0
• Kubernetes

Install Cilium

Install Cilium using the Install instructions. To deploy Cilium 1.7.0 using quick-install.yaml:

kubectl apply -f https://raw.githubusercontent.com/cilium/cilium/v1.7.0/install/kubernetes/quick-install.yaml

If you need help to troubleshoot installation issues, ping us on the Cilium Slack.

Enable Datapath Aggregation

Hubble relies on on aggregation of events in the eBPF datapath of Cilium. Please enable datapath aggregation by setting the value of monitor-aggregation in the cilium-config ConfigMap to medium or higher:

monitor-aggregation: medium

This is the default setting for new installs of Cilium 1.6 or later.

Install Hubble

Deploy Hubble using hubble-all-minikube.yaml:

kubectl apply -f https://raw.githubusercontent.com/cilium/hubble/master/tutorials/deploy-hubble-servicemap/hubble-all-minikube.yaml

Optional: Configure Metrics

When you deploy Hubble with hubble-all-minikube.yaml, Hubble is configured with a default set of metric plugins. Follow instructions in this page if you need to customize metric plugins.

Optional: Enable L7 Visibility

• Enable DNS Visibility
• Enable HTTP Visibility

Next Steps

• Configure Metrics with Prometheus & Grafana
• Configure the service map UI
• Explore Flow Queries
• More Tutorials