Del via

Telemetrihændelser til Microsoft Dataverse

  • Artikel

Bemærk

Den nye og forbedrede Power Platform Administration er nu i offentlig forhåndsversion! Vi har designet det nye Administration, så det er nemmere at bruge med opgaveorienteret navigation, der hjælper dig med at opnå specifikke resultater hurtigere. Vi udgiver ny og opdateret dokumentation, efterhånden som det nye Power Platform Administration bliver generelt tilgængeligt.

Datastrømmen indeholder i øjeblikket ydelsesdata vedrørende indgående Dataverse-API-kald, Dataverse-kald til plug-in-kørsel og Dataverse-SDK-kald. Den indeholder også data om fejl i plug-in- og Dataverse-SDK-handlinger.

Dataverse API-indgående opkald

Disse kald foretages til Dataverse-API. De kan komme fra Unified Interface (UCI), den ældre webklient, brugerdefinerede klienter, der bruger SDK osv. De kan findes i forespørgselstabellen, som indeholder følgende Application Insights-felter.

  • Navn: Type anmodning. De er opdelt i to kategorier:

    • Anmodning om web-API: En anmodning til OData v4-slutpunkt, der ofte bruges af Unified Interface og moderne klienter. Anmodningen transformeres til en handling, der er fælles for begge. Web API er en "wrapper" til aktivering af RESTful-programmeringsmodellen, men når dataene er modtaget, bliver alt det samme inden for serveren. Når svaret returneres, konverteres det til JSON, hvis anmodningen kommer fra web-API'en.
    • Anmodning om organisationsservice: En anmodninger til det API-organisationsslutpunkt, der bruges af SDK-klienter eller den ældre webklient.

  • Varighed: Den tid, det har taget serveren at besvare anmodningen.

  • Webadresse: Den URL-adresse, som opkaldet blev foretaget til.

  • CustomDimensions:

    • UserAgent: Application Insights udfylder automatisk feltet med brugeragenter ved hjælp af pc, da disse logge trykkes fra en server i et datacenter. Application Insights Det er ikke muligt at tilsidesætte feltet med brugeragenter. Undertiden kan brugeragent-feltet ikke udfyldes. Den brugeragent, som opkaldet blev foretaget fra, kan ses ved hjælp af følgende forespørgsel:

      requests
| summarize count() by tostring(customDimensions.userAgent)

      Application Insights CustomDimensions UserAgent.

  • Operation_Name: Det læsbare navn på den handling, der skal vises på visninger, f.eks. slutpunkt til slutpunkt-transaktionsvisningen.

Dataverse plug-in udførelseslogge

Disse logge for brugerdefinerede plug-ins, der kører for en bestemt handling, findes i afhængighedstabellen. Følgende er en eksempelforespørgsel:

dependencies
| where type == "Plugin"
| take 100

Application Insights Dataverse plug-in udførelseslogge.

  • Navn/mål: Det fuldt kvalificerede typenavn til den plug-in, der køres.
  • Varighed: Den tid, det tog at køre plug-in'en.
  • CustomDimensions:
    • Dybde: Den aktuelle Dybde for udførelse i opkaldsstakken.
    • EntityName: Navnet på det objekt, som plug-in'en handler med.
    • IsolationType: En værdi, der angiver, om plug-in'en køres i sandkassen:
      • 1: Intet
      • 2: Sandkasse
      • 3: Ekstern
    • PluginName: Det brugervenlige navn på plug-in.
    • PluginType: Navnet på den type plug-in, der køres.
    • PluginVersion: Den udgivne version af plug-in'en. Formålet her er at kunne bruge disse oplysninger til fejlfinding af versionsopdateringer.
    • Fase: Knyttes til følgende værdier:
      • PreValidation = 10
      • PreOperation = 20
      • PreOperationBeforeExternalPlugins = 15
      • PreOperationAfterExternalPlugins = 25
      • MainOperation = 30
      • PostOperationBeforeExternalPlugins = 35
      • PostOperationAfterExternalPlugins = 45
      • PostOperation = 40
      • PostOperationDeprecated = 50
    • StepName: Navnet på trinnet til behandling af SDK-meddelelser. Det oprettes normalt af værktøjet til registrering af plug-ins ved hjælp af oplysninger om PluginName, PluginType og navnet på handlingen, f.eks. ErrorMessageTest.ThrowException: Oprettelse af firma.

Telemetri inden for din plug-in-kode

Hvis du vil forstå, hvad der sker inden for din plug-in-kode, kan du inkludere brugerdefineret telemetrisk software fra plug-in'en ved hjælp af Microsoft.Xrm.Sdk.PluginTelemetry.ILogger Interface i plug-in-koden, så du kan skrive telemetridata direkte til Application Insights-ressourcen. Flere oplysninger: Skrive telemetri til Application Insights-ressourcen ved hjælp af ILogger (forhåndsversion)

Dataverse SDK-logge

Disse er logge for SDK-handlinger, der udløses som en del af en indgående forespørgsel. De logføres i afhængighedstabellen i Application Insights, da de spores som afhængigheder for den forespørgsel, der skal udføres. De identificeres ud fra typenavnet og starter med SDK. Følgende er en eksempelforespørgsel:

dependencies
| where type startswith "SDK"
| take 10

Application Insights-forespørgsels-SDK.

  • Type: Den type SDK-anmodning, der er udløst. Af eksempler kan nævnes Retrieve, RetrieveMultiple, FetchXmlToQueryExpression og WhoAmI.
  • Navn/mål: Dette er navnet på det objekt, sdk-handlingen henvender sig til.
  • CustomDimensions:
    • ClientType: Den type klient, opkaldet kommer fra. Nogle af de mulige værdier er Web, UCIClient og OutlookFull.
    • EntityId: Det entydige id for det objekt, der bruges.
    • EntityName: Objektnavn, der bruges.

Undtagelser

Du kan se oplysninger om fejl i plug-in- og SDK-handlinger i Application Insights. Undtagelsestabellen i Application Insights giver kompetence til panelet Fejl. Disse oplysninger om fejl er i overensstemmelse med resten af hændelserne i plug-in- og SDK-kald i slutpunkt til slutpunkt-visningen. Alle tilgængelige oplysninger føjes til kolonner, når det er muligt, og til customDimensions, når der ikke er det nøjagtige kolonneoverensstemmelse.

Du vil se, at nogle af felterne i undtagelsestabellen ikke udfyldes. Dette skyldes, at disse felter kun kan angives, hvis Application Insights SDK bruges til at sende logge fra kilden. Denne funktion indsamler platformstelemetri og skubber den derefter ind Application Insights i henhold til Application Insights-skemaet.

Application Insights-undtagelsestabel. 

exceptions
| take 10

Denne forespørgsel returnerer alle attributdetaljerne fra undtagelsestabellen.

  • problemId/type: Undtagelsestypen.
  • outerMessage: Undtagelsesfejl.
  • customDimensions:
    • ClientType: Den type klient, opkaldet kommer fra. Nogle af de mulige værdier er Web, UCIClient og OutlookFull.
    • exceptionSource: Den plug-in eller det punkt, hvor undtagelsen blev slynget.
    • EntityName: Objektnavn, der bruges.
    • pluginName: Navnet på den plug-in, hvor undtagelsen blev aktiveret.

Application Insights- detaljer om tabelattribut med undtagelser.

Hvis en bruger rapporterer en fejl, kan du bruge bruger-id (Microsoft Entra-ID) til at forstå detaljer fra undtagelsestabellen.

exceptions
| where user_Id == '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

Objekt-id og objektnavn er tilgængelige i customDimensions i afhængighedstabellen.

dependencies
| where type == "SDK Retrieve"

Application Insights SDK hent forespørgsel.

Ofte stillede spørgsmål

Nedenfor følger nogle ofte stillede spørgsmål vedrørende telemetri for Dataverse.

Hvordan kan jeg finde ud af, om min plug-in-opgradering medførte en forringelse af ydeevnen?

dependencies
| where ['type'] == "Plugin"
| where name startswith "[InsertYourPluginName]"
| summarize avg(duration) by name

Plug-in-navnet skal også indeholde versionen for brugerdefinerede plug-ins.

Hvordan udførte API'en før et rapporteret problem baseret på tidspunktet på dagen eller på placeringen? Var API-forringelsen gradvis eller pludselig?

requests
| where url == "https://<URLHere>"
| summarize avg(duration), count() by bin(timestamp, 1h)
| render timechart

Application Insights API-tidsdiagram for ydeevne.

I dette diagram kan vi se ydelsen af API slutpunkt over en periode i forhold til antallet af forespørgsler, der er foretaget.

Du kan også konfigurere en advarsel baseret på ydeevne i en bestemt API her i Application Insights.

Kan jeg analysere ned om fejl eller fejl på bestemte tidspunkter eller for bestemte brugere, så jeg kan forstå opkaldsstakket?

Når du kigger på Fejl-panelet, får du en oversigt over fejlene i en bestemt tidsperiode. Du kan derefter indsnævre til en bestemt fejl, afhængigt af API-kaldet eller afhængighedstypen, for at se slutpunkt til slutpunkt-visningen.

Application Insights-fejldetaljer.

Kan jeg oprette brugerdefinerede dashboards?

Ja. Du kan oprette brugerdefinerede dashboards med Application Insights.

Kan jeg bestemme ydeevne (svartid) for plug-ins og fejlprocenter i forbindelse med brugen af plug-ins?

Ja. Se følgende eksempelforespørgsel for at finde ud af, hvordan plug-ins præsterer.

dependencies
| where ['type'] == "Plugin"
| where name == "[Plugin name here]"
| summarize avg(duration) by bin(timestamp, 1h)
| render timechart

Plug-in i forbrug af ydeevne.

Hvorfor har telemetri begrænsning?

Ja. Der er i øjeblikket angivet grundlæggende 429 fejldetaljer.

Kan jeg forstå eksekveringsstier? Sinker opkald fra plug-in'en plug-in'en?

Ja. Du kan få vist alle de meddelelser og plug-ins, der køres for en forespørgsel.

Varigheden af alle meddelelser og udførelse af plug-ins logføres. Hvis det tager længere tid at bruge en plug-in, kan du identificere den pågældende plug-in. Hvis plug-in'en foretager et tilbagekald til Dataverse, logføres varigheden af det pågældende opkald. Der er planlagt flere oplysninger om plug-ins til fremtidig installation.

Alle udgående opkald, der foretages af plug-in'en, logføres automatisk som en afhængighed.

Komplet transaktion.

Kan jeg få vist telemetri på en bestemt forespørgsel?

Dataverse returnerer x-ms-service-requestId i headerresponse på alle forespørgsler. Ved hjælp af denne requestId kan du anmode om alle telemetridata.

union *
| where operation_ParentId contains <requestId>