CLI
sigiro のすべてのサブコマンド、その引数、および読み取る環境変数。sigiro には 7 つのサブコマンドがあり、クライアント側はインデントされた JSON を出力します。
sigiro には 9 つのサブコマンドがあります。すべてのサブコマンドは、成功時にインデントされた
JSON を出力します。2 つ目の出力形式は存在せず、TTY 検出も行いません。
新規ユーザーは sigiro signup --name "Your Name" --email you@example.com を実行します。
6 桁の OTP がメールで届き、ターミナルで安全に入力すると、個人用ワークスペースを 1 つだけ
作成・有効化し、ブラウザーなしで OAuth デバイス認証を内部的に完了して、更新・アクセス資格情報を
OS の資格情報ストアに保存します。既存アカウントはブラウザーベースの sigiro auth login を使用します。
sigiro auth status、sigiro auth token、sigiro auth logout でログイン状態を管理します。
グローバルフラグ --token <TOKEN> は、自動化用のベアラートークンを明示的に設定します。
このフラグは SIGIRO_ACCESS_TOKEN を上書きします。Open モードのセルフホスト型サーバーには不要ですが、静的ベアラー認証を設定したサーバーには必要です。
すべてのクライアントサブコマンドは、SIGIRO_ENDPOINT に指定されたサーバーに接続します。
デフォルトは http://localhost:9999 です。
serve
OTLP gRPC サーバー、OTLP HTTP サーバー、およびクエリ API を起動します。
| フラグ | 上書き対象 | デフォルト |
|---|---|---|
--data-dir <PATH> |
SIGIRO_DATA_DIR |
~/.local/share/sigiro |
--http-port <PORT> |
SIGIRO_HTTP_PORT |
9999 |
--otlp-http-port <PORT> |
SIGIRO_OTLP_HTTP_PORT |
4318 |
--otlp-grpc-port <PORT> |
SIGIRO_GRPC_PORT |
4317 |
初回起動時には、クエリ拡張機能がデータディレクトリにダウンロードされます。このダウンロードには 30〜90 秒かかり、その間は起動がブロックされます。
diagnose
sigiro diagnose <SERVICE> は、1 つのサービスに対して 1 つの診断ブロックを返します。
| フラグ | 型 | デフォルト |
|---|---|---|
--from <EPOCH_SECONDS> |
整数 | 現在から 15 分前 |
--to <EPOCH_SECONDS> |
整数 | 現在 |
--from と --to はエポック秒です。対応する HTTP フィールド名は
from_ts と to_ts であり、こちらはエポックマイクロ秒です。どちらの HTTP フィールドも
省略可能です。両方を省略した場合、サーバーは直近 15 分間を読み取ります。これは CLI が使用するのと
同じウィンドウです。
このコマンドは JSON を出力します。出力を絞り込むには、jq にパイプしてください。CLI 自体は
フィルターを一切適用しないため、CLI と API は同じドキュメントを返します。
anomalies
sigiro anomalies は、検出されたレジームシフトを、変化の大きいものから順に一覧表示します。
各行には、シグナル横断的な incident_id が含まれます。
| フラグ | 型 | デフォルト |
|---|---|---|
--service <NAME> |
文字列 | すべてのサービス |
--from <EPOCH_SECONDS> |
整数 | 下限なし |
--to <EPOCH_SECONDS> |
整数 | 上限なし |
各行は、スケジュールされたパスが書き込む sigiro_anomalies テーブルから取得されます。
リクエスト時に計算される項目はありません。
query
sigiro query "<SQL>" は、ローカルクライアントではなくフェデレーテッドコーディネーターです。
1 つ以上のエッジを解決し、各エッジに部分クエリをプッシュして、その部分結果を 1 つの回答に
まとめます。
| フラグ | 型 | デフォルト |
|---|---|---|
<SQL> |
文字列 | なし |
--edge <NAME=HOST:PORT> |
繰り返し指定可能 | なし |
--full-scan |
フラグ | オフ |
エッジの解決順序は次のとおりです。SIGIRO_EDGES（カンマ区切りの
name=host:port）と --edge はそのまま使用され、いずれか一方が設定されていればディスカバリーは
スキップされます。どちらも設定されていない場合、sigiro は tailscale status --json を実行し、
tag:sigiro-edge のタグが付いたすべてのピアを取得します。解決されたエッジが 0 個の場合、
コマンドは何も対象がない状態で実行するのではなく、失敗します。
したがって sigiro query は、単純なローカルサーバーに対しては動作しません。エッジは
SIGIRO_QUERY_SURFACE=quack でデータを提供している必要があり、--edge で指定するか、
tailnet 上で見つける必要があります。1 つのローカルサーバーに対して SQL を実行するには、
代わりに SQL を /v1/query に POST してください。
--full-scan は、timestamp に対する WHERE 境界のないクエリを許可します。sigiro は
デフォルトではそのようなクエリを拒否します。
status
sigiro status はサーバーの /health エンドポイントを読み取り、ヘルスブロックを出力します。
/health にキーは不要です。
healthcheck
sigiro healthcheck はローカルの /health エンドポイントをプローブし、サーバーが準備完了の場合に
のみ 0 を返して終了します。distroless イメージにはシェルも curl も含まれていないため、これが
コンテナの HEALTHCHECK になります。