Pydantic Logfire 可观测性 — OTEL 生成式 AI 追踪、工具调用 span、Token 指标、分布式追踪
OpenClaw Logfire 插件是一项面向实际任务的技能,主要用于OpenClaw 的 Pydantic Logfire 监视插件;追踪 OTEL GenAI 语义常规的全部代理寿命周期 — 工具调用、 符号使用、 错误和可选。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
OpenClaw 的 Pydantic Logfire 可观测性插件。遵循 OTEL GenAI 语义规范,完整追踪智能体全生命周期 —— 包括工具调用、Token 使用量、错误信息,以及可选的跨服务分布式追踪。
openclaw plugins install @ultrathink-solutions/openclaw-logfire
设置您的 Logfire 写入令牌:
export LOGFIRE_TOKEN="your-token"
在 openclaw.json 中添加配置:
{
"plugins": {
"entries": {
"openclaw-logfire": {
"enabled": true,
"config": {}
}
}
}
}
重启 OpenClaw。追踪数据将显示在您的 Logfire 控制台中。
每次智能体调用均生成一棵 Span 树:
invoke_agent chief-of-staff (根 Span) |-- execute_tool Read (文件读取) |-- execute_tool exec (Shell 命令执行) |-- execute_tool Write (文件写入)
Span 遵循 OTEL GenAI 语义规范:例如 gen_ai.agent.name、gen_ai.tool.name、gen_ai.usage.input_tokens、gen_ai.usage.output_tokens 等。
gen_ai.client.token.usage — Token 数量直方图(输入 / 输出)gen_ai.client.operation.duration — 智能体调用延迟| 配置项 | 默认值 | 说明 |
|---|---|---|
environment |
development |
部署环境标签 |
serviceName |
openclaw-agent |
OTEL 服务名称 |
providerName |
— | GenAI 提供商(例如 anthropic) |
captureToolInput |
true |
记录工具参数 |
redactSecrets |
true |
脱敏 API 密钥与 JWT 等敏感凭证 |
distributedTracing.enabled |
false |
启用 W3C traceparent 传播 |
captureToolOutput: false)captureMessageContent: false)| URL | 发送的数据 |
|---|---|
https://logfire-api.pydantic.dev(美国) |
OTLP 追踪数据 + 指标 |
https://logfire-api-eu.pydantic.dev(欧盟) |
OTLP 追踪数据 + 指标 |
使用本插件时,追踪与指标数据将被发送至 Pydantic Logfire。请仅在您信任该目标服务的前提下安装。
相关专题
热门下载
相关下载
精品课程
共1课时 | 175人学习
共0课时 | 0人学习
共1课时 | 225人学习
最新文章