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 지연 시간으로 라우트 순위 매기기
• 서비스, 스팬 이름, 라우트, 레벨, 예외 플래그, HTTP 상태로 스팬과 로그 검색
• 트레이스 하나를 소요 시간과 예외 메시지가 담긴 부모/자식 스팬 트리로 열기
• 선별된 도구가 질문을 다루지 못할 때 records와 metrics 테이블에 대해 읽기 전용 SQL 문 하나 실행

경보

연결 시 Polylane은 자신을 Logfire 프로젝트의 알림 채널로 추가하고 그 채널을 프로젝트의 모든 경보에 연결하며, 이미 구성한 채널은 그대로 둡니다. 나중에 추가하는 경보는 한 시간 이내에 반영됩니다. Logfire가 발생시키는 각 경보는 Polylane이 조사할 수 있는 인시던트로 도착합니다. 연결을 해제하면 채널이 제거되고 모든 경보에서 분리됩니다.

모든 질의는 최대 7일의 시간 창으로 범위가 정해지며, 원시 SQL 경로는 SELECT 문 하나만 받습니다.

왜 두 개의 키인가

프로젝트 키는 에이전트가 질의하는 트레이스와 메트릭을 다룹니다: Logfire는 그 스코프를 하나의 프로젝트에 묶인 키에만 발급합니다. 조직 키는 Polylane이 프로젝트의 경보와 기존 알림 채널을 읽고, 자체 채널을 만들고(Logfire는 채널을 조직 수준에서 관리하므로 프로젝트 키로는 할 수 없습니다), 각 경보에 연결하여 경보가 발생하는 순간 Polylane에 도달하고 인시던트를 일찍 열 수 있게 합니다.

지속적인 검증

Polylane은 저장된 두 키를 6시간마다 검증하고, Logfire가 어느 키든 거부하거나 조직 키가 더 이상 프로젝트를 나열하지 않으면 통합에 표시하므로, 취소된 키는 조사에 필요해지기 전에 드러납니다.

연결 해제

Polylane에서 Logfire의 연결을 해제한 뒤, Logfire에서 Project settings, Security & access의 프로젝트 API 키와 Org settings, Security & access의 조직 API 키를 취소하세요. 조직의 다른 프로젝트가 연결된 채로 남아 있으면 조직 키는 유지하세요.