菜单
文档面包屑箭头 Grafana Pyroscope面包屑箭头 入门
开源 RSS

Grafana Pyroscope 入门

选择以下选项之一以开始使用 Pyroscope

下面的**书面教程**提供了一系列命令，用于启动单个 Pyroscope 进程（或称 [monolith](../reference-pyroscope-architecture/deployment-modes/#monolithic-mode)），专为项目新手设计。

您还可以使用 [`多个示例`](https://github.com/grafana/pyroscope/tree/main/examples) 来帮助您快速开始使用 Pyroscope 和 Grafana。

每个示例都有一个 `docker-compose.yml` 清单文件，其中包含在 Grafana 中探索性能分析数据所需的所有选项，包括资源配置和性能分析数据生成。

有关部署 Pyroscope 的不同方式的更多信息，请参阅 [Pyroscope 部署模式](../reference-pyroscope-architecture/deployment-modes/)。

开始之前

验证您已安装 [Docker](https://docs.dockerd.com.cn/engine/install/)。

注意

默认情况下，Pyroscope 会向远程统计服务器报告关于运行中集群的匿名、非敏感、非个人身份信息，以帮助 Pyroscope 维护者了解开源社区如何运行 Pyroscope。

要选择退出，请参阅[禁用匿名使用情况统计报告](../configure-server/anonymous-usage-statistics-reporting#disable-the-anonymous-usage-statistics-reporting)。

下载并配置 Pyroscope

  1. 下载 Pyroscope。

    您可以使用 Docker 或下载二进制文件来安装 Pyroscope。

    • 使用 Docker 安装，运行以下命令

      bash 
      docker pull grafana/pyroscope:latest

    • 使用本地二进制文件

      下载适用于您的操作系统和架构的相应[发布资产](https://github.com/grafana/pyroscope/releases/latest)并使其可执行。

      例如，对于 AMD64 架构的 Linux

      bash 
      # Download Pyroscope v1.0.0 and unpack it to the current folder
curl -fL https://github.com/grafana/pyroscope/releases/download/v1.0.0/pyroscope_1.0.0_linux_amd64.tar.gz | tar xvz

  2. 运行 Pyroscope。

    在终端中，运行以下命令之一

    • 使用 Docker

      bash 
      docker network create pyroscope-demo
docker run --rm --name pyroscope --network=pyroscope-demo -p 4040:4040 grafana/pyroscope:latest

    • 使用本地二进制文件

      bash 
      ./pyroscope

  3. 验证 Pyroscope 已就绪。Pyroscope 在端口 `4040` 上监听。

    bash 
    curl localhost:4040/ready

  4. 配置 Pyroscope 抓取性能分析数据。

    默认情况下，Pyroscope 配置为抓取自身数据。要收集更多性能分析数据，您必须使用 SDK 对您的应用程序进行代码植入，或使用 Grafana Alloy。

    要了解有关语言集成和 Pyroscope 代理的更多信息，请参阅 [Pyroscope 代理](../configure-client/)。

添加 Pyroscope 数据源并查询数据

  1. 在终端中，使用 Docker 运行本地 Grafana 服务器

    bash 
    docker run --rm --name=grafana \
  --network=pyroscope-demo \
  -p 3000:3000 \
  -e "GF_INSTALL_PLUGINS=grafana-pyroscope-app"\
  -e "GF_AUTH_ANONYMOUS_ENABLED=true" \
  -e "GF_AUTH_ANONYMOUS_ORG_ROLE=Admin" \
  -e "GF_AUTH_DISABLE_LOGIN_FORM=true" \
  grafana/grafana:main

  2. 在浏览器中，访问 Grafana 服务器地址 [https://:3000/datasources](https://:3000/datasources)。

  3. 使用以下设置配置 Pyroscope 数据源以查询本地 Pyroscope 服务器

    字段值
    名称Pyroscope
    URL[http://pyroscope:4040/](http://pyroscope:4040/) 或在使用 Docker 时使用 [http://host.docker.internal:4040/](http://host.docker.internal:4040/)

要了解有关添加数据源的更多信息，请参阅[添加数据源](/docs/grafana/latest/datasources/add-a-data-source/)。

  1. 在浏览器中，访问您的 Grafana 实例中的[性能分析 Drilldown](/docs/grafana/latest/explore/simplified-exploration/profiles/) 地址 [https://:3000/a/grafana-pyroscope-app/profiles-explorer](https://:3000/a/grafana-pyroscope-app/profiles-explorer)。这将允许您使用直观的界面探索您的性能分析数据。

完成本入门指南中的任务后，您可以使用新配置的 Pyroscope 数据源创建仪表盘面板。有关使用 Grafana 处理仪表盘的更多信息，请参阅 Grafana 文档中的[面板和可视化](/docs/grafana/latest/panels-visualizations/)。