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金鑰。如果該組織的其他專案仍保持連接，請保留組織金鑰。