This guide assumes that you have helm, kubectl, and (optionally) minikube installed.
If not, you can follow the install guides for helm, kubectl, and minikube before proceeding with the rest of this setup.
⚠️ Please review the cluster requirements for Pixie here.
We strongly recommend using a cloud based k8s cluster for ease of deployment. If you need help setting up a cluster, follow the cluster setup guide.
-
We use helm to install the demo apps
-
Add the otel demo repo
helm repo add otel-demo https://pixie-labs.github.io/opentelemetry-helm-charts helm repo update
-
Install the otel demos
helm install --create-namespace --namespace otel-demo otel-demo otel-demo/opentelemetry-demo
-
Get the Pixie CLI
bash -c "$(curl -fsSL https://withpixie.ai/install.sh)" -
(optional) The CLI installer should prompt you to authenticate with Pixie but if it doesn't, you can auth manually by running the following
px auth login -
We can now use helm to install Pixie. Add the pixie repo
helm repo add pixie-operator https://pixie-operator-charts.storage.googleapis.com helm repo update
-
Install pixie on the cluster
PIXIE_DEPLOY_KEY=$(px deploy-key create --short 2>&1 | grep px-dep) helm install --namespace pl --create-namespace pixie pixie-operator/pixie-operator-chart --set deployKey="${PIXIE_DEPLOY_KEY}" --set clusterName="${USER}_otel_demo"
In order to access the demo application and dashboards, you need to forward the correct ports:
kubectl port-forward -n otel-demo svc/otel-demo-frontendproxy 8080:8080At this point, you should be able to go to http://localhost:8080/ to access the demo application UI, and http://localhost:8080/grafana to access the Grafana dashboards.
You can now follow the tutorial guide to explore the various tools we have installed