配置 OTLP 端点
- 打开 Sandbox 控制台设置，找到 OpenTelemetry 区域。
- 在 OTLP Endpoint 中填入 OpenTelemetry Collector 或可观测性平台提供的基础 URL。
- 如果接收端需要鉴权或其他请求头，在 Headers 中添加，最多可配置 32 个。
- 打开 Enable export，点击 Save。
可用遥测数据
本页介绍可用的指标和事件信息。如果希望直接通过 SDK 或 CLI 查询数据，参见 Sandbox 指标 和 Sandbox 事件。
Resource 属性
每个 Resource 都包含以下字符串属性：下文所有指标名与业务属性使用默认前缀
ppio.sandbox.。实际前缀由服务端配置决定。Sandbox 资源指标
资源指标使用service.name = ppio.sandbox.metrics。六个指标全部为 Gauge，表示采样时刻的值，每个数据点附带采样时间戳。
CPU 利用率导出时不乘以或除以 100，不要仅凭单位
1 推断值的范围为 0–1。内存和磁盘指标的单位字符串为 MB，但数值由字节除以 1024² 得到，实际为 MiB。
资源指标属性
每个数据点包含以下字符串属性：
使用这些属性可以按 Sandbox 筛选，或在模板、Region 之间对比资源使用。当对应的 total 大于 0 时，内存利用率可按
mem_use_mb / mem_total_mb 计算，磁盘利用率可按 disk_use_mb / disk_total_mb 计算。
组织配额与用量
组织指标使用service.name = ppio.sandbox.organization。所有指标均为 Gauge 类型，取整数值，每个数据点附带采集时间戳。
配额
当前用量
将每个并发用量指标与对应的限制对比，即可监控剩余容量。有关 Sandbox 限制的更多信息，参见 配额与限制。
组织指标属性
每个数据点包含以下字符串属性：
当某个可选源值缺失时，发送端会跳过对应的
limit.concurrent_cpu_core、limit.concurrent_mem_mb 或 usage.concurrent_mem_mb 数据点。不要把缺失的点当作 0 处理。其他指标值为 0 时仍会发送。
生命周期事件
生命周期事件使用service.name = ppio.sandbox.events，以 Logs 形式导出，不是 Metrics。它们描述 Sandbox 的生命周期操作，而不是命令的 stdout 或 stderr。如需获取命令输出，参见 命令流式输出。
事件信息
每条事件包含时间戳、严重级别、消息和下文列出的属性。- 事件时间：事件发生的时间。源时间戳缺失时取当前时间。
- 观察时间：该批事件准备导出的时间。
- 严重级别：状态为
fail或 HTTP 状态码 ≥ 500 时为ERROR，否则为INFO。Severity Text 为事件状态，如success或fail。 - 消息：
sandbox lifecycle event: <event_name>。
事件属性
按
sandbox_id 过滤事件可以排查单个 Sandbox 的问题；使用 event_name、state、status_code 和 error_msg 定位失败的操作；使用 latency_ms 查看请求耗时。