Foretag fejlfinding af fabric-aktivatorfejl

Hvis der opstår et problem med nogle af dine Fabric Activator-hændelser, -objekter eller -regler, når du har oprettet dem, sender Fabric Activator dig en mail, der indeholder en fejlkode. I denne artikel forklares betydningen af de fejlkoder, du kan modtage, og de trin, du skal udføre for at løse de tilknyttede problemer.

Fejlkoder for dataindtagelse

Følgende fejlkoder repræsenterer problemer, der kan opstå, når Fabric Activator henter data fra semantiske Power BI-modeller og hændelsesstreamelementer.

PowerBiSourceNotFoundOrInsufficientPermission

Fabric Activator kan ikke få adgang til den semantiske Power BI-model for dit objekt. Denne fejl opstår, hvis datasættet slettes, eller hvis tilladelserne til datasættet ændres, siden du oprettede beskeden. Du kan løse problemet ved at kontrollere, om datasættet stadig findes, og:

  • Hvis datasættet findes, skal du sikre dig, at du har tilladelse til at få adgang til det.

  • Hvis datasættet slettes, fungerer dine objekter og regler ikke. Slet dem derefter efter behov i en anden semantisk model.

QueryEvaluationError

Fabric Activator kan ikke forespørge den semantiske Power BI-model for dit objekt. Denne fejl opstår, hvis datasættets struktur ændres, når du har oprettet beskeden. Du kan løse problemet ved at gøre følgende:

  • Gendan den oprindelige struktur af din semantiske model, eller
  • Slet dit Fabric Activator-objekt, og opret reglen igen i forhold til den semantiske model.

EventHubNotFound

Fabric Activator kan ikke finde Fabric-hændelsesstrømmen for dit objekt. Denne fejl opstår, hvis eventstreamen for dit objekt slettes, eller hvis forbindelsen fra eventstreamen til elementet Fabric Activator fjernes. Du kan løse problemet ved at genoprette forbindelsen mellem en Fabric-hændelsesstream og dit Fabric Activator-objekt.

EventHubException

Fabric Activator modtager en undtagelse fra eventstreams, når du importerer dine data fra dit eventstream-element. Du kan løse problemet ved at åbne dit eventstream-element og undersøge forbindelsen til dit Fabric Activator-objekt og kontrollere, om der er fejl i forbindelsen eller hændelsesstrømmen.

UnauthorizedAccess

Fabric Activator er ikke godkendt til at få adgang til eventstream-elementet for dit Fabric Activator-objekt. Dette problem opstår, når tilladelserne til eventstreamelementet ændres, siden du oprettede forbindelse mellem eventstreamelementet og Fabric Activator. Du kan løse problemet ved at sørge for, at du har tilladelse til at få adgang til eventstream-elementet.

IncorrectDataFormat

Eventstream-elementet, der er forbundet til dit Fabric Activator-objekt, indeholder data i et format, der ikke genkendes af Fabric Activator. Du kan løse problemet ved at gennemse dataene i dit eventstream-element for at sikre, at de er i JSON-ordbogsformat, som beskrevet i artiklen Hent data fra eventstreams .

Fejlkoder til evaluering af regel

Følgende fejlkoder repræsenterer problemer, der kan opstå, når Fabric Activator evaluerer regelbetingelsen for at se, om betingelsen er opfyldt.

ProcessingLimitsReached

Din regel overskrider grænserne for databehandling af en af to årsager:

  • Du sender for mange hændelser pr. sekund til dit Fabric Activator-objekt, eller
  • Reglen aktiveres for ofte.

Problemet kan løses på to måder. Prøv at reducere antallet af hændelser pr. sekund, du sender til objektet. Du kan også opdatere din regel for at aktivere den sjældnere.

WorkspaceCapacityDeallocated

Fabric-kapaciteten for din regels arbejdsområde er deallokeret, så du ikke længere har Fabric-kapacitet til rådighed til at behandle din regel. Du kan løse dette problem ved at kontakte din Fabric-kapacitetsadministrator for at sikre, at du har tildelt en Fabric-kapacitet til reglens arbejdsområde.

DefinitionFailedValidation

Denne fejlkode betyder, at regeldefinitionen er ugyldig. Det angiver et internt problem med Fabric Activator. Hvis du modtager denne fejlkode, skal du bede om hjælp på webstedet Fabric Activator-community'et.

MaxDelayReached

Fejlkoden betyder, at Fabric Activator ikke kan modtage indgående data for din regel i de seneste syv dage og ikke evaluerer reglen. Det angiver et internt problem med Fabric Activator. Hvis du modtager denne fejlkode, skal du bede om hjælp på webstedet Fabric Activator-community'et.

PreviewActivatorMigrationRequired

Denne fejlkode betyder, at dette Fabric Activator-element blev oprettet i prøveperioden og nu skal overføres manuelt. Hvis du modtager denne fejlkode, skal du referere til blogindlægget om tidslinjer for overførsel og næste trin.

Overskred kapacitetsfejlkoder

Følgende fejlkoder repræsenterer Fabric Activator-problemer, der kan opstå, når din konto løber tør for Fabric-kapacitet.

CapacityLimitExceeded

Din konto overskred grænsen for din Fabric-kapacitet i mere end 24 timer. Når du overskrider din kapacitet, anvendes begrænsningspolitikker, og Fabric Activator afbryder evalueringen af regler, handlinger i baggrunden og aktiveringer midlertidigt. Du kan løse problemet ved at kontakte kapacitetsadministratoren og bede vedkommende om at gennemse kapacitetsforbruget og opgradere efter behov. Når dit kapacitetsproblem er løst, skal du sørge for at genaktivere dine regler.

Få mere at vide med Forstå din Begrænsning af Fabric-kapacitet.

Koder for besked- og handlingsfejl

Følgende fejlkoder repræsenterer problemer, der kan opstå, når Fabric Activator forsøger at sende en besked eller starte et Power Automate-flow, når en regelbetingelse er opfyldt.

UserNotFound

Denne fejlkode betyder, at Fabric Activator ikke kunne finde modtageren af din regels mail eller Teams-besked. Du kan løse dette problem ved at gennemse modtagerfeltet for reglens handling og sørge for, at det er angivet til et gyldigt medlem af din organisation.

EmptyEmailPropertyForUser

Denne fejlkode betyder, at Fabric Activator ikke kunne udføre testhandlingen, fordi din mailadresse ikke er defineret i din Azure-profil. Du kan løse dette problem ved at føje din mailadresse til din Azure-profil.

RecipientThrottled

Denne fejlkode betyder, at Fabric Activator ikke kunne advare modtageren af reglen, fordi modtageren modtager for mange meddelelser fra Fabric Activator. Artiklen Fabric Activator-begrænsninger viser det maksimale antal meddelelser, du kan sende fra en regel. Du kan løse problemet ved at ændre definitionen af reglen, så den aktiveres sjældnere.

FabricItemThrottled

Denne fejlkode betyder, at Fabric Activator ikke kunne udføre det Fabric-job, der er defineret i din regel, fordi der var for mange aktiveringer fra Fabric Activator på et givet tidspunkt. Artiklen Begrænsninger for Fabric Activator viser det maksimale antal udførelser pr. bruger. Du kan løse problemet ved at ændre definitionen af reglen, så den aktiveres sjældnere. Hvis du har en brugssituation, der kræver højere frekvens end grænsen, skal du dele brugsscenariet og den frekvens, der kræves i Activator Community.

BotBlockedByUser

Denne fejlkode betyder, at du har en regel, der sender en Teams-besked, og modtageren af beskeden blokerer Fabric Activator-robotten fra at sende dem meddelelser. Du kan løse problemet ved at bede modtageren om at fjerne blokeringen af robotten.

TeamsAppBlockedInTenant

Denne fejlkode betyder, at du har en regel, der sender en Teams-besked, og din Teams-administrator blokerer appen Fabric Activator. Du kan løse problemet ved at bede Teams-administratoren om at fjerne blokeringen af Fabric Activator Teams-appen.

BotNotInstalledInTeamsChatOrChannel

Denne fejlkode betyder, at du har en regel, der sender meddelelser til en Teams-chat eller -kanal. Du kan løse dette problem ved at sørge for, at Fabric Activator-robotten er installeret i destinationschatten eller -kanalen.

ReflexAppDisabledInTenant

Denne fejlkode betyder, at "Reflex - Public"-applikationen blev deaktiveret af din organisation. Du kan løse dette problem ved at bede din Entra-administrator om at fjerne blokeringen af appen.

MessageRecipientTvetydig

Denne fejlkode betyder, at meddelelsen ikke kunne leveres, fordi flere brugere deler den samme mailadresse eller UPN (brugerens hovednavn). For at løse dette problem skal du kontakte din Entra-administrator for at løse tvetydigheden.

OfficeSubscriptionMissing

Denne fejlkode betyder, at Fabric Activator ikke kunne sende beskeden efter din regel, fordi du ikke har et Microsoft Office-abonnement. Du kan løse problemet ved at få et Microsoft Office-abonnement.

TeamsDisabled

Denne fejlkode betyder, at du har en regel, der sender en Teams-besked, og at administratoren af din Microsoft Entra-lejer blokerer Microsoft Teams-tjenesteprincipalen (SP). Du kan løse problemet ved at kontakte din Microsoft Entra-administrator og anmode om, at de fjerner blokeringen af Teams SP.

TeamsChatOrChannelNotFound

Denne fejlkode betyder, at Fabric Activator ikke kunne finde den Teams-kanal eller chat, du har defineret. Du kan løse dette problem ved at gennemse reglens handling og sørge for, at den er indstillet til en gyldig Teams-chat/-kanal.

StofItemIkke fundet

Denne fejlkode betyder, at Fabric Activator ikke kunne finde det Fabric-element, du har defineret. Du kan løse dette problem ved at gennemgå reglens handling og sørge for, at den er indstillet til et eksisterende stofelement.

FabricItemExecutionUautoriseret

Denne fejlkode betyder, at der opstod en uautoriseret fejl under udførelse af Fabric-elementet. Du kan løse dette problem ved at vælge elementet Fabric igen og gemme reglen igen.

FabricItemExecutionNoPermissions

Denne fejlkode betyder, at der opstod en tilladelsesfejl under udførelse af Fabric Item. Du kan løse dette problem ved at kontrollere dine adgangsrettigheder til stofelementet eller kontakte opretteren af stofelementet for at anmode om de nødvendige tilladelser.

BlockedByOutboundAccessProtection

Når Outbound Access Protection er aktiveret på et arbejdsområde, kan nogle handlinger blive blokeret afhængigt af konfigurationen. For at løse dette problem skal du kontakte din Microsoft Fabric-administrator.

Almindelige problemer, symptomer og afhjælpninger

Selvom Activator fjerner meget af kompleksiteten bag hændelsesbehandling i realtid, kan implementeringer i stor skala støde på problemer med data, konfiguration eller orkestrering, der kræver systematisk fejlfinding. Dette afsnit indeholder en detaljeret gennemgang af, hvordan du identificerer, analyserer og løser almindelige driftsproblemer i Activator.

Symptom Mulig årsag Remediation
Regler, der ikke affyrer Eventstream pusher ikke data, forkerte objektnøgler, regelbetingelserne er aldrig opfyldt Valider streamforbindelse, brug regeleksempel, kontrollér tilknytning af objektskema
Besked om spam eller gentagne udløsere Brug af statsløse operatorer (f.eks. mindre end) i stedet for tilstandsafhængige operatorer (f.eks. fald) Omdesign regler for at bruge overgangsoperatorer som DECREASES, BECOMESeller aktivér debouncelogik
Ingen handlinger udløst Forkert konfigureret pipeline/notesbog/handlingsmål eller regel, der ikke er opfyldt Kontrollér handlingsbindinger, sørg for, at udløsernyttedata stemmer overens med pipelineforventninger
Uventet ventetid (over 30s) Kold start på Aktivator, høj objektkardinalitet eller Eventstream-flaskehalse Varm aktivator op med testhændelser, gennemse objektkardinalitet, kontrollér Eventstream-diagnosticering
"Ingen data"-fejl efter 10 min. Eventstream-kilden er inaktiv eller afbrudt Overvåg hændelsesstrømmens kildetilstand; implementere regler for registrering af impulser for proaktivt at fange disse afbrydelser
Affyring af regler for ofte i testtilstand Brug af syntetiske eller afspillede testdata med tilstande, der ændrer sig hurtigt Brug kontrollerede, deduplikerede testdata. anvend filtre for at fokusere på realistiske objekter/begivenheder

Diagnosticering af problemer med indbyggede værktøjer

  • Før du aktiverer, skal du bruge eksempelfunktionen til at se, hvor ofte en regel ville være blevet udløst på historiske begivenheder. Denne fremgangsmåde er afgørende for:

    • Identificerer forkert konfigurerede filtre
    • Registrering af højfrekvente udløsere
    • Sikrer korrekt objektgruppering

  • Overvåg eventstream ved hjælp af Eventstreams overvågningspanel til at:

    • Bekræft hændelsesflow fra upstreamkilder
    • Kontrollér tidsstempler og nyttedatastruktur
    • Identificer rullemenuer, eller formatuoverensstemmelser

  • Gennemse logfiler over udløste handlinger: Handlinger, der udløses af Activator (pipelines, flows) logkørselsmetadata:

    • Tidsstempel, nyttedata, regel, der udløses
    • Udførelse lykkedes/mislykkedes (via pipelinekørselshistorik eller Power Automate-logfiler)

  • Registrer skemauoverensstemmelse: Aktivatoren kan muligvis ikke binde regler til data uovervåget, hvis:

    • Feltnavnet er stavet forkert
    • Værdityperne (f.eks. streng vs. numerisk) stemmer ikke overens med Brug Eventstreams live-eksempelvisning for at bekræfte skemaets korrekthed før oprettelsen af reglen.

Arbejde med Microsoft Support

Når problemerne fortsætter og kræver eskalering, skal du åbne en supportanmodning og inkludere følgende oplysninger:

  • Navn på arbejdsområde og aktivator
  • Oplysninger om hændelsesstreamkilde
  • Regel-id'er og deres betingelser
  • Omtrentlige tidsstempler og berørte objektnøgler
  • Udløst handlingskonfiguration og forventet resultat

Medtag følgende oplysninger, hvis det er muligt:

  • Eksportér eksempelhændelsesnyttedata (renset)
  • Hent skærmbilleder af regeleksempler og overvågningspaneler
  • Bemærk, om problemet kan reproduceres på andre aktivatorer eller miljøer

Bedste fremgangsmåder til at forhindre problemer

  • Brug altid regeleksempel, før du går live, især i streams med høj lydstyrke
  • Foretrækker tilstandsfulde operatorer for at undgå gentagne udløsere
  • Implementer impulsregler for at registrere fejl i uovervåget stream
  • Overvåg jævnligt objektnøglekardinalitet og strømline skemaer
  • Design regler med overvågning og fallback i tankerne (f.eks. besked, hvis reglen ikke er udløst i X-tid)

Relateret indhold

Du kan også få mere at vide om Microsoft Fabric:

  • Last updated on