---
title: sigiro 문서
description: >-
  sigiro는 스스로 복구하는 소프트웨어를 위한 탐지 및 진단 계층입니다. OpenTelemetry가 들어가고, 순위가 매겨진 결과와 실행
  가능한 SQL이 나옵니다. 대시보드가 아니라 에이전트를 위한 것입니다.
sidebar:
  order: 0
---
sigiro는 대시보드가 아니라 에이전트를 위한 관측성 백엔드입니다. sigiro는
OpenTelemetry를 읽습니다. 그리고 자동 루프가 결함을 복구하기 전에 반드시 답해야
하는 두 가지 질문에 답합니다. **무엇이 변경되었는지**, 그리고 **왜 그런지**입니다.

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

## 튜토리얼

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

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

## 사용 방법 가이드

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

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

## 참조

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

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

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

## 설명

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

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