---
title: sigiro ドキュメント
description: >-
  sigiro は、自己修復するソフトウェアのための検知および診断のレイヤーです。OpenTelemetry を入力すると、ランク付けされた結果と実行可能な
  SQL が出力されます。ダッシュボードのためではなく、エージェントのためのものです。
sidebar:
  order: 0
---
sigiro は、ダッシュボードのためではなくエージェントのための可観測性バックエンドです。
OpenTelemetry を読み取ります。そして、自動化されたループが障害を修復する前に必ず答えなければならない
2 つの問いに答えます。すなわち、**何が変わったのか**、そして**なぜか**です。

本ドキュメントは 4 つのパートで構成されています。各パートはそれぞれ異なる種類の問いに答えるため、
いま抱えている問いに合致するパートへ進んでください。

## チュートリアル

レッスンです。sigiro の知識を前提としていないため、まずこのパートを読んでください。
各手順に従って進めると、手順ごとに結果を確認できます。

- **[クイックスタート](/docs/tutorials/quickstart)** — サーバーを起動し、テレメトリを
  送信して、何が変わったのか、そしてなぜかを問い合わせます。所要時間は 5 分です。

## ハウツーガイド

1 つのタスクを実行するための手引きです。やりたいことが決まっていて、
それを実現する手順が必要なときにこのパートを読んでください。

- **[エージェントでコードを計装する](/docs/how-to/install-with-ai)** —
  エージェントにプロンプトを 1 つ渡します。エージェントが OpenTelemetry をサービスに接続し、
  sigiro に向けて設定します。
- **[ホスト版 sigiro にテレメトリを送信する](/docs/how-to/hosted-onboarding)** —
  自分でサーバーを運用する必要はありません。テナントキーを添えて、当社が運用するホストへ OTLP を送信します。
- **[エージェント自身のテレメトリを sigiro に送信する](/docs/how-to/agent-telemetry)** —
  Claude Code または Codex を sigiro に向けて設定し、SQL でセッションを読み返します。

## リファレンス

このマシンに関する事実です。名前、型、上限を確認するために、作業中にこのパートを読んでください。

- **[API リファレンス](/docs/reference)** — 5 つのエンドポイントがあります。各エンドポイントには
  リクエストのプレイグラウンドが用意されています。sigiro はこれらのページを、サーバーが公開している
  `/openapi.json` ドキュメントそのものから生成するため、ページの内容は常に API と一致します。
- **[CLI リファレンス](/docs/reference/cli)** — 7 つのサブコマンド、すべてのフラグ、
  そしてそれらが読み取るすべての環境変数です。

`/openapi.json` を読み取るエージェントには、当社からの他の情報は必要ありません。

## 解説

sigiro がこのように動作する理由です。理由、コスト、そして代替案を知りたいときに
このパートを読んでください。ターミナルは必要ありません。

- **[テーブルについて、およびそれらがどのマシンを記述しているか](/docs/explanation/tables)**
  — `sigiro_metrics_*` と `sys_*` が異なるマシンについての問いに答えるのはなぜか、
  そして自信ありげな誤答を避ける方法。
- **[ダッシュボードではなくエビデンスについて](/docs/explanation/evidence)** —
  答えが、各行に実行可能なクエリを備えたランク付きリストである理由。
- **[デプロイ検知について、およびスパンが保持していなければならないもの](/docs/explanation/deploys)**
  — sigiro はデプロイを見つけるために 1 つの属性を読み取り、その属性が存在しない場合は何も述べません。