Microsoft Dataverse-n telemetria-gertaerak

Datu korronteak gaur egun erlazionatutako errendimendu datuak eskaintzen ditu Dataverse API sarrerako deiak, Dataverse plugin exekuzio deiak, eta Dataverse SDK deiak. Plugin eta hutsegiteen datuak ere eskaintzen ditu Dataverse SDK eragiketak.

Dataverse APIaren sarrerako deiak

Honi deitutako deiak dira Dataverse APIa. Interfaze bateratu (UCI), webgune zaharreko bezeroa, SDK erabiltzen duten bezero pertsonalizatuak eta abarrekoak izan daitezke. Hemen aurki ditzakezu eskaerak taula Application Insights, honako eremu hauek dituena.

• Izena: Eskaera mota. Hauek bi kategoriatan banatzen dira:

  • Web API Eskaera: Interfaze Bateratuak eta bezero modernoek erabili ohi duten OData v4 amaiera-punturako eskaera. Eskaera bietan ohikoa den eragiketa bihurtzen da. Web APIa RESTful programazio eredua gaitzeko "biltzailea" da, baina datuak jaso ondoren, zerbitzariaren barruan dena berdin bihurtzen da. Erantzuna itzultzerakoan, JSON bihurtzen da eskaera Web APItik badator.
  • Erakundearen Zerbitzu Eskaera: SDK bezeroek edo web bezero zaharrak erabiltzen duten Erakundearen API amaierako puntura egindako eskaera.

• Iraupena: Zerbitzariak eskaerari erantzuteko behar izan duen denbora.

• Url: Deia egin den URLa.

• Neurri pertsonalizatuak:

  • UserAgent: Application Insights -ek automatikoki betetzen du erabiltzaile-agentearen eremua PC -rekin, erregistro hauek datu-zentro bateko zerbitzari batetik bidaltzen diren heinean. Application Insights ez du onartzen erabiltzaile agentearen eremua gainidaztea. Batzuetan, erabiltzailearen agentearen eremua ez dago erabilgarri. Deia egin duen erabiltzaile agentea kontsulta hau erabilita ikus daiteke:

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

    

• Operation_Name: Eragiketaren izen irakurgarria, ikuspegietan bistaratzeko, hala nola muturretik muturrerako transakzio-ikuspegian.

Dataverse pluginen exekuzio-egunkariak

Eragiketa jakin baterako exekutatzen diren plugin pertsonalizatuen erregistro hauek mendekotasuna mahaia. Honako hau laginaren kontsulta da:

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

• Izena/Helburua: Exekutatzen ari den pluginaren mota-izen osoa.
• Iraupena: Plugin-a exekutatzeko behar izan den denbora.
• Neurri pertsonalizatuak:
  • Sakonera: Dei-pilan exekuzioaren uneko sakonera .
  • EntityName: Pluginak eragiten dion entitatearen izena.
  • IsolationType: Plugin-a sandbox-ean exekutatzen ari den ala ez adierazten duen balio bat :
    • 1: bat ere ez
    • 2: sandbox-a
    • 3: kanpokoa
  • PluginName: Pluginaren erabiltzaileentzako izen erraza.
  • PluginType: Exekutatzen ari den plugin motaren izena.
  • PluginVersion: Argitaratutako pluginaren bertsioa. Hemen asmoa da informazio hau bertsioen eguneratzeak konpontzen erabiltzeko gai izatea.
  • Etapa: Balio hauetara mapatzen da:
    • Aurre-balidazioa = 10
    • Aurre-eragiketa = 20
    • PreOperationBeforeExternalPlugins = 15
    • PreOperationAfterExternalPlugins = 25
    • Eragiketa nagusia = 30
    • PostOperationBeforeExternalPlugins = 35
    • PostOperationAfterExternalPlugins = 45
    • PostOperation = 40
    • PostOperationDeprecated = 50
  • StepName: SDK Mezua Prozesatzeko urratsaren izena. Hau normalean sortzen du pluginak Erregistroa tresnak informazioa erabiliz buruz PluginName, PluginType, eta eragiketaren izena—adibidez ErrorMessageTest.ThrowException: kontuaren sorrera.

Telemetria zure plug-kodearen barruan

Gertatzen ari dena ulertzeko barruan plug-in kodearen bidez, telemetria pertsonalizatua sar dezakezu plug-inaren bidez Microsoft.Xrm.Sdk.PluginTelemetry.ILogger Interfazea zure plug-in kodean telemetria datuak zuzenean zure Application Insights baliabidea. Informazio gehiago: Idatzi Telemetria zure Application Insights baliabidea ILogger erabiliz (aurrebista)

Dataverse SDK egunkariak

Sarrera eskaera baten zati gisa abiarazitako SDK eragiketen erregistroak dira. Hauek mendekotasuna mahaia Application Insights, exekutatzeko eskaeraren mendekotasun gisa jarraitzen direlako. Hasierako motaren izenarekin identifikatzen dira SDK. Honako hau laginaren kontsulta da:

dependencies
| where type startswith "SDK"
| take 10

• Mota: Abiarazitako SDK eskaera mota. Adibidez, berreskuratu, RetrieveMultiple, FetchXmlToQueryExpression eta WhoAmI daude.
• Izena/Helburua: SDK eragiketak helburu duen entitatearen izena da hau.
• Neurri pertsonalizatuak:
  • Bezero mota: Deia datorren bezero mota. Balio posible batzuk Web, UCIClient eta OutlookFull dira.
  • EntityId: Erabiltzen ari den entitatearen identifikatzaile bakarra.
  • EntityName: Erabiltzen ari den entitatearen izena.

Salbuespenak

Plugin eta SDK eragiketen hutsegiteen xehetasunak ikusiko dituzu Application Insights. Salbuespenak mahaia Application Insights ahalmenak Hutsegiteak panela. Hutsegiteen xehetasun horiek plug-ineko gainerako gertaerekin eta SDK deiekin amaierako ikuspegitik lotzen dira. Eskuragarri dagoen informazio guztia zutabeetara gehitzen da ahal denean eta customDimensions zutabeen bat-etortze zehatzik ez dagoenean.

Ikusiko duzu eremuko zenbait salbuespenak taula ez da betetzen. Hau da eremu hauek ezar daitezkeelako Application Insights SDK iturritik erregistroak igortzeko erabiltzen da. Ezaugarri honek plataformaren telemetria biltzen du eta gero sartu egiten du Application Insights arauaren arabera Application Insights eskema.

exceptions
| take 10

Kontsulta honek atributuko xehetasun guztiak itzuliko ditu salbuespena mahaia.

• problemId/type: Salbuespen mota.
• outerMessage: Salbuespen mezua.
• neurri pertsonalizatuak:
  • clientType: Deia datorren bezero mota. Balio posible batzuk Web, UCIClient eta OutlookFull dira.
  • exceptionSource: Salbuespena sortu den plugina edo puntua.
  • entityName: Erabiltzen ari den entitatearen izena.
  • pluginName: Salbuespena sortu den pluginaren izena.

Erabiltzaile batek errore baten berri ematen badu, erabiltzaile IDa (Microsoft Entra ID ID) erabil dezakezu salbuespen taularen xehetasunak ulertzeko.

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

Entitatearen IDa eta entitatearen izena hemen daude eskuragarri customDimensions urtean mendekotasuna mahaia.

dependencies
| where type == "SDK Retrieve"

Maiz egiten diren galderak (FAQ)

Jarraian telemetriako gertaerekin lotutako ohiko galderak agertzen dira Dataverse.

Nola zehaztu dezaket nire plug-in bertsio berritzeak errendimendua hondatu duen ala ez?

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

Pluginaren izenak plugin pertsonalizatuen bertsioa ere izan behar du.

Nola funtzionatzen zuen APIak salatutako arazo baten aurretik, eguneko orduaren edo kokapenaren arabera? APIen degradazioa graduala edo bat-batekoa izan al da?

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

Taula honetan, APIaren amaierako puntuaren errendimendua ikus dezakegu denbora tarte batean egiten ari den eskaera kopuruaren arabera.

Ere egin dezakezu alerta ezarri hemen API jakin baten errendimenduan oinarrituta Application Insights.

Ba al dezaket akatsak edo hutsegiteak une zehatz batzuetan edo erabiltzaile zehatz batzuei dei pila ulertzeko aukera ematen?

Begira Hutsegiteak panelak denbora tarte jakin bateko hutsegiteen ikuspegi orokorra eskaintzen du. API deian edo mendekotasun motan oinarritutako hutsegite zehatz batera murriztu dezakezu amaierako ikuspegia ikusteko.

Panel pertsonalizatuak sor ditzaket?

Bai. Eraiki dezakezu panel pertsonalizatuak Application Insights-rekin.

Pluginaren erabileraren errendimendua (erantzun denbora) eta porrot tasak zehaztu al ditzaket erabilera altuenean?

Bai. Ikusi hurrengo laginaren kontsulta zure pluginek nola funtzionatzen duten ulertzeko.

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

Telemetria honek mugimendua izango al du?

Bai. Une honetan oinarrizko 429 erroreen xehetasunak ematen dira.

Ulertzen al ditut exekuzio bideak? Pluginak egiten dituen deiak plugina moteltzen al dute?

Bai. Edozein eskaerarako exekutatzen diren mezu eta plugin guztiak ikus ditzakezu.

Mezu guztien eta pluginen exekuzioaren iraupena erregistratzen da. Plugin batek denbora gehiago behar badu, plug-in hori identifikatu dezakezu. Pluginak atzera deia egiten badu Dataverse, dei horren iraupena erregistratuta dago. Gehigarriei buruzko informazio gehiago aurreikusten da etorkizunean inplementatzeko.

Pluginak egindako irteerako deiak automatikoki erregistratuko dira mendekotasun gisa.

Eskaera zehatz baterako telemetria ikus dezaket?

Dataverse eskaera guztien goiburuko erantzunean x-ms-service-requestId itzultzen du. RequestId hau erabiliz, telemetria guztia kontsulta dezakezu.

union *
| where operation_ParentId contains <requestId>