Fehlerbehebung bei Fabric-Aktivierungsfehlern

Wenn nach der Erstellung ein Problem mit einem ihrer Fabric-Activatorereignisse, -Objekte oder -Regeln auftritt, sendet Ihnen fabric Activator eine E-Mail mit einem Fehlercode. In diesem Artikel wird die Bedeutung der Fehlercodes erläutert, die Sie empfangen können, und die Schritte beschrieben, die Sie ausführen können, um die zugehörigen Probleme zu beheben.

Datenerfassungs-Fehlercodes

Die folgenden Fehlercodes stellen Probleme dar, die auftreten können, wenn Fabric-Aktivator Daten aus Power BI-Semantikmodellen und Ereignisstreamelementen erfasst.

PowerBiQuelleNichtGefundenOderNichtAusreichendeBerechtigung

Der Fabric-Aktivator kann nicht auf das Power BI-Semantikmodell für Ihr Objekt zugreifen. Dieser Fehler tritt auf, wenn das Dataset gelöscht wird oder wenn sich die Berechtigungen für das Dataset seit dem Erstellen der Warnung ändern. Um das Problem zu beheben, überprüfen Sie, ob das Dataset noch vorhanden ist, und:

  • Wenn das Dataset vorhanden ist, stellen Sie sicher, dass Sie über die Berechtigung zum Zugreifen darauf verfügen.

  • Wenn das Dataset gelöscht wird, funktionieren Ihre Objekte und Regeln nicht. Löschen Sie sie dann nach Bedarf in einem anderen semantischen Modell neu.

Abfragebewertungsfehler

Fabric-Aktivator kann das Power BI-Semantikmodell nicht für Ihr Objekt abfragen. Dieser Fehler tritt auf, wenn sich die Struktur des Datasets ändert, nachdem Sie die Warnung erstellt haben. Das Problem lässt sich wie folgt beheben:

  • Wiederherstellen der ursprünglichen Struktur des semantischen Modells oder
  • Löschen Sie das Fabric-Aktivatorobjekt, und erstellen Sie die Regel anhand des semantischen Modells neu.

EventHubNichtGefunden

Der Fabric-Aktivator kann den Fabric-Ereignisstream für Ihr Objekt nicht finden. Dieser Fehler tritt auf, wenn der Ereignisstream für Ihr Objekt gelöscht wird oder die Verbindung von Ihrem Eventstream zu Ihrem Fabric-Aktivatorelement entfernt wird. Um das Problem zu beheben, verbinden Sie einen Fabric-Ereignisstream erneut mit Ihrem Fabric-Aktivatorobjekt.

EventHubException

Fabric Activator empfängt eine Ausnahme von Eventstreams beim Importieren Ihrer Daten aus Ihrem Eventstream-Element. Um das Problem zu beheben, öffnen Sie das Eventstream-Element, und überprüfen Sie die Verbindung mit Ihrem Fabric-Aktivator-Objekt, und überprüfen Sie auf Fehler in der Verbindung oder im Ereignisstream.

Unberechtigter Zugriff

Der Fabric-Aktivator ist nicht berechtigt, auf das Eventstream-Element für Ihr Fabric-Aktivatorobjekt zuzugreifen. Dieses Problem tritt auf, wenn sich Berechtigungen für das Eventstream-Element ändern, da Sie Ihr Eventstream-Element mit Fabric Activator verbunden haben. Um das Problem zu beheben, stellen Sie sicher, dass Sie über die Berechtigung zum Zugriff auf das Eventstream-Element verfügen.

FalschesDatenformat

Das ereignisstream-Element, das mit Ihrem Fabric Activator-Objekt verbunden ist, enthält Daten in einem Format, das von Fabric Activator nicht erkannt wird. Um das Problem zu beheben, überprüfen Sie die Daten in Ihrem Eventstream-Element, um sicherzustellen, dass es sich im JSON-Wörterbuchformat befindet, wie im Artikel " Abrufen von Daten aus Eventstreams " beschrieben.

Regel-Auswertungsfehlercodes

Die folgenden Fehlercodes stellen Probleme dar, die auftreten können, wenn fabric Activator Ihre Regelbedingung auswertet, um festzustellen, ob die Bedingung erfüllt ist.

Verarbeitungslimits erreicht

Ihre Regel überschreitet Datenverarbeitungsgrenzwerte aus einem von zwei Gründen:

  • Sie senden zu viele Ereignisse pro Sekunde an Ihr Fabric Activator-Objekt oder
  • Ihre Regel wird zu häufig aktiviert.

Es gibt zwei Möglichkeiten, dieses Problem zu beheben: Versuchen Sie, die Anzahl der Ereignisse pro Sekunde zu verringern, die Sie an Ihr Objekt senden. Oder aktualisieren Sie Ihre Regel so, dass sie weniger häufig aktiviert wird.

ArbeitsbereichskapazitätFreigegeben

Die Fabric-Kapazität für den Arbeitsbereich Ihrer Regel wird abgeglichen, sodass Sie keine Fabric-Kapazität mehr für die Verarbeitung Ihrer Regel zur Verfügung haben. Um dieses Problem zu beheben, wenden Sie sich an den Fabric-Kapazitätsadministrator, um sicherzustellen, dass dem Arbeitsbereich der Regel eine Fabric-Kapazität zugewiesen ist.

Definitionsvalidierung fehlgeschlagen

Dieser Fehlercode bedeutet, dass die Regeldefinition ungültig ist. Es weist auf ein internes Problem mit dem Fabric Activator hin. Wenn Sie diesen Fehlercode erhalten, bitten Sie um Unterstützung auf der Fabric-Aktivator-Communitywebsite.

Maximalverzögerung erreicht

Der Fehlercode bedeutet, dass der Fabric-Aktivator keine eingehenden Daten für Die Regel für die letzten sieben Tage empfangen kann und die Regel nicht auswertet. Es weist auf ein internes Problem mit dem Fabric Activator hin. Wenn Sie diesen Fehlercode erhalten, bitten Sie um Unterstützung auf der Fabric-Aktivator-Communitywebsite.

PreviewActivatorMigrationRequired

Dieser Fehlercode bedeutet, dass dieses Fabric-Aktivatorelement während des Vorschauzeitraums erstellt wurde und jetzt manuell migriert werden muss. Wenn Sie diesen Fehlercode erhalten, verweisen Sie auf den Blogbeitrag auf migrationszeitachsen und die nächsten Schritte.

Fehlercodes für überschrittene Kapazität

Die folgenden Fehlercodes stellen Fabric-Aktivatorprobleme dar, die auftreten können, wenn Ihr Konto keine Fabric-Kapazität aufweist.

Kapazitätsgrenze überschritten

Ihr Konto hat das Limit Ihrer Fabric-Kapazität für mehr als 24 Stunden überschritten. Wenn Sie Ihre Kapazität überschreiten, werden Drosselungsrichtlinien angewendet, und der Fabric-Aktivator hält die Auswertung von Regeln, von Hintergrundvorgängen und von Aktivierungen an. Um dieses Problem zu beheben, wenden Sie sich an Ihren Kapazitätsadministrator, und bitten Sie ihn, die Kapazitätsauslastung und das Upgrade nach Bedarf zu überprüfen. Nachdem Ihr Kapazitätsproblem behoben wurde, stellen Sie sicher, dass Sie Ihre Regeln reaktivieren.

Weitere Informationen finden Sie unter Grundlegendes zur Fabric-Kapazitätsdrosselung.

Warnungs- und Aktionsfehlercodes

Die folgenden Fehlercodes stellen Probleme dar, die auftreten können, wenn Fabric Activator versucht, eine Warnung zu senden oder einen Power Automate-Fluss zu starten, nachdem eine Regelbedingung erfüllt wurde.

BenutzerNichtGefunden

Dieser Fehlercode bedeutet, dass der Fabric-Aktivator den Empfänger der E-Mail- oder Teams-Warnung Ihrer Regel nicht finden konnte. Um dieses Problem zu beheben, überprüfen Sie das Empfängerfeld für die Aktion Ihrer Regel, und stellen Sie sicher, dass es auf ein gültiges Mitglied Ihrer Organisation festgelegt ist.

LeereEmailEigenschaftFürBenutzer

Dieser Fehlercode bedeutet, dass der Fabric-Aktivator die Testaktion nicht ausführen konnte, da Ihre E-Mail-Adresse nicht in Ihrem Azure-Profil definiert ist. Um dieses Problem zu beheben, fügen Sie Ihre E-Mail-Adresse zu Ihrem Azure-Profil hinzu.

Empfängerdrosselung

Dieser Fehlercode bedeutet, dass der Fabric-Aktivator den Empfänger Ihrer Regel nicht benachrichtigen konnte, da der Empfänger zu viele Nachrichten von Fabric Activator empfängt. Der Artikel Fabric Activator-Einschränkungen enthält die maximale Anzahl von Nachrichten, die Sie aus einer Regel senden können. Um dieses Problem zu beheben, ändern Sie die Definition der Regel so, dass sie weniger häufig aktiviert wird.

Drosselung von FabricItem

Dieser Fehlercode bedeutet, dass fabric-Aktivator den in Ihrer Regel definierten Fabric-Auftrag nicht ausführen konnte, da zu viele Aktivierungen von Fabric-Aktivator in einem bestimmten Zeitraum vorhanden waren. Im Artikel "Fabric Activator"-Einschränkungen werden die maximale Anzahl von Ausführungen pro Benutzer aufgelistet. Um dieses Problem zu beheben, ändern Sie die Definition der Regel so, dass sie weniger häufig aktiviert wird. Wenn Sie über einen Anwendungsfall verfügen, der eine höhere Häufigkeit als das Limit erfordert, teilen Sie den Anwendungsfall und die in der Aktivierer-Community erforderliche Häufigkeit mit.

Vom Benutzer blockierter Bot

Dieser Fehlercode bedeutet, dass Sie über eine Regel verfügen, die eine Teams-Warnung sendet, und der Empfänger der Warnung blockiert, dass der Fabric-Aktivator-Bot diese Nachrichten sendet. Um dieses Problem zu beheben, bitten Sie den Empfänger, die Blockierung des Bots aufzuheben.

TeamsAppBlockedInTenant

Dieser Fehlercode bedeutet, dass Sie über eine Regel verfügen, die eine Teams-Warnung sendet, und Ihr Teams-Administrator blockiert die Fabric-Aktivator-App. Um dieses Problem zu beheben, bitten Sie Ihren Teams-Administrator, die Blockierung der Fabric-Aktivator-Teams-App aufzuheben.

BotNotInstalledInTeamsChatOrChannel

Dieser Fehlercode bedeutet, dass Sie über eine Regel verfügen, die Benachrichtigungen über einen Teams-Chat oder -Kanal sendet. Um dieses Problem zu beheben, stellen Sie sicher, dass der Fabric-Aktivator-Bot im Zielchat oder Kanal installiert ist.

ReflexAppDisabledInTenant

Dieser Fehlercode bedeutet, dass die Anwendung "Reflex - Öffentlich" von Ihrer Organisation deaktiviert wurde. Um dieses Problem zu beheben, bitten Sie Ihren Entra-Administrator, die Blockierung der App aufzuheben.

NachrichtenEmpfängerUnklar

Dieser Fehlercode bedeutet, dass die Benachrichtigung nicht übermittelt werden konnte, da mehrere Benutzer dieselbe E-Mail-Adresse oder den UPN (Benutzerprinzipalname) gemeinsam nutzen. Um dieses Problem zu beheben, wenden Sie sich an Ihren Entra-Administrator, um die Mehrdeutigkeit zu beheben.

Office-Abonnement fehlt

Dieser Fehlercode bedeutet, dass fabric-Aktivator die Benachrichtigung für Ihre Regel nicht senden konnte, da Sie kein Microsoft Office-Abonnement haben. Um das Problem zu beheben, rufen Sie ein Microsoft Office-Abonnement ab.

Teams deaktiviert

Dieser Fehlercode bedeutet, dass Sie über eine Regel verfügen, die eine Teams-Warnung sendet und dass der Administrator Ihres Microsoft Entra ID-Mandanten den Microsoft Teams-Dienstprinzipal (Service Principal, SP) blockiert hat. Um das Problem zu beheben, wenden Sie sich an Ihren Microsoft Entra Administrator, und bitten Sie ihn darum, die Blockierung des Teams-SP aufzuheben.

Teams-ChatOderKanalNichtGefunden

Dieser Fehlercode bedeutet, dass fabric-Aktivator den von Ihnen definierten Teams-Kanal oder -Chat nicht finden konnte. Um dieses Problem zu beheben, überprüfen Sie die Aktion Ihrer Regel, und stellen Sie sicher, dass sie auf einen gültigen Teams-Chat/Kanal festgelegt ist.

FabricElementNichtGefunden

Dieser Fehlercode bedeutet, dass fabric-Aktivator das fabric-Element, das Sie definiert haben, nicht finden konnte. Um dieses Problem zu beheben, überprüfen Sie die Aktion Ihrer Regel, und stellen Sie sicher, dass es auf ein vorhandenes Fabric-Element festgelegt ist.

Ausführung von Fabric-Element nicht autorisiert

Dieser Fehlercode bedeutet, dass beim Ausführen des Fabric-Elements ein nicht autorisierter Fehler aufgetreten ist. Um dieses Problem zu beheben, wählen Sie das Fabric-Element erneut aus, und speichern Sie die Regel erneut.

FabricItemExecutionNoPermissions

Dieser Fehlercode bedeutet, dass beim Ausführen des Fabric-Elements ein Berechtigungsfehler aufgetreten ist. Um dieses Problem zu beheben, überprüfen Sie Ihre Zugriffsrechte für das Fabric-Element, oder wenden Sie sich an den Ersteller des Fabric-Elements, um die erforderlichen Berechtigungen anzufordern.

BlockedByOutboundAccessProtection

Wenn der Ausgehende Zugriffsschutz für einen Arbeitsbereich aktiviert ist, werden je nach Konfiguration möglicherweise einige Aktionen blockiert. Wenden Sie sich an Ihren Microsoft Fabric-Administrator, um dieses Problem zu beheben.

Häufige Probleme, Symptome und Korrekturen

Während der Aktivator einen Großteil der Komplexität hinter der Echtzeitereignisverarbeitung abstrahiert, können Implementierungen im großen Maßstab auf Daten-, Konfigurations- oder Orchestrierungsprobleme treffen, die eine systematische Problembehandlung erfordern. Dieser Abschnitt enthält einen umfassenden Einblick in die Identifizierung, Analyse und Behebung allgemeiner betriebstechnischer Probleme in Aktivierer.

Symptom Mögliche Ursache Wartung
Regeln, die nicht ausgelöst werden Eventstream überträgt keine Daten, falsche Objektschlüssel, Regelbedingungen werden nie erfüllt. Überprüfen der Streamkonnektivität, Verwenden der Regelvorschau, Überprüfen der Objektschemazuordnung
Warnungsspam oder wiederholte Trigger Verwendung zustandsloser Operatoren (z. B. kleiner als) anstelle von zustandsfreien Operatoren (z. B. Abnahmen) Neugestaltung von Regeln für die Verwendung von Übergangsoperatoren wie DECREASES, BECOMESoder Aktivieren der Entprenklogik
Keine Aktionen ausgelöst Fehlerhaft konfigurierte Pipeline, Notebook, Aktionsziel oder Regel nicht erfüllt Aktionsbindungen überprüfen, sicherstellen, dass Trigger-Payloads den Rahmenbedingungen der Pipeline entsprechen.
Unerwartete Latenz (über 30s) Kaltstart bei Aktivator, hoher Objektkardinalität oder Eventstream-Engpässen Aktivator aufwärmen mit Testereignissen, Objektkardinalität überprüfen, Eventstream-Diagnose überprüfen
Fehler "Keine Daten" nach 10 Minuten Ereignisstromquelle ist im Leerlauf oder getrennt. Überwachen der Ereignisstream-Quellintegrität; Implementieren von Takterkennungsregeln, um diese Ausfälle proaktiv abzufangen
Regeln, die im Testmodus zu häufig ausgelöst werden Verwenden von synthetischen oder wiedergegebenen Testdaten mit schnell ändernden Zuständen Verwenden Sie kontrollierte, deduplizierte Testdaten; Anwenden von Filtern, um sich auf realistische Objekte/Ereignisse zu konzentrieren

Diagnostizieren von Problemen mit integrierten Tools

  • Verwenden Sie vor der Aktivierung die Vorschauregeln, um zu sehen, wie oft eine Regel für historische Ereignisse ausgelöst wurde. Dieser Ansatz ist von entscheidender Bedeutung für:

    • Identifizieren falsch konfigurierter Filter
    • Erkennen von Hochfrequenztriggern
    • Sicherstellen der richtigen Objektgruppierung
  • Überwachen Sie den Ereignisstream mithilfe des Überwachungspanels von Eventstream auf:

    • Ereignisfluss aus vorgelagerten Quellen bestätigen
    • Zeitstempel und Nutzlaststrukturen überprüfen
    • Erkennung von Ausfällen oder Formatkonflikten
  • Überprüfen Sie ausgelöste Aktionsprotokolle: Von Aktivierern ausgelöste Aktionen (Pipelines, Flüsse) Protokollausführungsmetadaten:

    • Zeitstempel, Nutzlast, Regel, die ausgelöst wurde
    • Ausführung erfolgreich/fehlgeschlagen (über den Pipelineausführungsverlauf oder Power Automate-Protokolle)
  • Schemakonflikt erkennen: Der Aktivator könnte leise scheitern, Regeln an Daten zu binden, wenn:

    • Der Feldname ist falsch geschrieben.
    • Die Werttypen (z. B. Zeichenfolge vs. numerisch) sind nicht aufeinander abgestimmt. Nutzen Sie die Livebeispielansicht von Eventstream, um die Schema-Genauigkeit vor der Regelerstellung zu bestätigen.

Mit dem Microsoft Support zusammenarbeiten

Wenn Probleme weiterhin bestehen und eine Eskalation erfordern, öffnen Sie ein Supportticket, und fügen Sie die folgenden Informationen ein:

  • Arbeitsbereichs- und Aktivatorname
  • Eventstream-Quelldetails
  • Regel-IDs und deren Bedingungen
  • Ungefähre Zeitstempel und betroffene Objektschlüssel
  • Ausgelöste Aktionskonfiguration und erwartetes Ergebnis

Fügen Sie nach Möglichkeit die folgenden Informationen ein:

  • Exportieren von Beispielereignisnutzlasten (sanitisiert)
  • Erfassen von Screenshots der Regelvorschau und überwachungspanels
  • Beachten Sie, ob das Problem in anderen Aktivatoren oder Umgebungen reproduzierbar ist.

Bewährte Methoden zum Verhindern von Problemen

  • Verwenden Sie immer die Regelvorschau, bevor Sie live gehen, insbesondere für Datenströme mit hohem Datenvolumen
  • Bevorzugen Sie zustandsbehaftete Operatoren, um wiederholtes Auslösen zu vermeiden
  • Implementieren von Heartbeat-Regeln zur Erkennung stummer Stream-Fehler
  • Regelmäßiges Prüfen der Kardinalität von Objektschlüsseln und Optimieren von Schemata
  • Entwerfen Sie Regeln unter Berücksichtigung von Überwachung und Ausfallsicherung (z. B. Warnung, wenn die Regel in X Zeit nicht ausgelöst wurde)

Weitere Informationen zu Microsoft Fabric finden Sie zudem unter: