Orbitのトラブルシューティング

このページでは、Orbit LocalまたはOrbit Remoteで発生する可能性のあるエラーのトラブルシューティング方法を説明します。

Orbit Local

Orbit Localのエラーは、orbitバイナリを直接実行するか、glab orbit localを通じて実行する際に発生します。

no local graph found

症状:

Error: no local graph found at ~/.orbit/graph.duckdb. Run `orbit index` first.

原因: リポジトリがまだインデックス作成されていないか、指定した--dbパスが存在しません。古いバージョンのOrbit Localでは、このエラーはTable 'Definition' does not existとして報告されていました。

解決策: 最初にリポジトリのインデックスを作成してください:

glab orbit local index /path/to/your/repo

IO Error: Could not set lock on file

症状: コマンドが一時的に停止したように見えた後、Could not set lock on fileを含むエラーで失敗します。

原因: 別のorbitプロセスがすでに実行中で、DuckDBの書き込みロックを保持しています。Orbitは指数バックオフで自動的に再試行しますが、リトライウィンドウ内にロックが解放されない場合は失敗します。

解決策: 他のプロセスが終了するまで待つか、停止してください:

pkill orbit

その後、コマンドを再試行してください。

list_contains source_tags

症状: list_contains source_tagsを含むエラーでクエリが失敗します。

原因: source_tagsプロパティを含む特定のフィルターの組み合わせによって引き起こされる既知のバグです。

解決策: クエリからsource_tagsフィルターを削除して再試行してください。

error: unrecognized subcommand 'mcp'

症状:

error: unrecognized subcommand 'mcp'

原因: orbit mcp serveサブコマンドはまだ実装されていません。Orbit LocalのMCPサポートはロードマップに含まれていますが、現在のリリースでは利用できません。

解決策: サポートされているアクセス方法のいずれかを使用してください。

Orbit Remote

Orbit Remoteのエラーは、glab orbit remoteコマンドを実行する際に発生します。Orbit RemoteにはGitLab PremiumまたはUltimateと、インスタンスで有効化されたknowledge_graph機能フラグが必要です。

終了コード2

症状: glab orbit remoteコマンドがコード2で終了します。

原因: knowledge_graph機能フラグがネームスペースまたはインスタンスで有効化されていません。

解決策: GitLab管理者に連絡して、ネームスペースのknowledge_graph機能フラグを有効化してもらってください。

終了コード3

症状: glab orbit remoteコマンドがコード3で終了します。

原因: GitLab CLIで認証されていません。

解決策: ログインしてください:

glab auth login

MCPエンドポイントでのinsufficient_scope

症状: OrbitのMCPエンドポイントへの接続がinsufficient_scopeで失敗します。

原因: パーソナルアクセストークンまたはOAuthトークンにmcp_orbitスコープが含まれていません。MCPトランスポートにはread_apiスコープだけでは不十分です。

解決策: mcp_orbitスコープを持つ新しいトークンを作成するか、追加のスコープを付与するために再認証してください。