sigiro 문서

sigiro는 스스로 복구하는 소프트웨어를 위한 탐지 및 진단 계층입니다. OpenTelemetry가 들어가고, 순위가 매겨진 결과와 실행 가능한 SQL이 나옵니다. 대시보드가 아니라 에이전트를 위한 것입니다.

sigiro는 대시보드가 아니라 에이전트를 위한 관측성 백엔드입니다. sigiro는 OpenTelemetry를 읽습니다. 그리고 자동 루프가 결함을 복구하기 전에 반드시 답해야 하는 두 가지 질문에 답합니다. 무엇이 변경되었는지, 그리고 왜 그런지입니다.

이 문서는 네 부분으로 구성됩니다. 각 부분은 서로 다른 종류의 질문에 답하므로, 지금 가지고 있는 질문에 해당하는 부분으로 이동하십시오.

튜토리얼

수업입니다. sigiro에 대한 사전 지식을 전제하지 않으므로 이 부분을 먼저 읽으십시오. 각 단계를 따라가면 단계마다 결과를 확인할 수 있습니다.

• 퀵스타트 — 서버를 실행하고, 텔레메트리를 서버로 전송한 다음, 무엇이 변경되었고 왜 그런지 질의합니다. 5분이 소요됩니다.

사용 방법 가이드

한 가지 작업에 대한 지침입니다. 원하는 것이 무엇인지 이미 알고 있고 그것을 달성하기 위한 단계가 필요할 때 이 부분을 읽으십시오.

• 에이전트로 코드 계측하기 — 에이전트에게 프롬프트 하나를 전달하십시오. 에이전트가 OpenTelemetry를 서비스에 연결하고 이를 sigiro로 향하게 합니다.
• 호스팅형 sigiro로 텔레메트리 전송하기 — 서버를 직접 운영하지 않습니다. 테넌트 키와 함께 OTLP를 당사가 운영하는 호스트로 전송합니다.
• 에이전트 자체 텔레메트리를 sigiro로 전송하기 — Claude Code 또는 Codex를 sigiro로 향하게 한 다음, SQL로 세션을 다시 읽어들입니다.

참조

머신에 관한 사실입니다. 이름, 타입 또는 제한값을 확인하기 위해 작업 중에 이 부분을 읽으십시오.

• API 참조 — 다섯 개의 엔드포인트입니다. 각 엔드포인트에는 요청 플레이그라운드가 있습니다. sigiro는 서버가 게시하는 것과 동일한 /openapi.json 문서로부터 이 페이지들을 생성하므로, 페이지는 항상 API와 일치합니다.
• CLI 참조 — 일곱 개의 하위 명령, 모든 플래그, 그리고 이들이 읽는 모든 환경 변수입니다.

/openapi.json을 읽는 에이전트는 당사로부터 다른 정보를 필요로 하지 않습니다.

설명

sigiro가 왜 지금과 같은 방식으로 동작하는지에 대한 설명입니다. 그 이유, 비용, 그리고 대안을 알고 싶을 때 이 부분을 읽으십시오. 터미널은 필요하지 않습니다.

• 테이블과 그것이 설명하는 머신에 대하여 — sigiro_metrics_*와 sys_*가 왜 서로 다른 머신에 관한 질문에 답하는지, 그리고 확신에 찬 잘못된 답변을 피하는 방법입니다.
• 대시보드가 아닌 증거에 대하여 — 왜 그 답변이 모든 행에 실행 가능한 쿼리가 딸린 순위 목록인지에 대한 설명입니다.
• 배포 탐지와 스팬이 담고 있어야 하는 것에 대하여 — sigiro는 배포를 찾기 위해 하나의 속성을 읽으며, 그 속성이 없으면 아무 말도 하지 않습니다.