yandex / perforator

Perforator is a cluster-wide continuous profiling tool designed for large data centers

3,394 stars

156 forks

38 issues

C++CPython

Chat with Codebase Architecture Scan Security Audit Explain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing yandex/perforator in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/yandex/perforator)

Preview:

Repository Overview (README excerpt)

Crawler view

Perforator Documentation | Post on Medium | Post on Habr Perforator is a production-ready, open-source Continuous Profiling app that can collect CPU profiles from your production without affecting its performance, made by Yandex and inspired by Google-Wide Profiling. Perforator is deployed on tens of thousands of servers in Yandex and already has helped many developers to fix performance issues in their services. Main features • Efficient and high-quality collection of kernel + userspace stacks via eBPF. • Scalable storage for storing profiles and binaries. • Support of unwinding without frame pointers and debug symbols on host. • Convenient query language and UI to inspect CPU usage of applications via flamegraphs. • Support for C++, C, Go, and Rust, with experimental support for Java and Python. • Generation of sPGO profiles for building applications with Profile Guided Optimization (PGO) via AutoFDO. Minimal system requirements Perforator runs on x86 64-bit Linux platforms consuming 512Mb of RAM (more on very large hosts with many CPUs) and <1% of host CPUs. Quick start You can profile your laptop using local perforator record CLI command. You can also deploy Perforator on playground/production Kubernetes cluster using our Helm chart. How to build • Instructions on how to build from source are located here. • If you want to use prebuilt binaries, you can find them here. How to Contribute We are welcome to contributions! The contributor's guide provides more details on how to get started as a contributor. License This project is licensed under the Apache 2.0 License (Apache-2.0). Apache 2.0 License NB: Formerly, we licensed Perforator under MIT license. We switched to Apache 2.0 to waive custom CLA signature requirements and simplify contributions. Some parts are licensed under the GPL 2.0 license. GPL 2.0 These include: • eBPF program source code (perforator/agent/collector/progs/unwinder) • OpenJDK profiling support (portions of code within perforator/internal/linguist/jvm)