GitLab Knowledge Server コネクタを使用すると、Microsoft 365 Copilotと Microsoft Search で、GitLab の自己管理インスタンスに格納されているナレッジ コンテンツのインデックスを作成できます。 この記事では、コネクタのデプロイ、構成、またはインジェスト中に発生する可能性がある一般的なエラーのトラブルシューティング ガイダンスについて説明します。
認証エラー
コネクタの承認中に認証が失敗した場合:
- クライアント ID とクライアント シークレットが正しい GitLab OAuth アプリケーションから生成されたことを確認します。
- 必要なスコープ (
read_api、read_repository、read_user) が付与されていることを確認します。 - リダイレクト URL が環境と一致していることを確認します。
- Microsoft 365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 Government:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Enterprise:
- 認証アカウントがリポジトリ、Wiki、およびドキュメント ファイルにアクセスできることを確認します。
インデックスを作成しないコンテンツ
インジェストが開始されても項目が表示されない場合:
- Microsoft Graph コネクタ エージェントを実行しているサーバーから GitLab インスタンスに到達可能であることを確認します。
- GitLab の API レート制限によってインジェストがブロックされていないことを確認します。 ユーザー、IP、または API 要求の制限を無効または上げます。
- GitLab バージョンが 17.7 以降であることを確認します。
- エージェントのバージョンが 3.1.8.0 以降であることを確認します。
- コネクタ アカウントに、関連するすべてのプロジェクトのリポジトリと Wiki アクセス権があることを確認します。
インジェストまたはクロールの遅延が遅い
インジェストが遅く完了した場合:
- User、IP、Files API、非推奨 API、Users API、Groups API、Projects API、Members API の GitLab レート制限しきい値を引き上げます。
- 大規模な環境の場合は、次のガイダンスを使用します。
- 最大 100,000 アイテム: 9,000 要求/時間
- 100,000 ~ 1,000,000 アイテム: 15,000 件/時間
- 1,000,000 を超えるアイテム: 15,000 要求/時間。インジェストには、システムの負荷に応じて 1 ~ 2 週間かかる場合があります
アクセス許可の不一致
ユーザーがアクセスできない検索結果を表示する場合、またはアクセスできる必要がある結果が表示されない場合:
- ID マッピングが正しく構成されていることを確認します。 サポートされているマッピング属性には、メール、ログイン、名前が含まれます。
- GitLab と Microsoft Entra ID の間でユーザー属性が一致しない場合は、値を変換するように正規表現 (regex) を構成します。
- GitLab のメールの可視性設定または混在ドメインが正確なマッピングを妨げているかどうかを確認します。
- 選択したアクセス モデル (このデータ ソースまたは Everyone へのアクセス権を持つユーザーのみ) が、organizationの要件と一致していることを確認します。
マージ要求またはロールベースのアクセスの問題
ユーザーがマージ要求または特定の GitLab ロールでアクセス許可の問題が発生した場合:
- プロジェクト メンバーに限定されたパブリック プロジェクトのマージ要求へのアクセスは、Reporter ロール以上で適用されます。
- Planner ロールは、安定性上の理由から非推奨です。 アクセスを必要とするユーザーに、Reporter ロール以上のロールを割り当てます。
Microsoft Graph コネクタ エージェントの問題
エージェントが接続に失敗した場合、またはエラーが報告された場合:
- エージェント ホスト コンピューターが、必要なポートを介して GitLab Server インスタンスに到達できることを確認します。
- エージェントに十分なメモリと CPU 容量があることを確認します。
- エージェント サービスを再起動し、もう一度インジェストを試みます。