sigiro ドキュメント

sigiro は、自己修復するソフトウェアのための検知および診断のレイヤーです。OpenTelemetry を入力すると、ランク付けされた結果と実行可能な SQL が出力されます。ダッシュボードのためではなく、エージェントのためのものです。

sigiro は、ダッシュボードのためではなくエージェントのための可観測性バックエンドです。 OpenTelemetry を読み取ります。そして、自動化されたループが障害を修復する前に必ず答えなければならない 2 つの問いに答えます。すなわち、何が変わったのか、そしてなぜかです。

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

チュートリアル

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

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

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

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

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

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

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

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