- About Pixie
- Installing Pixie
- Using Pixie
Review Pixie's requirements to make sure that your Kubernetes cluster is supported.
Determine if you already have Operator Lifecycle Manager (OLM) deployed to your cluster, possibly to the default
olm namespace. Pixie uses the Kubernetes Operator pattern to manage its Vizier, which handles data collection and query execution (see the Architecture diagram). The OLM is used to install, update and manage the Vizier Operator.
Pixie interacts with the Linux kernel to install BPF programs to collect telemetry data. In order to install BPF programs, Pixie
vizier-pem-* pods require privileged access.
Visit our product page and sign up.
If you don't have a Kubernetes cluster available, you can set up Minikube as a local sandbox environment following these instructions.
The easiest way to install Pixie's CLI is using the install script:
# Copy and run command to install the Pixie CLI.bash -c "$(curl -fsSL https://withpixie.ai/install.sh)"
For alternate install options (Docker, Debian package, RPM, direct download of the binary) see the CLI Install page.
Pixie's CLI is the fastest and easiest way to deploy Pixie. You can also deploy Pixie using YAML or Helm. You can use these steps to install Pixie to one or more clusters.
To deploy Pixie using the CLI:
# List Pixie deployment options.px deploy --help# Deploy the Pixie Platform in your K8s cluster (No OLM present on cluster).px deploy# Deploy the Pixie Platform in your K8s cluster (OLM already exists on cluster).px deploy --deploy_olm=false# Deploy Pixie with a specific memory limit (2Gi is the default, 1Gi is the minimum recommended)px deploy --pem_memory_limit=1Gi
Pixie deploys the following pods to your cluster. Note that the number of
vizier-pem pods correlates with the number of nodes in your cluster, so your deployment may contain more PEM pods.
NAMESPACE NAMEolm catalog-operatorolm olm-operatorpl kelvinpl nats-operatorpl pl-nats-1pl vizier-certmgrpl vizier-cloud-connectorpl vizier-metadatapl vizier-pempl vizier-pempl vizier-proxypl vizier-query-brokerpx-operator 77003c9dbf251055f0bb3e36308fe05d818164208a466a15d27acfddeejt7tqpx-operator pixie-operator-indexpx-operator vizier-operator
To deploy Pixie to another cluster, change your
kubectl config current-context to point to that cluster. Then repeat the same deploy commands shown in this step.
For more deploy options that you can specify to configure Pixie, refer to our deploy options.
Add users to your organization to share access to Pixie Live Views, query running clusters, and deploy new Pixie clusters. For instructions, see the User Management & Sharing reference docs.
Deploy a simple demo app to monitor using Pixie:
# List available demo apps.px demo list# Example: deploy Weaveworks' "sock-shop".px demo deploy px-sock-shop
This demo application takes several minutes to stabilize after deployment.
To check the status of the application's pods, run:
kubectl get pods -n px-sock-shop
px live to run a script to demonstrate observability. The
http_data script shows a sample of the HTTP/2 traffic flowing through your cluster.
# List built-in scriptspx scripts list# Run a scriptpx live px/http_data
For more information, checkout our CLI guide.
Open Pixie's Live UI in a new tab.
For more information, check out our Live UI guide.
Learn how to use Pixie for
Please see our Troubleshooting guide, reach out on our Community Slack or file an issue on GitHub.