---
warning: DO NOT CHANGE THIS MANUALLY, THIS IS GENERATED BY https://github/duckdb/community-extensions repository, check README there
title: pyroscope
excerpt: |
  DuckDB Community Extensions
  DuckDB Pyroscope Extension for Continuous Profiling

extension:
  name: pyroscope
  description: DuckDB Pyroscope Extension for Continuous Profiling
  version: 0.1.3
  language: Rust
  build: cmake
  license: MIT
  excluded_platforms: "windows_amd64_rtools;windows_amd64_mingw;windows_amd64;wasm_threads;wasm_eh;wasm_mvp;linux_amd64_musl;"
  requires_toolchains: "rust;python3"
  maintainers:
    - lmangani
    - akvlad

repo:
  github: quackscience/duckdb-extension-pyroscope
  ref: e72cf4cdbfbe79476f55adb2a98aec2792d72f68

docs:
  hello_world: |
    ---- Start the tracer, requires backend URL
    D SELECT * FROM trace_start('https://pyroscope:4000');
    
    ---- Stop the tracer
    D SELECT * FROM trace_stop();
    
  extended_description: |
    ### Pyroscope Continuous Profiling
    This experimental community extension adds pyroscope continuous profiling features to DuckDB

    #### Grafana
    Create a `Free` account on [Grafana Cloud](https://grafana.com/auth/sign-up/create-user?pg=prod-cloud&plcmt=hero-btn-1) create a Token for Pyroscope profile sending and use the extension:
    ```sql
    ---- Start the tracer to Grafana Cloud Pyroscope
    D SELECT * FROM trace_start('https://user:token@profiles-prod-xxx.grafana.net');
    ```

    #### Gigapipe
    Create a `Free` account on [Gigapipe](https://gigapipe.com) create a Token for Pyroscope profile sending and use the extension:
    ```sql
    ---- Start the tracer to Grafana Cloud Pyroscope
    D SELECT * FROM trace_start('https://user:token@your-account.gigapipe.com');
    ```
        
    ![pyroscope_duckdb_large](https://github.com/user-attachments/assets/74fad3ec-3bc3-4880-be4b-8149c5431115)


extension_star_count: 18
extension_star_count_pretty: 18
extension_download_count: null
extension_download_count_pretty: n/a
image: '/images/community_extensions/social_preview/preview_community_extension_pyroscope.png'
layout: community_extension_doc
---

### Installing and Loading
```sql
INSTALL {{ page.extension.name }} FROM community;
LOAD {{ page.extension.name }};
```

{% if page.docs.hello_world %}
### Example
```sql
{{ page.docs.hello_world }}```
{% endif %}

{% if page.docs.extended_description %}
### About {{ page.extension.name }}
{{ page.docs.extended_description }}
{% endif %}

### Added Functions

<div class="extension_functions_table"></div>

| function_name | function_type | description | comment | examples |
|---------------|---------------|-------------|---------|----------|
| trace_start   | table         | NULL        | NULL    |          |
| trace_stop    | table         | NULL        | NULL    |          |