Cargar Símbolos
Puedes establecer las siguientes preferencias de usuario en Windows Analizador de rendimiento (WPA):
Cargar símbolos
Configurar rutas de acceso de símbolos
Para cambiar estas opciones, abra una grabación y seleccione la opción en el menú Seguimiento .
Símbolos administrados
Las resoluciones y pilas de símbolos para los procesos administrados se admiten en los siguientes sistemas:
Con .NET Framework 4.5 o una versión posterior en Windows 8 o posterior
Con .NET Framework 4.0 o una versión posterior en máquinas x86
Al capturar un seguimiento mediante WPR, WPR permite que todos los proveedores necesarios resuelvan los símbolos administrados en el seguimiento. WPR crea una carpeta junto al seguimiento guardado que contiene archivos PDB de estos símbolos administrados. Cuando WPA abre el seguimiento, WPA busca esta carpeta y la agrega automáticamente a la ruta de acceso del símbolo. Si WPR no se usó para generar el seguimiento, es posible que los símbolos de los programas de .NET Framework no descodifiquen completamente ni descodifiquen en absoluto.
Símbolos de JavaScript
La resolución de símbolos y las pilas para los procesos de JavaScript se admiten en sistemas que ejecutan el software siguiente:
Windows 7 junto con Internet Explorer 10 o una versión posterior
Aplicaciones que usan JavaScript en Windows 8
WP permite a los proveedores necesarios descodificar símbolos para código JavaScript en sistemas compatibles. Las direcciones del método javaScript y los marcos de pila descodificarán en un nombre de archivo javaScript, nombre del método, número de línea y número de columna.
Rutas de acceso relativas y variables de entorno insertadas
Las variables de entorno _NT_SYMBOL_PATH y _NT_SYMCACHE_PATH pueden usar rutas de acceso relativas, rutas de acceso absolutas, rutas de acceso de recurso compartido de red o variables de entorno insertadas. WPA convierte rutas de acceso relativas a rutas de acceso absolutas cuando se establecen por primera vez las rutas de acceso relativas. WPA convierte rutas de acceso relativas que WPA carga desde variables de entorno cuando se inicia el programa.
WPA convierte rutas de acceso relativas que escriba en el cuadro de diálogo Configurar rutas de acceso de símbolos al cerrar el cuadro de diálogo. Los cambios en el directorio actual no afectan a las rutas de acceso relativas que ya ha establecido. En el cuadro de diálogo Configurar rutas de acceso de símbolos se muestran las rutas de acceso establecidas actualmente al abrir por primera vez el cuadro de diálogo para que pueda ver la forma en que WPA expandió cualquier ruta de acceso relativa.
WPA expande variables de entorno incrustadas al mismo tiempo que expande rutas de acceso relativas. Dado que WPA captura variables de entorno cuando se inicia el programa, los cambios en las variables de entorno que están fuera de una instancia en ejecución actualmente de WPA no aparecen en esa instancia.
Es posible que otros programas que usen la variable de entorno _NT_SYMCACHE_PATH , como WinDbg o Microsoft Visual Studio, no controle las rutas de acceso relativas ni las variables de entorno insertadas de la misma manera.
Ruta de acceso symCache
WPA usa archivos SymCache para almacenar en caché información de símbolos de archivos de base de datos de programa (PDB) de forma compacta y fácil de acceder. Después de que WPA rellena una carpeta SymCache con los símbolos de un seguimiento, volver a cargar los símbolos para ese seguimiento es mucho más rápido. Si un archivo SymCache se vuelve demasiado grande o ya no es necesario, puede eliminar de forma segura ese archivo SymCache. WPA vuelve a rellenar la carpeta SymCache con nuevos archivos según sea necesario. También puede copiar archivos SymCache en otro equipo o compartir los archivos a través de una red para acelerar la carga de símbolos en diferentes equipos.
Si usa el cuadro de diálogo Configurar rutas de acceso de símbolos para establecer la variable de entorno _NT_SYMCACHE_PATH en una carpeta a la que WPA no puede tener acceso, el botón Aceptar no cierra el cuadro de diálogo. Sin embargo, no recibe un mensaje de error.
Si la variable de entorno _NT_SYMCACHE_PATH está sin asignar o vacía, WPA crea una carpeta SymCache en la raíz de la unidad que contiene el archivo ejecutable WPA. Si la variable de entorno _NT_SYMCACHE_PATH se ejecuta en un recurso compartido de red, la variable crea una carpeta SymCache en la raíz de la unidad que contiene la carpeta Archivos de programa. Esta suele ser la unidad C.
Ejemplos de SymCache
El siguiente comando coloca el archivo SymCache en la carpeta C:\SymCache :
C:\SymCache
El comando siguiente coloca el archivo SymCache en la carpeta C:\SymCache, busca en la carpeta \\network\SymCache símbolos y, a continuación, procesa la variable de entorno _NT_SYMBOL_PATH :
C:\SymCache*\\network\SymCache
En este ejemplo se copian los símbolos que el ejemplo encuentra en la carpeta \\network\SymCache en la carpeta C:\SymCache . Esto permite al usuario crear una carpeta SymCache grande y, a continuación, copiar solo los archivos que el usuario necesita para un seguimiento específico en la carpeta designada.
Para buscar varias carpetas SymCache alternativas, anexe las carpetas a la ruta de acceso de búsqueda mediante un separador asterisco (*) . Cuando WPA encuentra un archivo SymCache en una de las ubicaciones alternativas, WPA copia el archivo solo en la primera carpeta SymCache de la ruta de acceso. WPA también coloca los archivos SymCache recién creados en la primera carpeta SymCache de la ruta de acceso.
Para deshabilitar la copia y escritura, pero seguir usando la característica de búsqueda jerárquica, debe dejar la primera posición en la ruta de acceso vacía, como se muestra en el ejemplo siguiente:
*\\network\SymCache
Al emitir este comando, WPA busca en la carpeta \\network\SymCache . Sin embargo, WPA no copia los resultados ni escribe los archivos SymCache generados en otra carpeta.
Ruta de acceso del símbolo
Para obtener información básica sobre la variable de entorno de _NT_SYMBOL_PATH , consulte los siguientes artículos de MSDN:
La carga de símbolos en WPA depende de las rutas de acceso que especifica la variable de entorno _NT_SYMBOL_PATH (excepto los símbolos que WPA ya ha almacenado en caché en la carpeta SymCache). WPA busca las rutas de acceso secuencialmente, empezando por la izquierda. Sin embargo, cargar símbolos desde un archivo PDB en una de estas rutas de acceso puede llevar mucho tiempo, especialmente si la PDB existe en un equipo remoto. Por lo tanto, se recomienda colocar rutas de acceso de red después de cualquier ruta de acceso local y usar una caché de PDB local para cualquier servidor de símbolos remoto. Sin embargo, aunque todos los símbolos se almacenen localmente, WPA puede dejar de responder durante el tiempo en que carga símbolos. WPA vuelve a un estado interactivo después de que termine de cargar símbolos.
Cuando no se establece la variable de entorno _NT_SYMBOL_PATH , WPA usa el siguiente valor predeterminado:
.;SRV*\Symbols*https://msdl.microsoft.com/download/symbols;
Punto y coma (;) separe las distintas rutas de acceso. La primera ruta de acceso es el punto (.). WPA asigna esta ruta de acceso a la carpeta actual cuando WPA carga el seguimiento. Consulta la sección Ruta de acceso de SymCache de este artículo para obtener más información sobre la forma en que WPA procesa rutas de acceso relativas.
La segunda ruta de acceso es la siguiente:
SRV*\Symbols*https://msdl.microsoft.com/download/symbols
También debe establecer la ruta de acceso de PB de NGEN:
set _NT_SYMBOL_PATH=srv*C:\Symbols.NGEN;srv*https://msdl.microsoft.com/download/symbols
Al especificar esta ruta de acceso, WPA descarga símbolos del servidor de símbolos públicos de Microsoft y almacena en caché los archivos PDB en la carpeta \Symbols (esta carpeta es relativa a la carpeta de instalación de Windows Performance Toolkit). Por lo tanto, WPA coloca la carpeta Símbolos junto a la carpeta SymCache. Sin embargo, si la carpeta SymCache está en un recurso compartido de red, WPA crea la carpeta Símbolos en la raíz de la unidad que contiene la carpeta Archivos de programa. Esta suele ser la unidad C.
Si no desea buscar y cargar símbolos desde archivos PDB, puede establecer la variable de entorno _NT_SYMBOL_PATH en una carpeta local que no contenga símbolos, como un punto (.). No deje vacía la variable de entorno _NT_SYMBOL_PATH . Si deja vacía la variable de entorno _NT_SYMBOL_PATH , WPA usa el valor predeterminado.
Cuando WPA abre una grabación, WPA busca una carpeta que tenga el mismo nombre que el seguimiento que usa la extensión .ngenpdb . Si WPA encuentra esta carpeta, WPA anexa la carpeta al final de la variable de entorno _NT_SYMBOL_PATH . Windows Performance Recorder (WPR) crea automáticamente una carpeta que contiene archivos PDB para código administrado que WPR capturó durante la grabación. Por ejemplo, si abre la grabación C:\trace.etl en WPA, WPA busca la carpeta C:\trace.etl.ngenpdb . Si esta carpeta existe, WPA agrega la carpeta a la variable de entorno _NT_SYMBOL_PATH .
Temas relacionados
Cargar símbolos o configurar rutas de acceso de símbolos