Behandeln von Problemen mit dem GitLab Knowledge Server Microsoft 365 Copilot Connector

Der GitLab Knowledge Server-Connector ermöglicht Microsoft 365 Copilot und Microsoft Search das Indizieren von Wissensinhalten, die in Ihrem selbstverwalteten GitLab-instance gespeichert sind. Dieser Artikel enthält Anleitungen zur Problembehandlung bei häufigen Fehlern, die bei der Bereitstellung, Konfiguration oder Erfassung des Connectors auftreten können.

Authentifizierungsfehler

Wenn die Authentifizierung während der Connectorautorisierung fehlschlägt:

Vergewissern Sie sich, dass die Client-ID und der geheime Clientschlüssel aus der richtigen GitLab OAuth-Anwendung generiert wurden.
Stellen Sie sicher, dass die erforderlichen Bereiche gewährt werden: read_api, read_repositoryund read_user.
Stellen Sie sicher, dass die Umleitungs-URL mit der Umgebung übereinstimmt:
- Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
Stellen Sie sicher, dass das Authentifizierungskonto Zugriff auf Repositorys, Wikis und Dokumentationsdateien hat.

Inhalt wird nicht indiziert

Wenn die Erfassung beginnt, aber keine Elemente angezeigt werden:

Stellen Sie sicher, dass die GitLab-instance vom Server aus erreichbar ist, auf dem der Microsoft Graph-Connector-Agent ausgeführt wird.
Stellen Sie sicher, dass API-Ratenlimits in GitLab die Erfassung nicht blockieren. Deaktivieren oder erhöhen Sie die Grenzwerte für Benutzer-, IP- oder API-Anforderungen.
Vergewissern Sie sich, dass die GitLab-Version 17.7 oder höher ist.
Überprüfen Sie, ob die Agent-Version 3.1.8.0 oder höher ist.
Vergewissern Sie sich, dass das Connectorkonto über Repository- und Wiki-Zugriff für alle relevanten Projekte verfügt.

Langsame Erfassungs- oder Durchforstungsverzögerungen

Wenn die Erfassung langsam abgeschlossen wird:

Erhöhen Sie die GitLab-Ratenbegrenzungsschwellenwerte für Benutzer, IP-Adresse, Datei-API, veraltete API, Benutzer-API, Gruppen-API, Projekt-API und Mitglieder-API.
Verwenden Sie für große Umgebungen die folgenden Anleitungen:
- Bis zu 100.000 Elemente: 9.000 Anforderungen/Stunde
- 100.000–1.000.000 Elemente: 15.000 Anforderungen/Stunde
- Mehr als 1.000.000 Artikel: 15.000 Anforderungen/Stunde; Die Erfassung kann je nach Systemlast 1 bis 2 Wochen dauern.

Berechtigungskonflikte

Wenn Benutzern Suchergebnisse angezeigt werden, auf die sie keinen Zugriff haben sollten, oder wenn keine Ergebnisse angezeigt werden, auf die sie Zugriff haben sollten:

Vergewissern Sie sich, dass die Identitätszuordnung ordnungsgemäß konfiguriert ist. Zu den unterstützten Zuordnungsattributen gehören E-Mail, Anmeldung und Name.
Wenn Benutzerattribute nicht zwischen GitLab und Microsoft Entra ID übereinstimmen, konfigurieren Sie reguläre Ausdrücke (regex), um Werte zu transformieren.
Überprüfen Sie, ob E-Mail-Sichtbarkeitseinstellungen oder gemischte Domänen in GitLab eine genaue Zuordnung verhindern.
Stellen Sie sicher, dass das ausgewählte Zugriffsmodell (Nur Personen mit Zugriff auf diese Datenquelle oder Jeder) den Anforderungen Ihrer organization entspricht.

Probleme mit Mergeanforderungen oder rollenbasiertem Zugriff

Wenn Benutzer Berechtigungsprobleme mit Mergeanforderungen oder bestimmten GitLab-Rollen haben:

Der Zugriff auf Mergeanforderungen für öffentliche Projekte, die auf Projektmitglieder beschränkt sind, wird mit der Rolle "Reporter" oder höher erzwungen.
Die Planner-Rolle ist aus Stabilitätsgründen veraltet. Weisen Sie Benutzern, die Zugriff benötigen, die Rolle Reporter oder eine höhere Rolle zu.

Probleme mit dem Microsoft Graph-Connector-Agent

Wenn der Agent keine Verbindung herstellen kann oder Fehler meldet:

Vergewissern Sie sich, dass der Agent-Hostcomputer die GitLab Server-instance über die erforderlichen Ports erreichen kann.
Vergewissern Sie sich, dass der Agent über genügend Arbeitsspeicher und CPU-Kapazität verfügt.
Starten Sie den Agent-Dienst neu, und versuchen Sie die Erfassung erneut.

Last updated on 2026-01-28

Freigeben über