README
¶
Continuous profiling for analysis of CPU, memory usage over time, and down to the line number. Saving infrastructure cost, improving performance, and increasing reliability.
Features
-
eBPF Profiler: A single profiler, using eBPF, automatically discovering targets from Kubernetes or systemd across the entire infrastructure with very low overhead. Supports C, C++, Rust, Go, and more!
-
Open Standards: Both producing pprof formatted profiles with the eBPF based profiler, and ingesting any pprof formatted profiles allowing for wide language adoption and interoperability with existing tooling.
-
Optimized Storage & Querying: Efficiently storing profiling data while retaining raw data and allowing slicing and dicing of data through a label-based search. Aggregate profiling data infrastructure wide, view single profiles in time or compare on any dimension.
Why?
- Save Money: Many organizations have 20-30% of resources wasted with easily optimized code paths. The Parca Agent aims to lower the entry bar by requiring 0 instrumentation for the whole infrastructure. Deploy in your infrastructure and get started!
- Improve Performance: Using profiling data collected over time, Parca can with confidence and statistical significance determine hot paths to optimize. Additionally it can show differences between any label dimension, such as deploys, versions, and regions.
- Understand Incidents: Profiling data provides unique insight and depth into what a process executed over time. Memory leaks, but also momentary spikes in CPU or I/O causing unexpected behavior, is traditionally difficult to troubleshoot are a breeze with continuous profiling.
Feedback & Support
If you have any feedback, please open a discussion in the GitHub Discussions of this project.
We would love to learn what you think!
Installation & Documentation
Check Parca's website for updated and in-depth installation guides and documentation!
Development
You need to have Go and Node installed.
Clone the project
git clone https://github.com/parca-dev/parca.git
Go to the project directory
cd parca
Build the UI and compile the Go binaries
make build
Running the compiled Parca binary
The binary was compiled to bin/parca .
./bin/parca
Now Parca is running locally and its web UI is available on http://localhost:7070/.
By default Parca is scraping it's own pprof endpoints and you should see profiles show up over time.
The scrape configuration can be changed in the parca.yaml in the root of the repository.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
gen
|
|
|
proto/go/parca/debuginfo/v1alpha1
Package debuginfov1alpha1 is a reverse proxy.
|
Package debuginfov1alpha1 is a reverse proxy. |
|
proto/go/parca/profilestore/v1alpha1
Package profilestorev1alpha1 is a reverse proxy.
|
Package profilestorev1alpha1 is a reverse proxy. |
|
proto/go/parca/query/v1alpha1
Package queryv1alpha1 is a reverse proxy.
|
Package queryv1alpha1 is a reverse proxy. |
|
proto/go/parca/scrape/v1alpha1
Package scrapev1alpha1 is a reverse proxy.
|
Package scrapev1alpha1 is a reverse proxy. |
|
internal
|
|
|
pprof/binutils
Package binutils provides access to the GNU binutils.
|
Package binutils provides access to the GNU binutils. |
|
pprof/driver
Package driver implements the core pprof functionality.
|
Package driver implements the core pprof functionality. |
|
pprof/elfexec
Package elfexec provides utility routines to examine ELF binaries.
|
Package elfexec provides utility routines to examine ELF binaries. |
|
pprof/graph
Package graph collects a set of samples into a directed graph.
|
Package graph collects a set of samples into a directed graph. |
|
pprof/measurement
Package measurement export utility functions to manipulate/format performance profile sample values.
|
Package measurement export utility functions to manipulate/format performance profile sample values. |
|
pprof/plugin
Package plugin defines the plugin implementations that the main pprof driver requires.
|
Package plugin defines the plugin implementations that the main pprof driver requires. |
|
pprof/proftest
Package proftest provides some utility routines to test other packages related to profiles.
|
Package proftest provides some utility routines to test other packages related to profiles. |
|
pprof/report
Package report summarizes a performance profile into a human-readable report.
|
Package report summarizes a performance profile into a human-readable report. |
|
pprof/symbolizer
Package symbolizer provides a routine to populate a profile with symbol, file and line number information.
|
Package symbolizer provides a routine to populate a profile with symbol, file and line number information. |
|
pprof/symbolz
Package symbolz symbolizes a profile using the output from the symbolz service.
|
Package symbolz symbolizes a profile using the output from the symbolz service. |
|
pprof/transport
Package transport provides a mechanism to send requests with https cert, key, and CA.
|
Package transport provides a mechanism to send requests with https cert, key, and CA. |
|
pkg
|
|
|
runutil
Package runutil provides helpers to advanced function scheduling control like repeat or retry.
|
Package runutil provides helpers to advanced function scheduling control like repeat or retry. |