Logfire

连接Pydantic Logfire，让智能体可以查询你的项目接收的链路追踪、日志和指标，并让它的告警在触发的那一刻到达Polylane。

设置

Logfire在项目密钥上发放查询访问权限，在组织密钥上发放通知渠道访问权限，所以连接一个项目需要两者。分别连接每个项目；组织密钥可以在该组织的每个项目中复用。

项目API密钥（先输入）

1. 在Logfire中，打开你的项目，然后Project settings，然后Security & access，然后New API key
2. 勾选Read-only access和Manage project and org，把Key type保持为Project，然后Create API key
3. 把密钥粘贴到Polylane中。区域（US或EU）从密钥前缀检测，Polylane显示该密钥所属的项目。

组织API密钥（后输入）

1. 从Project settings选择Go to org settings，然后Security & access，然后New API key
2. 勾选Read-only access和Manage project and org，把Key type设为Organization，然后Create API key
3. 把密钥粘贴到Polylane中。Polylane检查该密钥的组织是否拥有第一个密钥指定的项目。

每个密钥在你粘贴时都会显示Logfire是否接受了它，两个都通过后Connect才可用。两个密钥在存储前都加密，智能体永远看不到它们。

智能体能做什么

• 列出在某个时间窗口内向该项目上报过的服务
• 按请求数、错误率和p50/p95延迟对路由排名
• 按服务、span名称、路由、级别、异常标志或HTTP状态搜索span和日志
• 把一条链路追踪打开为带有时长和异常消息的父/子span树
• 当精选工具无法覆盖问题时，对records和metrics表运行一条只读SQL语句

告警

连接时，Polylane把自己添加为Logfire项目上的一个通知渠道，并把该渠道附加到项目已有的每条告警，你已经配置的渠道保持不变。你之后添加的告警会在一小时内被拾取。Logfire触发的每条告警都以Polylane可以调查的故障到达。断开连接会移除该渠道并把它从每条告警上分离。

每个查询都限定在最多七天的时间窗口内，原始SQL路径只接受一条SELECT语句。

为什么需要两个密钥

项目密钥覆盖智能体查询的链路追踪和指标：Logfire只在绑定到一个项目的密钥上发放该权限。组织密钥让Polylane可以读取项目的告警和现有通知渠道，创建自己的渠道（Logfire把渠道保存在组织级别，这就是项目密钥做不到这一点的原因），并把它附加到每条告警，这样告警在触发的那一刻就能到达Polylane，故障可以更早打开。

持续验证

Polylane每六小时验证两个已存储的密钥，并在Logfire拒绝任一密钥或组织密钥不再列出该项目时标记该集成，所以被撤销的密钥会在调查需要它之前浮现。

断开连接

在Polylane中断开Logfire，然后在Logfire中于Project settings、然后Security & access下撤销项目API密钥，并于Org settings、然后Security & access下撤销组织API密钥。如果该组织的其他项目仍保持连接，请保留组织密钥。