Tutorials | PxL Scripts | How to Write a PxL Script

Overview

Pixie uses PxL scripts to both:

Query telemetry data collected by the Pixie Platform (DNS events, HTTP events, etc).
Extend Pixie to collect new data sources (in addition to those it collects by default).

PxL scripts can be executed by the Pixie platform by using the web based Live UI, CLI or API.

Setup

Pixie needs to be installed on your Kubernetes cluster. If it is not already installed, please consult our install guides.

Writing a PxL Script

This tutorial series demonstrates how to write a PxL script to query data automatically collected by Pixie's platform. Pixie's CLI is used to execute the script.

Writing a Vis Spec

This tutorial series demonstrates how to write a Vis Spec to accompany the PxL script developed in Tutorial #1 and Tutorial #2. Pixie's Live UI is used to execute the script.

Writing PxL Scripts to Collect Custom Data

These tutorials demonstrate how to write a PxL script that extends the Pixie platform to collect new data sources:

To see these features in action, check out the following blog posts:

Dumpster Diving the Go Garbage Collector: using Pixie's dynamic Go logging to understand how Go garbage collection works.
Distributed bpftrace with Pixie: how to deploy bpftrace tools across your cluster using Pixie.

Getting Help

If you have questions about these tutorials, we’d be happy to help out on our GitHub or community Slack.