Home

Awesome

Pixie!

<br>

Docs Slack Twitter Mentioned in Awesome Kubernetes Mentioned in Awesome Go Build Status codecov FOSSA Status Artifact HUB Go Report Card CII Best Practices CLOMonitor OpenSSF Scorecard

<br>

Pixie is an open-source observability tool for Kubernetes applications. Use Pixie to view the high-level state of your cluster (service maps, cluster resources, application traffic) and also drill down into more detailed views (pod state, flame graphs, individual full-body application requests).

Why Pixie?

Three features enable Pixie's magical developer experience:

Use Cases

Network Monitoring

<img src=".readme_assets/net_flow_graph.png" alt="Network Flow Graph" width="525" align="right"> <br>

Use Pixie to monitor your network, including:

<br>

For more details, check out the tutorial or watch an overview.

<br clear="all">

Infrastructure Health

<img src=".readme_assets/nodes.png" alt="Infrastructure Monitoring" width="525" align="right"> <br>

Monitor your infrastructure alongside your network and application layer, including:

<br>

For more details, check out the tutorial or watch an overview.

<br clear="all">

Service Performance

<img src=".readme_assets/service.png" alt="Service Performance" width="525" align="right"> <br>

Pixie automatically traces a variety of protocols. Get immediate visibility into the health of your services, including:

<br>

For more details, check out the tutorial or watch an overview.

<br clear="all">

Database Query Profiling

<img src=".readme_assets/sql_query.png" alt="Database Query Profilling" width="525" align="right"> <br>

Pixie automatically traces several different database protocols. Use Pixie to monitor the performance of your database requests:

<br>

For more details, check out the tutorial or watch an overview.

<br clear="all">

Request Tracing

<img src=".readme_assets/http_data_filtered.png" alt="Request Tracing" width="525" align="right"> <br>

Pixie makes debugging this communication between microservices easy by providing immediate and deep (full-body) visibility into requests flowing through your cluster. See:

<br>

For more details, check out the tutorial or watch an overview.

<br clear="all">

Continuous Application Profiling

<img src=".readme_assets/pod_flamegraph.png" alt="Continuous Application Profiling" width="525" align="right"> <br>

Use Pixie's continuous profiling feature to identify performance issues within application code.

<br>

For more details, check out the tutorial or watch an overview.

<br clear="all">

Distributed bpftrace Deployment

Use Pixie to deploy a bpftrace program to all of the nodes in your cluster. After deploying the program, Pixie captures the output into a table and makes the data available to be queried and visualized in the Pixie UI. TCP Drops are pictured. For more details, check out the tutorial or watch an overview.

Dynamic Go Logging

Debug Go binaries deployed in production environments without needing to recompile and redeploy. For more details, check out the tutorial or watch an overview.

<br clear="all">

Get Started

<img src=".readme_assets/http_data.svg" alt="Request Tracing" width="525" align="right">

It takes just a few minutes to install Pixie. To get started, check out the Install Guides.

<br>

Once installed, you can interact with Pixie using the:

<br clear="all">

Get Involved

Pixie is a community-driven project; we welcome your contribution! For code contributions, please read our contribution guide.

<br clear="all">

Latest Releases

We version separate components of Pixie separately, so what Github shows as the "latest" release will only be the latest for one of the components. We maintain links to the latest releases for all components here:

Changelog

The changelog is stored in annotated git tags.

For vizier:

git for-each-ref refs/tags/release/vizier/$tagname --format='%(tag) %(contents)'

For the CLI:

git for-each-ref refs/tags/release/cli/$tagname --format='%(tag) %(contents)'

These are also published on the releases page.

Adopters

The known adopters and users of Pixie are listed here.

Software Bill of Materials

We publish a list of all the components Pixie depends on and the corresponding versions and licenses here.

Acknowledgements

The Pixie project would like to thank Equinix Metal via the CNCF Community Infrastructure Lab for graciously providing compute resources to run all the CI/CD for the project.

About Pixie

Pixie was contributed by New Relic, Inc. to the Cloud Native Computing Foundation as a Sandbox project in June 2021.

License

Pixie is licensed under Apache License, Version 2.0.