Freigeben über

Behandeln von Problemen mit dem Microsoft Graph Connectors SDK

  • Artikel

In diesem Artikel werden einige der häufigsten Probleme mit dem Microsoft Graph Connectors SDK und deren Problembehandlung beschrieben.

Elemente, die im Index fehlen

Wenn zuvor vorhandene Elemente im Index fehlen, kann dies auf die Löscherkennungslogik auf der Plattform zurückzuführen sein. Elemente, die in einer Erfolgsantwort in OperationStatus fehlen und sich bereits im Index befinden, werden aus dem Index entfernt.

Wenn der Connector vorübergehende Fehlerantworten sendet und mehr als 10 % der Elemente zu Durchforstungsfehlern geführt haben, werden Elemente, die nicht in den letzten beiden Durchforstungen enthalten sind, gelöscht.

Behandeln von Änderungen am Connectorport

Wenn der Connector an einem anderen Port ausgeführt werden muss, müssen Sie die Konfigurationsdatei der Portzuordnung mit den neuen Werten aktualisieren. Wenn Sie die Konfigurationsdatei für die Portzuordnung bearbeiten, müssen Sie den GCA-Dienst neu starten, damit die Änderungen wirksam werden. Um den Dienst neu zu starten, öffnen Sie services.msc, und starten Sie GcaHostService neu.

Screenshot des Fensters

Verbindungsfehler nach dem GCA-Upgrade

Wenn Nach dem Upgrade von einer GCA-Version 1.8.0.0 oder niedriger Verbindungsfehler auftreten, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie die GCA-Systemsteuerung. Wählen Sie unter Programme und Features die Option Graph-Connector-Agent aus der Programmliste aus, und wählen Sie Reparieren aus.
  2. Aktualisieren Sie die neue Konfiguration der Portzuordnungsdatei mit den vorherigen Konfigurationen.
  3. Setzen Sie alle fehlerhaften Verbindungen von Microsoft 365 Admin Center fort.

Der Connectordienst ist nicht verfügbar.

Wenn bei den Durchforstungen ein Fehler auftritt, bei dem ein Connector nicht verfügbar ist, überprüfen Sie Folgendes:

  1. Der Connector wird tatsächlich auf dem angegebenen Port ausgeführt und ist nicht abgestürzt und bleibt nicht hängen.
  2. Der in der Portzuordnungskonfigurationsdatei angegebene Port ist richtig.
  3. Wenn die Konfigurationsdatei für die Portzuordnung bearbeitet wurde, müssen Sie GcaHostService neu starten.

Behandeln von RPC-Fehlern

Wenn während der Kommunikation zwischen der Microsoft Graph-Connector-Agent-Plattform und dem Connector RPC-Fehler angezeigt werden, können Sie die Fehlercodes auf der Seite status Codes nachschlagen.

Wenn der Fehlercode Unbekannt ist, liegt in Ihrem Connectorcode wahrscheinlich eine Ausnahme ohne Behandlung vor. Stellen Sie sicher, dass Sie in allen Fällen eine Antwort mit erfolg-/misserfolgsvorgang status senden.

Suchen der Protokolldatei für Ihren benutzerdefinierten Connector

Wenn Sie graphConnectorsTemplate zum Entwickeln Ihres benutzerdefinierten Connectors verwenden, wird standardmäßig der Ordner AppData des aktuellen Benutzerkontos zum Speichern von Protokollen verwendet. Sie können auch einen absoluten Pfad zum Speichern von Protokollen in der ConnectorServer.cs-Datei der Vorlage angeben. Das Benutzerkonto sollte Zugriff auf den angegebenen absoluten Pfad haben.

Je nach Anwendungsfall sind die Speicherorte des Protokollpfads aufgeführt:

  • Connector, der nicht als Windows-Dienst gehostet wird:

    C:\Users\{User Account}\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log

  • Connector, der als Windows-Dienst unter dem Konto LOCAL SYSTEM gehostet wird:

    C:\Windows\system32\config\systemprofile\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log

  • Connector, der als Windows-Dienst unter dem virtuellen Konto gehostet wird:

    C:\Windows\ServiceProfiles\{Network Service Name}\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log

  • Connector, der als Windows-Dienst unter dem Konto LOCAL SYSTEM gehostet wird:

    C:\Windows\ServiceProfiles\LocalService\AppData\Local\Microsoft\{Connector Name}\Logs\ConnectorLog.log

Hinweis

  • GraphConnectorsTemplate v2.1 und höher unterstützt das Speichern von Protokollen für Connectors, die als Windows-Dienst gehostet werden.
  • Stellen Sie sicher, dass Sie einen eindeutigen Connectornamen in der ConnectorServer.cs-Datei angeben, um sicherzustellen, dass Protokolle für jeden eindeutigen Connector separat gespeichert werden.

Fehler beim Hosten eines Connectors als Windows-Dienst

Fehler beim Starten des Diensts aufgrund des Fehlers "Zugriff verweigert"

Führen Sie die folgenden Schritte aus, um sicherzustellen, dass der Pfad der ausführbaren Datei für das LocalService-Konto zugänglich ist.

  1. Klicken Sie mit der rechten Maustaste auf den Ordner, der die ausführbare Datei enthält, und wählen Sie Eigenschaften aus.

  2. Öffnen Sie die Registerkarte Sicherheit , und wählen Sie unter Gruppen- oder Benutzernamen die Option Bearbeiten aus.

  3. Wählen Sie Hinzufügen aus.

  4. Geben Sie "LOCAL SERVICE" als Objektnamen ein, und wählen Sie Namen überprüfen aus.

    Screenshot des Felds

  5. Wählen Sie in jedem Dialogfeld OK aus.

Fehler beim Starten des Diensts

Wenn der Dienst nicht gestartet werden kann, überprüfen Sie die Fehlerprotokolle der Ereignisanzeige. Öffnen Sie die Ereignisanzeige, und wechseln Sie zu Windows-Protokolle > Anwendung und Windows-Protokolle > System.

Screenshot der Fehlerprotokolle in der Ereignisanzeige

Weitere Hilfe

Wenn Sie weitere Hilfe bei der Problembehandlung benötigen, können Sie über unser GitHub-Repository ein Problem auslösen oder eine Diskussion zu relevanten Themen starten.

Sie können sich auch an das Microsoft Graph Connectors-Team wenden, um weitere Hilfe und Problembehandlung zu erhalten.

Verwandte Inhalte