PHP Profiling 最佳实践

ACK 集群

1. 登录容器服务管理控制台，在左侧导航栏选择集群列表，单击目标集群名称。

2. 在左侧导航栏选择组件管理，找到 arms-obi 组件并安装，installMode 选择 profiling。

其他集群

手动部署以下 YAML。安装前替换以下变量：

• ARMS_REGION_ID：填写需要上报的 region。

• ARMS_LICENSE_KEY：填写 UID 对应的 LicenseKey。

• image 中的 ARMS_REGION_ID：替换为当前所在 region。

---
apiVersion: v1
kind: Namespace
metadata:
  name: obi-system
  labels:
    app: pprof-agent

---
apiVersion: v1
kind: ConfigMap
metadata:
  name: pprof-agent-receiver-config
  namespace: obi-system
  labels:
    app: pprof-agent
    mode: receiver
data:
  config.yaml: |
    collector:
      enabled: false            # 纯推模式，不做 Go 拉取（无需 RBAC / NODE_NAME）
    receiver:
      enabled: true
      listen: ":8126"           # PHP 侧 DD_TRACE_AGENT_URL 指向此端口
      path: "/profiling/v1/input"
      max_body_size: 20480      # 单次上报 body 上限（KB）
      service_tag: "service"    # 取 tags_profiler 的 service 作为 appName（= PHP 侧 DD_SERVICE）
      profile_type: "php"       # 回退用类型标识（已被 profile_types 取代）
      profile_types:            # 同一份 pprof 按这些维度各发布一份，ARMS 各视图才能读到
        - cpu
        - mem
      go_compatible: true       # 把 dd-trace-php 的 sample type 名改写为 ARMS GoProfileAnalyzer 认识的 Go 名字
    storage:
      type: "oss"
      oss:
        # region_id 留空 → 从 env ARMS_REGION_ID 读取，两者都空时默认 cn-hangzhou。
        region_id: ""
        bucket: "arms-profiling"
        endpoint: ""            # 为空时由 region_id + internal 推导
        path_prefix: "profiling/"
        internal: true          # 生产建议 true（VPC 内网）；跨区域/无内网时改 false
    arms:
      # license_key 留空 → 从 env ARMS_LICENSE_KEY 读取（下方 Secret 注入）。
      # uid 无需填写：代码会从 license_key 自动反解（GetUserId）。
      # region_id 留空 → 回退到 storage.oss.region_id（即 env ARMS_REGION_ID）。
      license_key: ""
      region_id: ""
      app_name_label: "app"
      workspace: ""
      endpoint: ""

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: pprof-agent-receiver
  namespace: obi-system
  labels:
    app: pprof-agent
    mode: receiver
spec:
  # 推模式由 Service 负载均衡，每个上报只命中一个副本，不会重复上传，可按吞吐独立伸缩。
  replicas: 1
  selector:
    matchLabels:
      app: pprof-agent
      mode: receiver
  template:
    metadata:
      labels:
        app: pprof-agent
        mode: receiver
    spec:
      terminationGracePeriodSeconds: 70
      containers:
        - name: agent
          image: registry-{ARMS_REGION_ID}-vpc.ack.aliyuncs.com/acs/obi:pprof-agent-0.10.2
          imagePullPolicy: Always
          command: ["/usr/local/bin/pprof-agent"]
          args:
            - "--config"
            - "/etc/pprof-agent/config.yaml"
          env:
            - name: POD_NAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name
            # ARMS 凭证经 Secret 注入（凭证不落 ConfigMap）。
            # 只需 license_key；uid 由 license_key 自动反解，无需注入。
            - name: ARMS_LICENSE_KEY
              value: "xxxxxxx"
            # 区域：同时决定 OSS 上传区域与 ARMS 元数据区域；不设则默认 cn-hangzhou。
            - name: ARMS_REGION_ID
              value: "xxxxxxxx"
          volumeMounts:
            - name: config
              mountPath: /etc/pprof-agent
              readOnly: true
          resources:
            requests:
              cpu: 100m
              memory: 128Mi
            limits:
              cpu: "1"
              memory: 512Mi
          ports:
            - name: intake
              containerPort: 8126
              protocol: TCP
            - name: health
              containerPort: 8080
              protocol: TCP
          livenessProbe:
            httpGet:
              path: /healthz
              port: 8080
            initialDelaySeconds: 10
            periodSeconds: 30
          readinessProbe:
            httpGet:
              path: /healthz
              port: 8080
            initialDelaySeconds: 5
            periodSeconds: 10
      volumes:
        - name: config
          configMap:
            name: pprof-agent-receiver-config
            items:
              - key: config.yaml
                path: config.yaml

---
apiVersion: v1
kind: Service
metadata:
  name: arms-obi-pprof-agent-receiver
  namespace: obi-system
  labels:
    app: pprof-agent
    mode: receiver
spec:
  selector:
    app: pprof-agent
    mode: receiver
  ports:
    - name: intake
      port: 8126
      targetPort: 8126
      protocol: TCP