What is Pixie?
Pixie gives you instant visibility by giving access to metrics, events, traces and logs without changing code.
We're building up Pixie for broad use by the end of 2020. If you are interested, feel free to try our community beta and join our community on slack.
Table of contents
Review Pixie's requirements to make sure that your Kubernetes cluster is supported.
Visit our product page and signup with your google account.
Run the command below:
bash -c "$(curl -fsSL https://withpixie.ai/install.sh)"
Or see our Installation Docs to install Pixie using Docker, Debian, RPM or with the latest binary.
(optional) Setup a sandbox
If you don't already have a K8s cluster available, you can use Minikube to set-up a local environment:
On Linux, run
minikube start --cpus=4 --memory=6000 --driver=kvm2 -p=<cluster-name>. The default
dockerdriver is not currently supported, so using the
kvm2driver is important.
On Mac, run
minikube start --cpus=4 --memory=6000 -p=<cluster-name>.
More detailed instructions are available here.
Start a demo-app:
- Deploy Weaveworks' sock-shop demo app by running
px demo deploy px-sock-shop
Use the CLI to deploy the Pixie Platform in your K8s cluster by running:
Alternatively, you can deploy with YAML or Helm.
Check out our install guides and walkthrough videos for alternate install schemes.
Get Instant Auto-Telemetry
Run scripts with
px run px/service_stats
px run px/node_stats
px run px/mysql_stats
Explore more scripts by running:
px scripts list
Check out our pxl_scripts repo for more examples.
View machine generated dashboards with Live views
The Pixie Platform auto-generates "Live View" dashboard to visualize script results.
You can view them by clicking on the URLs prompted by
px or by visiting:
Pipe Pixie dust into any tool
You can transform and pipe your script results into any other system or workflow by consuming
px results with tools like jq.
Example with http_data:
px run px/http_data -o json| jq -r .
More examples here
To see more script examples and learn how to write your own, check out our docs for more guides
We're excited to have you contribute to Pixie. Our community has adopted the Contributor Covenant as its code of conduct, and we expect all participants to adhere to it. Please report any violations to [email protected]. All code contributions require the Contributor License Agreement. The CLA can be signed when creating your first PR.
There are many ways to contribute to Pixie:
- Bugs: Something not working as expected? Send a bug report.
- Features: Need new Pixie capabilities? Send a feature request.
- Views & Scripts Requests: Need help building a live view or pxl scripts? Send a live view request.
- PxL Scripts: PxL scripts are used to extend Pixie functionality. They are an excellent way to contribute to golden debugging workflows. Look here for more information.
- Pixienaut Community: Interested in becoming a Pixienaut and in helping shape our community? Apply here.
Along with building Pixie as a freemium SaaS product, contributing open and accessible projects to the broader developer community is integral to our roadmap.
We plan to contribute in two ways:
- Open Sourced Pixie Platform Primitives: We plan to open-source components of the Pixie Platform which can be independently useful to developers after our Beta. These include our Community Pxl Scripts, Pixie CLI, eBPF Collectors etc. If you are interested in contributing during our Beta, email us.
- Unlimited Pixie Community Access: Our Pixie Community product is a completely free offering with all core features of the Pixie developer experience. We will invest in this offering for the long term to give developers across the world an easy and zero cost way to use Pixie.
Under the Hood
Three fundamental innovations enable Pixie's magical developer experience:
Progressive Instrumentation: Pixie Edge Modules (“PEMs”) collect full body request traces (via eBPF), system metrics & K8s events without the need for code-changes and at less than 5% overhead. Custom metrics, traces & logs can be integrated into the Pixie Command Module.
In-Cluster Edge Compute: The Pixie Command Module is deployed in your K8s cluster to isolate data storage and computation within your environment for drastically better intelligence, performance & security.
Command Driven Interfaces: Programmatically access data via the Pixie CLI and Pixie UI which are designed ground-up to allow you to run analysis & debug scenarios faster than any other developer tool.
For more information on Pixie Platform's architecture, check out our docs or overview deck
- Company Website
- Community Slack
- Issue Tracker
- Community Overview
- Overview Slide Deck
Founded in late 2018, we are a San Francisco based stealth machine intelligence startup. Our north star is to build a new generation of intelligent products which empower developers to engineer the future.
We're heads down building Pixie and excited to share it broadly with the community later this year. If you're interested in learning more about us or in our current job openings, we'd love to hear from you.
Pixie Community is the free offering of Pixie's proprietary SaaS product catalogue.
Our PxL Scripts are licensed under Apache License, Version 2.0.
Other Pixie Platform components such as Pixie CLI and eBPF based Data Collectors will also be licensed under the Apache License, Version 2.0. Contribution of these are planned for Oct 2020.