Pyroscope

vela port-forward addon-pyroscope -n vela-system

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: pyroscope-app
  namespace: fourier
spec:
  components:
    - name: pyroscope-comp-01
      type: webservice
      properties:
        image: nginx:latest
        ports:
          - expose: true
            port: 80
            protocol: TCP
        imagePullPolicy: IfNotPresent
      traits:
        - type: pyroscope
          properties:
            server: "http://pyroscope-server:9084"
            logger: "pyroscope.StandardLogger"
            appName: "pyroscope-test"
        - type: scaler
          properties:
            replicas: 1

为了在 Go 应用中启用分析，你需要在你的应用中导入 Pyroscope 模块。

# make sure you also upgrade pyroscope server to version 0.3.1 or higher
go get github.com/pyroscope-io/client/pyroscope

然后，在你的应用中添加如下代码：

package main
import "github.com/pyroscope-io/client/pyroscope"
func main() {
  pyroscope.Start(pyroscope.Config{
    ApplicationName: "simple.golang.app",
    // 将这个地址替换为你的 pyroscope 服务端地址
    ServerAddress:   "http://pyroscope-server:4040",
    // 你可以通过设置值为 nil 来禁用日志
    // AuthToken: os.Getenv("PYROSCOPE_AUTH_TOKEN"),
    // 默认启用所有的分析器，但是你也可以指定你想要启用的分析器：
    ProfileTypes: []pyroscope.ProfileType{
      pyroscope.ProfileCPU,
      pyroscope.ProfileAllocObjects,
      pyroscope.ProfileAllocSpace,
      pyroscope.ProfileInuseObjects,
      pyroscope.ProfileInuseSpace,
    },
  })
  // your code goes here
}

在 Java 应用中使用 Pyroscope

Java 集成是通过一个名叫 pyroscope.jar 的 jar 包分发的。它包含了原生的 async-profile 库。
要开始分析一个 Java 应用，通过使用 pyroscope.jar 的 javaagent 来启动你的程序：

要开始分析容器里的 .NET 应用，你需要用 pyroscope exec 来包装你的应用程序作为镜像的 entrypoint。你需要在你的 Dockerfile 中使用 COPY —from 将 pyroscope 可执行二进制拷贝到你的容器里。下面的 Dockerfile 演示了如何构建这个镜像：

FROM mcr.microsoft.com/dotnet/sdk:5.0
WORKDIR /dotnet
COPY --from=pyroscope/pyroscope:latest /usr/bin/pyroscope /usr/bin/pyroscope
ADD my-app .
RUN dotnet publish -o . -r $(dotnet --info | grep RID | cut -b 6- | tr -d ' ')
# 你可以像设置 pyroscope 服务地址一样设置其他的配置选项。
ENV PYROSCOPE_SERVER_ADDRESS=http://pyroscope-server:4040
ENV PYROSCOPE_APPLICATION_NAME=my.dotnet.app
ENV PYROSCOPE_LOG_LEVEL=debug
CMD ["pyroscope", "exec", "dotnet", "/dotnet/my-app.dll"]

如果你正在使用 Docker Compose，那么你可以使用下面的配置同时运行 pyroscope 服务端和客户端。

---
version: "3.9"
services:
  pyroscope-server:
    image: "pyroscope/pyroscope:latest"
    ports:
      - "4040:4040"
    command:
      - "server"
  app:
    image: "my-app:latest"
    environment:
      PYROSCOPE_APPLICATION_NAME: my.dotnet.app
      ASPNETCORE_URLS: http://*:5000
    ports:
      - "5000:5000"
    cap_add:
      - SYS_PTRACE

在 Python 应用中使用 Pyroscope

首先，安装 pyroscope-io 的 pip 包：

pip install pyroscope-io

然后在你的应用中添加下面的代码。这些代码将会初始化 pyroscope 分析器并且启动分析：

import pyroscope
pyroscope.configure(
  app_name       = "my.python.app", # 将这里替换为你的应用名称
  server_address = "http://my-pyroscope-server:4040", # 将这个地址替换为你的 pyroscope 服务端地址
# auth_token     = "{YOUR_API_KEY}", # 如果 pyroscope 服务端启用了认证，需要指定 API 密钥
)

查看 pyroscope 仓库中的 python 项目中的 pyroscope 示例来获取更多使用示例。

要开始分析容器里的 PHP 应用，你需要用 pyroscope exec 来包装你的应用程序作为镜像的 entrypoint。你需要在你的 Dockerfile 中使用 COPY —from 将 pyroscope 可执行二进制拷贝到你的容器里。下面的 Dockerfile 演示了如何构建这个镜像：

如果你正在使用 Docker Compose，那么你可以使用下面的配置同时运行 pyroscope 服务端和客户端。

---
services:
  pyroscope-server:
    image: "pyroscope/pyroscope:latest"
    ports:
      - "4040:4040"
    command:
      - "server"
  app:
    image: "my-app:latest"
    env:
      PYROSCOPE_SERVER_ADDRESS: http://pyroscope-server:4040
      PYROSCOPE_APPLICATION_NAME: my.php.app
    cap_add:
      - SYS_PTRACE

在 NodeJS 应用中使用 Pyroscope

要在一个 NodeJS 项目中启用 pyroscope 分析器，你需要使用 npm 来导入模块：

npm install @pyroscope/nodejs
# 或者
yarn add @pyroscope/nodejs

然后，在你的应用中添加下面的代码：

const Pyroscope = require('@pyroscope/nodejs');
Pyroscope.init({
  serverAddress: 'http://pyroscope:4040',
  appName: 'myNodeService'
});
Pyroscope.start()