Comparteix a través de


Supervisar i resoldre Dataverse problemes d'execució de connectors (versió preliminar)

[Aquest tema forma part de la documentació preliminar i està subjecte a canvis.]

Utilitzeu el seguiment per solucionar problemes de connectors de codi baix i professional. El rastreig ajuda els fabricants a registrar la informació en temps d'execució com a ajuda per diagnosticar la causa de les fallades o per a la validació general de certs estats durant el desenvolupament.

Important

  • Aquesta és una característica de visualització prèvia.
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

El mòdul de monitorització de connectors de l'accelerador Dataverse és una visió millorada de les capacitats de seguiment i registre existents disponibles per Microsoft Dataverse als connectors. La interfície ajuda a millorar els processos de resolució de problemes i depuració durant la fase de desenvolupament situant els detalls rellevants en un tractament modern.

Tots els esdeveniments que apareixen a l'aplicació es llegeixen des de la taula Trace durant 24 hores mitjançant els tipus de flux de treball següents:

  • Complements
  • API personalitzades
  • Connectors de codi baix instantanis i automatitzats

Interfície de monitorització de connectors

Requisits previs

Heu de tenir l'assignació de funcions de seguretat següent i accedir a l'aplicació Dataverse acceleradora:

  • Funció de seguretat: tant les funcions de seguretat del personalitzador del sistema com les funcions d'administrador del sistema tenen els privilegis necessaris per habilitar els registres i utilitzar l'aplicació per defecte.

  • També podeu crear funcions personalitzades amb accés específic a cada capacitat configurant els privilegis següents:

    • Per llegir registres, es requereix un privilegi de lectura a nivell d'organització a la taula Trace .
    • Per habilitar el registre a l'entorn, es requereix un privilegi d'escriptura a nivell d'organització a la taula de l'organització.PluginTraceLogSetting

Característiques destacades

  • Visualitzador de registres centralitzat: accediu i visualitzeu els registres de seguiment d'API Dataverse personalitzades, complements de codi baix i execucions de complements de codi professional en un entorn des d'una ubicació central.
  • Capacitats de filtratge: filtreu convenientment l'historial de registres per trobar ràpidament registres rellevants per a les vostres necessitats de depuració.

Instal·lació

Aquesta funció està disponible a l'aplicació Dataverse acceleradora. Aneu a l'article Dataverse de l'accelerador per obtenir instruccions d'instal·lació.

Proveu la funció de monitorització de connectors

  1. Toca l'accelerador Dataverse .

  2. Aneu a la funció de monitorització de connectors (a la subfinestra de navegació esquerra o a la targeta de funcions a la pantalla de destinació).

Aneu a la pàgina de supervisió de connectors

Habilitar la captura de registres

Si la captura de registres no està habilitada al vostre entorn, la pàgina de destinació mostra un estat desactivat amb dues opcions per habilitar el registre: Tots o Excepcions. Trieu l'opció adequada en funció de les vostres necessitats, aneu a l'article Registre i seguiment per obtenir més informació.

Activa la pantalla de registre amb botons per habilitar tots els registres o habilitar només excepcions

Podeu canviar aquesta configuració més endavant a la pantalla Configuració si cal, a la qual es pot accedir a la barra d'ordres de les pantalles principals.

La pantalla de configuració del registre proporciona controls per actualitzar la configuració del registre

Propina

El rastreig i el registre són ideals per a la depuració durant el desenvolupament de connectors. Per als fluxos de treball de complements en producció, utilitzeu Azure App Insights per a la supervisió.

Visualitza els registres

Quan els registres estan activats, els esdeveniments del connector comencen a mostrar-se a la llista principal que es mostra a la pantalla.

Propina

Si no es mostren registres, podeu crear i executar un nou complement de codi baix per començar a mostrar registres.

Filtrar registres

Utilitzeu les capacitats de filtratge per trobar ràpidament els registres rellevants per als connectors en què esteu treballant.

Seleccioneu Filtre a la part superior dreta de la barra d'ordres per obrir la subfinestra de filtre. També podeu filtrar ràpidament per paraules clau mitjançant la barra de cerca.

Filtrar registres

Filtre Descripció
Nom Seleccioneu el nom lògic del connector.
Comença després / abans La data i l'hora en què s'ha invocat el connector.
Habilita només l'excepció Mostra les execucions amb estat d'error.
Durada min / max Abast mínim i màxim de la durada del connector.
Type La classificació del flux de treball del complement. Els tipus disponibles inclouen:
  • Connector instantani de codi baix
  • Connector automatitzat de codi baix
  • Complements
  • API personalitzada
Mode Si el connector és síncron o asíncron.

Llegeix els detalls del registre

Seleccioneu una entrada de registre específica per veure informació detallada sobre l'execució del complement. Els detalls del registre inclouen la marca de temps, el nom del connector, l'estat d'execució, els paràmetres de sortida, els missatges d'error i molt més. Els camps de bloc de missatges i blocs d'excepció es mostren a sota dels detalls bàsics de la subfinestra i s'expandeixen si hi ha dades a les columnes respectives.

Procediments recomanats

Examinar els detalls del registre

  • Seleccioneu una entrada de registre específica per veure informació detallada sobre l'execució del complement.
  • Els detalls del registre poden incloure la marca de temps, el nom del connector, l'estat d'execució, els paràmetres d'entrada/sortida, els missatges d'error i molt més.

Solució de problemes

  • Utilitzeu la informació proporcionada als registres de seguiment per resoldre els problemes que sorgeixin durant l'execució del complement.
  • Analitzeu els missatges d'error, els paràmetres d'entrada/sortida i els detalls d'execució per identificar la causa principal del problema.
  • Utilitzeu missatges de traça per proporcionar punters útils. L'escriptura al servei de traça està disponible a l'SDK Dataverse i als complements de codi baix com a funció de traça Power Fx.

Executar una acció

  • A partir de la informació recopilada dels registres de seguiment, preneu les mesures adequades per solucionar els problemes de rendiment o els errors identificats.
  • Això pot implicar ajustar les configuracions dels complements, actualitzar la lògica del codi o buscar ajuda dels recursos de suport.

Planificar la prova

  • Acostumeu-vos a planificar casos de prova que podeu executar en registres de traça per validar el rendiment del connector durant el desenvolupament.
  • Solucioneu qualsevol problema o anomalia ràpidament per mantenir l'estabilitat i la fiabilitat generals dels vostres Dataverse connectors.

Supervisar el rendiment dels connectors

  • Superviseu periòdicament el rendiment dels connectors en producció mitjançant la revisió dels registres de traça registrats Application Insights.
  • Vigileu l'estat d'execució, els missatges d'error i qualsevol anomalia que pugui indicar problemes de rendiment o errors.

Preguntes més freqüents del

Quins privilegis es necessiten per accedir al visualitzador de registres de traça?

Heu de tenir com a mínim privilegis de lectura a la taula Trace per visualitzar els registres.

Qui pot habilitar la captura de registres dins de l'entorn?

Els administradors del sistema amb la funció de seguretat adequada poden habilitar la captura de registres dins del seu entorn. Específicament, es necessita accés d'escriptura a la taula Organization per actualitzar el valor de la columna PluginTraceLogSetting .

Puc filtrar l'historial de registres per trobar registres específics?

Sí, el visualitzador de registres de traça proporciona capacitats de filtratge, permetent als usuaris trobar còmodament registres rellevants per a les seves necessitats de depuració.

La funció de monitorització de connectors està disponible en tots els entorns?

La funció es lliura a través de l'accelerador Dataverse i està disponible en tots els entorns que tenen l'aplicació instal·lada. L'aplicació s'instal·la automàticament en tots els entorns nous, però també es pot instal·lar en entorns més antics seguint les instruccions d'instal·lació.

Després d'habilitar el registre, encara mostra la pantalla "El registre està desactivat"

Si teniu els privilegis correctes i esteu segur que heu activat el registre, actualitzeu la pestanya del navegador. Podeu validar si el registre està habilitat mitjançant l'experiència heretada.

Consulteu també

Obtenir les característiques de previsualització anticipada amb l'accelerador Dataverse (visualització prèvia)