Monitor de diagnóstico

El Monitor de diagnóstico es un servicio de diagnóstico integrado dentro de ArcGIS Pro. La información sobre el estado, los registros y los eventos se presentan y actualizan de forma continua en el Monitor de diagnóstico mientras se ejecuta ArcGIS Pro. El Monitor de diagnóstico contiene un conjunto de pestañas e indicadores de estado. El Monitor de diagnóstico incluye actualmente las pestañas Contadores, Tareas, HTTP, Registro, Propiedades de diagnóstico y Estados.

La información que aparece en la ventana Monitor de diagnóstico se puede utilizar para ayudar a diagnosticar varios problemas relacionados con las aplicaciones, entre los que se incluyen condiciones en las que las aplicaciones dejan de responder, el consumo excesivo de recursos, los fallos de funciones y la pérdida de rendimiento.

Descripción general del Monitor de diagnóstico

Nota:

El Monitor de diagnóstico está disponible en todos los productos basados en ArcGIS Pro y es distinto de ArcGIS Monitor, un producto para implantaciones de ArcGIS Enterprise.

Iniciar monitor de diagnóstico

Al abrir la ventana Monitor de diagnóstico se habilita el Modo de diagnóstico.

Puede abrir la ventana Monitor de diagnóstico de las siguientes formas:

  • En un proyecto abierto, haga clic en la pestaña Ayuda de la cinta. En el grupo Rendimiento, haga clic en Monitor de diagnóstico Monitor de diagnóstico.
  • Pulse Ctrl+Alt+M mientras ArcGIS Pro esté abierto. No es necesario que haya un proyecto abierto.
  • Inicie ArcGIS Pro desde la línea de comandos con el conmutador /enablediagnostics.

Si utiliza la opción de línea de comandos, también puede incluir un parámetro /loglevel=debug para habilitar el modo de depuración en el Monitor de diagnóstico. El modo de depuración persiste en las sesiones posteriores de ArcGIS Pro hasta que lo deshabilite desde la pestañaRegistro.

Nota:

Cuando el Monitor de diagnóstico se habilita desde la línea de comandos, el cuadro de diálogo se minimiza inicialmente en la barra de tareas de Microsoft Windows.

Para solucionar un flujo de trabajo con el Monitor de diagnóstico, abra el monitor antes de trabajar en el área del problema. Para configurar la ventana Monitor de diagnóstico de modo que permanezca encima de todas las demás ventanas en ArcGIS Pro, haga clic con el botón derecho en el área del título de la ventana y haga clic en Siempre arriba. Esto puede ser útil cuando se desea monitorizar con detenimiento la actividad en el Monitor de diagnóstico mientras se utilizan distintas entidades de la aplicación.

Nota:

Las capacidades del Monitor de diagnóstico dependen de que se grabe y registren los estados de la aplicación y los eventos de ArcGIS Pro. Aunque el Monitor de diagnóstico se ha creado para ser lo más liviano posible, puede tener un pequeño impacto en el rendimiento de los flujos de trabajo de ArcGIS Promientras que la ventana Monitor de diagnóstico está abierta y registra información.

Descripción general de la arquitectura de ArcGIS Pro

ArcGIS Pro es una aplicación modular multiproceso de 64 bits. Los subsistemas funcionales se cargan bajo demanda y realizan trabajos (como calcular una zona de influencia o renderizar un mapa) en subprocesos de trabajador o en procesos de trabajador separados. En la mayoría de los casos, las unidades lógicas del trabajo (operaciones) se organizan en una o varias tareas durante la ejecución. Las tareas son fundamentales en lo que respecta a cómo se realiza el trabajo en ArcGIS Pro y se resaltan de forma destacada en el Monitor de diagnóstico.

Un subproceso dedicado es responsable de representar los elementos de la interfaz de usuario de la aplicación y de procesar las entradas del usuario en forma de entrada de teclado y clics del ratón. Mientras se ejecuta una operación en uno de los subprocesos de trabajador, el subproceso de la interfaz gráfica de usuario (GUI) proporciona comentarios relevantes sobre el progreso de la operación, así como un medio para cancelar la operación, si corresponde. El Monitor de diagnóstico se ejecuta en un subproceso independiente de la GUI. Esto permite que la ventana Monitor de diagnóstico siga siendo dinámico incluso si el subproceso de GUI se bloquea.

Los subprocesos de trabajador de ArcGIS Pro están divididos en familias dedicadas a áreas funcionales específicas.

  • Subprocesos en primer plano: un conjunto de cuatro subprocesos de trabajador que regula el Modelo de información cartográfica (CIM), el repositorio principal del estado de configuración dentro del proyecto cargado actualmente. Estos subprocesos también ayudan a acelerar el renderizado del mapa. Algunos tipos de interacciones de usuario están prohibidos mientras las operaciones se ejecutan en subprocesos en primer plano.
  • Subprocesos en segundo plano de alta prioridad y Subprocesos en segundo plano de baja prioridad: estos subprocesos realizan una amplia variedad de operaciones que no dependen del estado del CIM y se pueden ejecutar en segundo plano mientras el usuario realiza otras acciones. Las tareas asignadas a los subprocesos en segundo plano de alta prioridad se ejecutan más rápidamente y tienen prioridad sobre las tareas asignadas a los subprocesos en segundo plano de baja prioridad.
  • Subprocesos varios: el subproceso de geoprocesamiento en segundo plano se utiliza para realizar operaciones de geoprocesamiento en segundo plano. Internamente, este subproceso suele colaborar con otros subprocesos para completar la operación. El subproceso de segundo plano compartido se utiliza para casos especiales en los que los conjuntos de tareas se deben ejecutar en el mismo subproceso a lo largo del tiempo.
Descripción general de los subprocesos utilizados en el Monitor de diagnóstico

Área de estado

El área de Estado contiene indicadores de Estado e indicadores de Actividad del subproceso. Los indicadores de Estado muestran distintos colores en función del estado actual de la aplicación. Son útiles para acotar los problemas que ocurren dentro de la aplicación. Los indicadores de Actividad del subproceso muestran colores basados en el estado de los subprocesos correspondientes.

Indicadores de estado

Indicadores de estado en el Monitor de diagnóstico

ElementoDescripción
1

El rojo indica que el subproceso de GUI ya no envía mensajes y no puede responder a la entrada del ratón o del teclado; los gráficos de la interfaz de usuario pueden renderizar de forma incorrecta cuando el subproceso de GUI no responde. Los eventos de falta de respuesta se registran en el Registro de no respuesta.

2

El amarillo indica que la tarea activa no tiene un indicador de progreso asociado y, por lo tanto, el usuario recibe comentarios inadecuados mientras se ejecuta la tarea. Las tareas asociadas también se marcan en amarillo en el registro de tareas cuando se detecta esta condición.

3

El amarillo indica que la tasa de emisión de las tareas es de más de 10 por segundo.

4

El verde indica que una o más solicitudes HTTP están activas actualmente en la aplicación.

5

El verde indica que una tarea se está ejecutando actualmente en el subproceso de primer plano. Es posible que varios botones y herramientas no estén disponibles mientras se ejecutan tareas en primer plano.

6

El amarillo indica que una vista (normalmente con un mapa, globo, escena o diseño) está ocupada en ese momento. Es posible que varios botones y herramientas no estén disponibles mientras una vista está ocupada.

7

El amarillo indica que un panel está ocupado actualmente. Es posible que varios botones y herramientas no estén disponibles mientras un panel está ocupado.

8

El amarillo indica que una tarea se atasca debido a operaciones relacionadas con el dibujo ejecutadas actualmente en uno de los subprocesos en primer plano. Es posible que varios botones y herramientas no estén disponibles mientras la aplicación está esperando.

9

El amarillo indica que una tarea se atasca mientras se reanuda una operación de dibujo previamente suspendida. Es posible que varios botones y herramientas no estén disponibles mientras se reanuda la aplicación.

10

El verde indica que se está ejecutando una operación de geoprocesamiento. Este indicador se iluminará independientemente de si se trata de una operación de geoprocesamiento en segundo o en primer plano.

Indicadores de actividad del subproceso

Cada uno de los subprocesos mencionados anteriormente tiene un indicador de actividad correspondiente dentro del área de estado del Monitor de diagnóstico. Los indicadores de estado del subproceso están en verde si el subproceso asociado se está ejecutando actualmente, y en gris si el subproceso está inactivo (suspendido). Los indicadores de estado del subproceso pueden aparecer en gris oscuro si la CPU del equipo host no tiene núcleos suficientes para admitir subprocesos adicionales.

Pestañas del Monitor de diagnóstico

El Monitor de diagnóstico consta de las pestañas Contadores, Tareas, HTTP, Registro, Propiedades de diagnóstico y Estados. La pestaña Contadores enumera los contadores internos. La pestaña Tareas muestra las tareas recientes. La pestaña HTTP proporciona un visor de solicitudes y respuestas HTTP. La pestaña Registro muestra un visor de registro de eventos. En la pestaña Propiedades de diagnóstico se muestra información de diagnóstico. La pestaña Estados permite ver todos los estados habilitados de la aplicación y los estados activos de la vista asociados a la sesión correspondiente de ArcGIS Pro.

Pestaña Contadores

La pestaña Contadores consta de una lista de contadores internos con nombre. Cada contador está vinculado al gráfico que se encuentra sobre la lista. Cuando se selecciona un contador de la lista, el gráfico se actualiza para mostrar los valores históricos de ese contador a lo largo de los últimos 20 segundos.

Pestaña Contadores en el Monitor de diagnóstico

Dentro de la lista de contadores hay métricas útiles que muestran cosas como el consumo de memoria, el recuento de subprocesos, el recuento de solicitudes HTTP y el recuento de DLL cargadas. Algunos contadores requieren una explicación adicional:

  • Tasa de tareas actual: la tasa actual a la que las tareas se ponen en cola en los subprocesos en primer plano. Un número alto puede indicar que se emite un número de tareas innecesariamente elevado para realizar la operación. Las operaciones con un gran número de tareas pueden ser menos eficientes.
  • Contadores CIM: estos contadores se utilizan para registrar el recuento total de operaciones de lectura y escritura del CIM. Las lecturas y escrituras relacionadas con el dibujo se cuentan por separado. Dado que cada operación tiene una sobrecarga asociada, los saltos más pequeños son preferibles a los saltos más grandes dentro de un intervalo de tiempo.
  • Contadores de tiempo de espera de solicitudes HTTP totales: estos contadores se utilizan para registrar el número y la tasa de solicitudes HTTP totales que han agotado el tiempo de espera. Las solicitudes que incrementan estos contadores se asocian más comúnmente a los códigos de respuesta HTTP 408 y 504.
  • Contadores de solicitudes: estos contadores están reservados para uso interno.

Pestaña Tareas

La pestaña Tareas contiene un registro de las tareas emitidas recientemente por la interacción del usuario, y otro registro para cualquier condición sin respuesta ocurrida en el subproceso de GUI.

Pestaña Tareas en el Monitor de diagnóstico

Registro de tareas de UI recientes

El registro de tareas de UI recientes proporciona un registro de las tareas más recientes emitidas en respuesta a las interacciones del usuario. Debido a la sobrecarga asociada con la identificación de funciones de tarea, este registro no está disponible cuando se cierra la ventana Monitor de diagnóstico. De forma predeterminada, las tareas se ordenan en orden cronológico con la tarea ejecutada más recientemente en la parte superior de la lista. Las tareas internas (en cola desde dentro de una tarea externa en ejecución) no aparecen en esta lista. Las tareas que se encuentran en cola o que se están ejecutando actualmente se muestran en verde. Cada tarea tiene un conjunto de propiedades asociado:

  • N.º de tarea: un número que indica la posición secuencial de una tarea; por ejemplo, la Tarea n.º 42 indica la cuadragésima segunda tarea en el proceso en ejecución.
  • Hora de puesta en cola: hora de reloj a la que la tarea se puso en cola originalmente. Las tareas iniciadas mientras se sigue ejecutando otra tarea siguen en cola y no comenzarán a ejecutarse hasta que la tarea actual se haya completado. Normalmente, los botones y controles se deshabilitan mientras se ejecuta una tarea en primer plano, para evitar que se ponga en cola tareas adicionales mientras se realiza la transición del estado de la aplicación.
  • Tiempo de tarea: la cantidad de tiempo en milisegundos asociado a la ejecución de la tarea.
  • Tiempo de reanudación: el tiempo invertido en esperar, en milisegundos, a que se complete la reanudación de un dibujo.
  • Tiempo de espera: el tiempo invertido en esperar, en milisegundos, a que finalicen las operaciones relacionadas con el dibujo.
  • Tiempo total: el tiempo total necesario, en milisegundos, para ejecutar la tarea, desde el momento en que la tarea se puso en cola hasta el momento en que se completa la tarea (incluido cualquier tiempo asociado a la reanudación del dibujo).
  • Función: el nombre de la función más externa mejor asociada con la tarea.

Las tareas que están en cola o que se están ejecutando muestran -1 en sus valores de tiempo. El tiempo real se mostrará en milisegundos cuando se complete o se cancele la tarea.

Se utiliza una heurística para mostrar la función más relevante para la tarea en cola. La heurística atraviesa la pila de llamada buscando un marco que contenga funciones ajenas al SO.

El Registro de tareas de IU reciente se puede ordenar desde cualquier columna, en orden ascendente o descendente. Esta capacidad se puede utilizar para identificar, por ejemplo, la tarea con el tiempo de ejecución más largo. El contenido del registro se puede copiar al portapapeles o borrar haciendo clic con el botón derecho en cualquier parte de la lista y haciendo clic en Copiar o Borrar, respectivamente.

Registro sin respuesta

Cada vez que el subproceso de la GUI no responde, se registra un evento de no respuesta con la hora de inicio y la duración total. El contenido de este registro se puede copiar al portapapeles haciendo clic con el botón derecho en cualquier parte de la lista y haciendo clic en Copiar.

Pestaña HTTP

La pestaña HTTP se divide en dos secciones: un menú de solicitudes y una sección de detalles.

Pestaña HTTP del Monitor de diagnóstico

La sección de solicitudes consta de una lista de solicitudes HTTP capturadas. Cuando se abre la ventana Monitor de diagnóstico, las solicitudes HTTP enviadas por ArcGIS Pro se registran en esta lista, empezando por la solicitud más reciente. Asimismo, las solicitudes que siguen en espera de una respuesta se agregan a la parte superior de la lista antes de que se ordenen como se menciona arriba. Las solicitudes pendientes de respuesta se indican con un icono de flecha abajo.

En la columna Duración se muestra el tiempo que ha tardado una solicitud completa en recibir respuesta del servidor. La columna Estado contiene el código de respuesta recibido mediante la solicitud asociada. La columna Tipo de contenido contiene el formato de datos de la respuesta cuando es aplicable. La columna URL es la URL completa de la solicitud.

Cuando selecciona una solicitud en la sección de solicitudes, en la sección de detalles se introduce la información relevante sobre la solicitud, además de cualquier respuesta recibida. Si se selecciona el botón Parámetros, los parámetros y los valores se mostrarán en sus respectivas columnas. Si se selecciona el botón Respuesta, la ventana Monitor de diagnóstico mostrará la respuesta recibida a la solicitud seleccionada.

Nota:

Solo se muestran los primeros 2048 caracteres de las respuestas registradas. En cualquier respuesta que supere este límite se truncarán los caracteres antes de mostrarse.

Pestaña Registro

La pestaña Registro contiene un visor de registro de eventos y ofrece funciones de ordenación y filtrado. Cuando se ejecuta en Modo de diagnóstico, varios subsistemas dentro de ArcGIS Pro escriben información de diagnóstico como eventos de aplicación en el registro de eventos. El registro de eventos comienza cuando se abre la ventana Monitor de diagnóstico y permanece activo hasta que se cierra ArcGIS Pro.

Pestaña Registro en el Monitor de diagnóstico

Hay cuatro tipos de evento:

  • Error: utilizado para indicar fallos significativos durante una operación
  • Advertencia: menos grave y, en ocasiones, se puede ignorar
  • Información: emitido para proporcionar información contextual adicional acerca de la operación
  • Depuración: información de implementación detallada, principalmente destinada al personal de Esri

Los tipos de evento se pueden filtrar en la lista usando las casillas de verificación correspondientes en la parte superior de la lista. Debido a su importancia, los eventos de error siempre se incluyen en la lista y no se pueden filtrar. La entrada del filtro se puede utilizar para ser más selectiva. Cuando se introduce texto aquí, solo se muestran los eventos en los que al menos una de las columnas contiene ese texto (no se distingue entre minúsculas y mayúsculas).

El número total de eventos de coincidencia se muestra en la parte superior derecha de la pestaña Registro. El registro de eventos se inicia como un proceso en directo. A medida que se registran nuevos eventos, se insertan inmediatamente en la pestaña Registro. Cuando el número total de eventos en el registro alcanza los 100.000 o más, se deshabilita el registro en directo para el resto de la sesión. Se siguen registrando nuevos eventos, pero no aparecen inmediatamente en la pestaña Registro. A la izquierda del recuento total de eventos aparece un botón Refrescar. Al hacer clic en el botón Refrescar se actualiza el contenido de la pestaña Registro. Los eventos que se registraron en segundo plano se agregan cuando se refresca la pestaña.

Archivos de registro

Los archivos de registro se guardan en la carpeta Documentos del usuario, en la subcarpeta ArcGIS\Diagnostics, de forma predeterminada. En el caso de ArcGIS Pro, los archivos de registro tienen el siguiente aspecto ArcGISProLog-16360~89343E4F-74E8-4F26-A705-B805E8C92BB0 y las propiedades siguientes:

  • ArcGISProLog es el nombre de ejecución del host.
  • 16360 es el Id. del proceso.
  • 89343E4F-74E8-4F26-A705-B805E8C92BB0 es el Id. único creado para esa instancia.

Se puede especificar un directorio de salida alternativo en los casos en los que desee guardar los archivos de registro en un directorio distinto de la carpeta Documents. Utilizando el Registro de Windows, cree una clave REG_SZ con el nombre EventLogLocation en Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ESRI\ArcGISPro\Settings\ o Computer\HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Settings\. Establezca el valor de esta clave para que sea el directorio alternativo en el que se guardarán los archivos de registro. La próxima vez que ejecute ArcGIS Pro en Modo de diagnóstico, los archivos de registro se guardarán en <EventLogLocation>\ArcGIS\Diagnostics.

Nota:

Su perfil de usuario de Windows debe tener permisos de lectura y escritura en cualquier directorio especificado como valor EventLogLocation.

Existe un mecanismo de reserva para situaciones en las que ArcGIS Pro no puede guardar los archivos de registro en los directorios especificados como valores EventLogLocation. Si ArcGIS Pro no puede escribir en un directorio EventLogLocation establecido en HKEY_LOCAL_MACHINE, en su lugar intentará escribir los archivos de registro en el valor EventLogLocation establecido en HKEY_CURRENT_USER. Si no se especifica ninguno de estos directorios o no se puede escribir en ellos, los archivos de registro se guardarán en la carpeta Documents\ArcGIS\Diagnostics predeterminada.

Nota:

Si existe una clave de registro EventLogLocation válida tanto en HKEY_LOCAL_MACHINE como en HKEY_CURRENT_USER, el valor de HKEY_LOCAL_MACHINE tendrá prioridad.

Pestaña Propiedades de diagnóstico

La pestaña Propiedades de diagnóstico incluye información de diagnóstico que se introduce en los informes de error para que la revise el personal de Esri.

Pestaña Propiedades de diagnóstico en Monitor de diagnóstico

Los valores de Nombre indican lo siguiente:

  • per_user_install: parámetro que determina si la instalación de ArcGIS Pro en la que se ejecuta Monitor de diagnóstico se ha instalado por usuario o por equipo.

    ValorDefinición

    no

    La instalación de ArcGIS Pro se ha realizado para todos los usuarios del equipo.

    La instalación de ArcGIS Pro solo se ha realizado para el usuario que ha iniciado sesión.

  • cmd_line: los argumentos de la línea de comando seguidos por Windows cuando se abre ArcGIS Pro.
  • client_proto: muestra el tipo de equipo en que se está usando ArcGIS Pro. Los valores son los siguientes:

    ValorDefinición

    0

    ArcGIS Pro se ejecuta de forma nativa en el equipo.

    1

    ArcGIS Pro se ejecuta en una máquina virtual (VM).

    2

    ArcGIS Pro se ejecuta en un equipo al que se accede mediante el Protocolo de escritorio remoto (RDP) de Windows.

  • secondary-instance: parámetro que determinar si la aplicación ArcGIS Pro es la única instancia de la aplicación que está funcionando en este momento.

    ValorDefinición

    no

    En la actualidad solo hay una instancia de ArcGIS Pro en ejecución.

    En la actualidad hay varias instancias de ArcGIS Pro en ejecución.

  • Última vista activa: última vista de la aplicación que estaba activa antes de ver esta pestaña en la ventana Monitor de diagnóstico. Los valores pueden incluir cualquier vista válida, como la vista de mapa o de diseño. En el ejemplo anterior, esri_mapping_mapPane se refiere a la vista de mapa.
  • Último comando: último botón de la interfaz de usuario en el que ha hecho clic el usuario. En el ejemplo anterior, esri_mapping_colorVisionSimulatorButton se refiere al botón Simulador de deficiencia por ceguera a los colores.
  • Último panel acoplable activo: último panel de la aplicación que estaba activo antes de ver esta pestaña en la ventana Monitor de diagnóstico. Los valores pueden incluir cualquier panel válido, como Contenido o Catálogo. En el ejemplo anterior, esri_core_contentsDockPane se refiere al panel Contenido.

Pestaña Estados

La pestaña Estados permite ver todos los estados habilitados de la aplicación y los estados activos de la vista asociados a la sesión correspondiente de ArcGIS Pro en un momento dado, con las nuevas incorporaciones insertadas en sus columnas correspondientes como entradas en negrita.

Pestaña Estados del Monitor de diagnóstico

Tanto los estados de aplicación como los estados de vista activa pertenecen a un mecanismo que el marco de ArcGIS Pro utiliza para expresar cuándo varios elementos de la interfaz de usuario —por ejemplo, pestañas, botones y herramientas— deben y no deben estar visibles o activados en ArcGIS Pro para presentar una interfaz de usuario despejada y adaptada a la tarea que se está realizando.

Esta funcionalidad del Monitor de diagnóstico es particularmente útil para los desarrolladores de complementos de ArcGIS Pro que desean confirmar que sus estados definidos se activan cuando deben y cuando no deben.

Obtenga más información sobre las condiciones y estados.

Superposición de rendimiento de dibujo

Puede activar la superposición de resolución de problemas que ofrece estadísticas de dibujo desde el cuadro de diálogo Accesos directos de tecladohaciendo clic en Global > Superposición de rendimiento de dibujo. Al pulsar la tecla de acceso directo designada, la superposición se activa y desactiva.

Resolución de problemas de rendimiento

Para obtener sugerencias sobre la configuración de ArcGIS Pro para mejorar el rendimiento, consulte Solución de problemas de rendimiento en ArcGIS Pro en Comunidad de Esri.