Solución de problemas de ASP.NET Core en Azure App Service e IIS

En este artículo se proporciona información sobre los errores comunes de inicio de la aplicación e instrucciones sobre cómo diagnosticar errores cuando una aplicación se implementa en Azure App Service o IIS:

Errores de inicio de aplicación
Se explican escenarios comunes de los códigos de estado HTTP de inicio.

Solución de problemas en Azure App Service
Se proporcionan consejos para solucionar problemas de las aplicaciones implementadas en Azure App Service.

Solución de problemas de IIS
Se proporcionan consejos para solucionar problemas de las aplicaciones implementadas en IIS o que se ejecutan en IIS Express de forma local. La guía se aplica a las implementaciones de Windows Server y escritorio de Windows.

Borrado de memorias caché de paquetes
Se explica qué hacer cuando hay paquetes incoherentes que interrumpen una aplicación al realizar actualizaciones importantes o cambiar las versiones de los paquetes.

Recursos adicionales
Se incluyen temas adicionales de solución de problemas.

Errores de inicio de aplicación

En Visual Studio, el servidor predeterminado del proyecto de ASP.NET Core es Kestrel. Visual Studio se puede configurar para usar IIS Express. El código de estado 502.5 - Error de proceso o 500.30 - Error de inicio que se produce al efectuar la depuración localmente con IIS Express se puede diagnosticar si se sigue el consejo de este tema.

403.14 Prohibido

No se puede iniciar la aplicación. Se registra el siguiente error:

The Web server is configured to not list the contents of this directory.

El error se suele deber a una implementación interrumpida en el sistema de hospedaje, que incluye cualquiera de los siguientes escenarios:

• La aplicación se implementa en la carpeta incorrecta en el sistema de hospedaje.
• El proceso de implementación no pudo trasladar todos los archivos y las carpetas de la aplicación a la carpeta de implementación en el sistema de hospedaje.
• Falta el archivo web.config en la implementación o el contenido del archivo web.config no tiene un formato correcto.

Lleve a cabo los siguiente pasos:

1. Elimine todos los archivos y las carpetas de la carpeta de implementación en el sistema de hospedaje.
2. Vuelva a implementar el contenido de la carpeta publish de la aplicación en el sistema de hospedaje con un método normal de implementación, como Visual Studio, PowerShell o la implementación manual:
   • Confirme que el archivo web.config está en la implementación y que su contenido es correcto.
   • Cuando hospede contenido en Azure App Service, confirme que la aplicación se implementa en la carpeta D:\home\site\wwwroot.
   • Si IIS hospeda la aplicación, confirme que la aplicación se implementa en la ruta de acceso física de IIS que se muestra en la configuración básica del administrador de IIS.
3. Confirme que todos los archivos y las carpetas de la aplicación se han implementado; para ello, compare la implementación en el sistema de hospedaje con el contenido de la carpeta publish del proyecto.

Para más información sobre el diseño de una aplicación ASP.NET Core publicada, vea Estructura de directorios de ASP.NET Core. Para más información sobre el archivo web.config, vea Módulo ASP.NET Core (ANCM) para IIS.

500 Error interno del servidor

La aplicación se inicia, pero un error impide que el servidor complete la solicitud.

Este error se produce dentro del código de la aplicación durante el inicio o mientras se crea una respuesta. La respuesta no puede contener nada o puede aparecer como 500 Error interno del servidor en el explorador. El registro de eventos de la aplicación normalmente indica que la aplicación se ha iniciado normalmente. Desde la perspectiva del servidor, eso es correcto. La aplicación se inició, pero no puede generar una respuesta válida. Ejecute la aplicación en un símbolo del sistema en el servidor o habilite el registro de stdout del módulo ASP.NET Core para solucionar el problema.

Este error también puede producirse cuando el conjunto de hospedaje de .NET Core no está instalado o está dañado. La instalación o reparación de la instalación del conjunto de hospedaje de .NET Core (para IIS) o Visual Studio (para IIS Express) puede corregir el problema.

500.0 Error de carga del controlador en proceso

El proceso de trabajo no funciona. La aplicación no se inicia.

Error desconocido al cargar los componentes del módulo ASP.NET Core. Realice una de las siguientes acciones:

• Póngase en contacto con el equipo de soporte técnico de Microsoft (seleccione Herramientas de desarrollo y, después, ASP.NET Core).
• Formule una pregunta en Stack Overflow.
• Registre un problema en nuestro repositorio de GitHub.

500.30 Error de inicio en proceso

El proceso de trabajo no funciona. La aplicación no se inicia.

El módulo ASP.NET Core intenta iniciar el proceso CLR de .NET Core, pero no lo consigue. La causa del error de inicio del proceso se suele determinar a partir de las entradas del registro de eventos de la aplicación y del registro de stdout del módulo ASP.NET Core.

Condiciones de error habituales:

• La aplicación está mal configurada porque tiene como destino una versión del marco compartido de ASP.NET Core que no está presente. Compruebe qué versiones del marco compartido de ASP.NET Core están instaladas en el equipo de destino.
• Al usar Azure Key Vault, faltan permisos de la instancia de Key Vault. Compruebe las directivas de acceso de la instancia de Key Vault de destino para asegurarse de que se concedan los permisos correctos.

500.31 ANMC no pudo encontrar las dependencias nativas

El proceso de trabajo no funciona. La aplicación no se inicia.

El módulo ASP.NET Core intenta iniciar el proceso del entorno de ejecución de .NET Core, pero no lo consigue. Este error de inicio suele deberse a que el entorno de ejecución de Microsoft.NETCore.App o Microsoft.AspNetCore.App no está instalado. Si la aplicación se implementa para ASP.NET Core 3.0 y esa versión no existe en el equipo, se produce este error. Este es un mensaje de error de ejemplo:

The specified framework 'Microsoft.NETCore.App', version '3.0.0' was not found.
  - The following frameworks were found:
      2.2.1 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview5-27626-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview6-27713-13 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview6-27714-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview6-27723-08 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]

El mensaje de error enumera todas las versiones instaladas de .NET Core y la versión solicitada por la aplicación. Para corregir este error, hay dos posibilidades:

• Instalar la versión adecuada de .NET Core en la máquina.
• Cambiar el destino de la aplicación a una versión de .NET Core que exista en la máquina.
• Publique la aplicación como una implementación independiente.

Cuando se ejecuta en desarrollo (la variable de entorno ASPNETCORE_ENVIRONMENT se establece en Development), el error específico se escribe en la respuesta HTTP. La causa de un error de inicio de proceso también se encuentra en el registro de eventos de la aplicación.

500.32 ANCM No se pudo cargar el archivo .dll

El proceso de trabajo no funciona. La aplicación no se inicia.

La causa más común de este error es que la aplicación se haya publicado para una arquitectura de procesador no compatible. Si el proceso de trabajo se ejecuta como una aplicación de 32 bits y la aplicación se diseñó para 64 bits, se produce este error.

Para corregir este error, hay dos posibilidades:

• Volver a publicar la aplicación para la misma arquitectura de procesador que el proceso de trabajo.
• Publicar la aplicación como una implementación dependiente del marco.

500.33 Error de carga del controlador de solicitud

El proceso de trabajo no funciona. La aplicación no se inicia.

La aplicación no hizo referencia al marco Microsoft.AspNetCore.App. Solo las aplicaciones diseñadas para el marco Microsoft.AspNetCore.App pueden hospedarse en el módulo ASP.NET Core.

Para corregir este error, confirme que la aplicación tiene como destino el marco Microsoft.AspNetCore.App. Compruebe en .runtimeconfig.json cuál es el marco de destino de la aplicación.

500.34 ANCM Modelos de hospedaje mixto no admitidos

El proceso de trabajo no puede ejecutar a la vez una aplicación en proceso y una aplicación fuera de proceso.

Para corregir este error, ejecute las aplicaciones en grupos de aplicaciones de IIS independientes.

500.35 ANCM Varias aplicaciones en proceso en el mismo proceso

El proceso de trabajo no puede ejecutar varias aplicaciones en proceso en el mismo proceso.

Para corregir este error, ejecute las aplicaciones en grupos de aplicaciones de IIS independientes.

500.36 Error de carga del controlador fuera de proceso

El controlador de solicitudes de fuera de proceso, aspnetcorev2_outofprocess.dll, no está junto al archivo aspnetcorev2.dll. Esto indica una instalación dañada del módulo ASP.NET Core.

Para corregir este error, repare la instalación del conjunto de hospedaje de .NET Core (para IIS) o Visual Studio (para IIS Express).

500.37 ANCM no se pudo iniciar en el límite de tiempo de inicio

ANCM no se pudo iniciar dentro del límite de tiempo de inicio proporcionado. De forma predeterminada, el tiempo de espera es de 120 segundos.

Este error puede producirse cuando se inicia un gran número de aplicaciones en el mismo equipo. Busque picos de uso de CPU o memoria en el servidor durante el inicio. Es posible que deba escalonar el proceso de inicio de varias aplicaciones.

500.38 No se encontró el archivo DLL de la aplicación ANCM

ANCM no pudo encontrar el archivo DLL de la aplicación, que debe estar junto al archivo ejecutable.

Este error se produce al hospedar una aplicación empaquetada como ejecutable de un solo archivo mediante el modelo de hospedaje In-Process. El modelo In-Process requiere que ANCM cargue la aplicación .NET Core en el proceso de IIS existente. Este escenario no es compatible con el modelo de implementación de un archivo único. Use uno de los enfoques siguientes en el archivo del proyecto de la aplicación para corregir este error:

1. Deshabilite la publicación de un archivo único; para ello, establezca la propiedad PublishSingleFile de MSBuild en false.
2. Cambie al modelo de hospedaje fuera de proceso estableciendo la propiedad AspNetCoreHostingModel de MSBuild en OutOfProcess.

502.5 Error de proceso

El proceso de trabajo no funciona. La aplicación no se inicia.

El módulo ASP.NET Core intenta iniciar el proceso de trabajo, pero no lo consigue. La causa del error de inicio del proceso se suele determinar a partir de las entradas del registro de eventos de la aplicación y del registro de stdout del módulo ASP.NET Core.

Una condición de error habitual es que la aplicación esté mal configurada porque tiene como destino una versión del marco compartido de ASP.NET Core que no está presente. Compruebe qué versiones del marco compartido de ASP.NET Core están instaladas en el equipo de destino. El marco de trabajo compartido es el conjunto de ensamblados (archivos .dll) que se instalan en la máquina, y se hace referencia a ellos mediante un metapaquete como Microsoft.AspNetCore.App. La referencia del metapaquete puede especificar una versión mínima necesaria. Para más información, consulte este artículo sobre el marco de trabajo compartido.

La página de error 502.5 Error de proceso se devuelve cuando el proceso de trabajo no se puede iniciar debido a un error de configuración de la aplicación o del hospedaje:

No se pudo iniciar la aplicación (código de error "0x800700c1")

EventID: 1010
Source: IIS AspNetCore Module V2
Failed to start application '/LM/W3SVC/6/ROOT/', ErrorCode '0x800700c1'.

Error al iniciar la aplicación porque el ensamblado de la aplicación ( .dll) no se ha podido cargar.

Este error se produce cuando hay un error de coincidencia del valor de bits entre la aplicación publicada y el proceso w3wp/iisexpress.

Confirme que la opción de 32 bits del grupo de aplicaciones sea correcta:

1. Seleccione el grupo de aplicaciones en Grupos de aplicaciones del Administrador de IIS.
2. Seleccione Configuración avanzada en Modificar grupo de aplicaciones, en el panel Acciones.
3. Establezca Habilitar aplicaciones de 32 bits:
   • Si implementa una aplicación de 32 bits (x86), establezca el valor en True.
   • Si implementa una aplicación de 64 bits (x64), establezca el valor en False.

Confirme que no hay ningún conflicto entre una propiedad <Platform> de MSBuild en el archivo del proyecto y el valor de bits publicado de la aplicación.

Error al iniciar la aplicación (código de error "0x800701b1")

EventID: 1010
Source: IIS AspNetCore Module V2
Failed to start application '/LM/W3SVC/3/ROOT', ErrorCode '0x800701b1'.

Error al iniciar la aplicación porque no se pudo cargar un servicio de Windows.

Un servicio común que debe habilitarse es el servicio "null". El siguiente comando habilita el servicio de Windows null:

sc.exe start null

Restablecimiento de la conexión

Si se produce un error después de que se envían los encabezados, el servidor no tiene tiempo para enviar un mensaje 500 Error interno del servidor cuando se produce un error. Esto suele ocurrir cuando se produce un error durante la serialización de objetos complejos en una respuesta. Este tipo de error aparece como un error de restablecimiento de la conexión en el cliente. El Registro de aplicaciones puede ayudar a solucionar estos tipos de errores.

Límites de inicio predeterminados

El módulo ASP.NET Core está configurado con un valor predeterminado de startupTimeLimit de 120 segundos. Cuando se deja en el valor predeterminado, una aplicación puede tardar hasta dos minutos en iniciarse antes de que el módulo registre un error de proceso. Para información sobre la configuración del módulo, consulte Atributos del elemento aspNetCore.

Solución de problemas en Azure App Service

Importante

Versiones preliminares de ASP.NET Core con Azure App Service

Las versiones preliminares de ASP.NET Core no se implementan de forma predeterminada en Azure App Service. Para hospedar una aplicación que usa una versión preliminar de ASP.NET Core, vea Implementar una versión preliminar de ASP.NET Core en Azure App Service.

Transmisión de registro de Azure App Services

El registro de Azure App Services transmite información de registro a medida que se produce. Para ver registros de emisión:

1. En Azure Portal, abra la aplicación en App Services.
2. En el panel izquierdo, vaya a Supervisión>Registros de App Service.
3. Seleccione Sistema de archivos para Registro del servidor web. Opcionalmente, habilite Registro de la aplicación.
4. En el panel izquierdo, vaya a Supervisión>Secuencia de registroy, después, seleccione Registros de aplicación o Registros de servidor web.

En las imágenes siguientes se muestra la producción de los registros de aplicaciones:

Los Registros de streaming tienen cierta latencia y es posible que no se muestren de inmediato.

Registro de eventos de la aplicación (Azure App Service)

Para acceder al registro de eventos de la aplicación, use la hoja Diagnose and solve problems (Diagnosticar y solucionar problemas) de Azure Portal:

1. En Azure Portal, abra la aplicación en App Services.
2. Seleccione Diagnosticar y solucionar problemas.
3. Seleccione el título Herramientas de diagnóstico.
4. En Herramientas de soporte técnico, seleccione el botón Eventos de la aplicación.
5. Examine el error más reciente que hayan proporcionado las entradas IIS AspNetCoreModule o IIS AspNetCoreModule V2 en la columna Origen.

Una alternativa al uso de la hoja Diagnose and solve problems (Diagnosticar y resolver problemas) es examinar el archivo de registro de eventos de la aplicación directamente mediante Kudu:

1. Abra Herramientas avanzadas en el área Herramientas de desarrollo. Seleccione el botón Ir→. Se abre la consola de Kudu en una nueva pestaña o ventana del explorador.
2. Mediante la barra de navegación de la parte superior de la página, abra la consola de depuración y seleccione CMD.
3. Abra la carpeta LogFiles.
4. Seleccione el icono de lápiz junto al archivo eventlog.xml.
5. Examine el registro. Desplácese al final del registro para ver los eventos más recientes.

Ejecución de la aplicación en la consola de Kudu

Muchos errores de inicio no generan información útil en el registro de eventos de la aplicación. Puede ejecutar la aplicación en la consola de ejecución remota de Kudu para detectar el error:

1. Abra Herramientas avanzadas en el área Herramientas de desarrollo. Seleccione el botón Ir→. Se abre la consola de Kudu en una nueva pestaña o ventana del explorador.
2. Mediante la barra de navegación de la parte superior de la página, abra la consola de depuración y seleccione CMD.

Prueba de una aplicación de 32 bits (x86)

Versión actual

1. cd d:\home\site\wwwroot
2. Ejecute la aplicación:

   • Si la aplicación es una implementación dependiente del marco:

     dotnet .\{ASSEMBLY NAME}.dll
     

   • Si la aplicación es una implementación independiente:

     {ASSEMBLY NAME}.exe
     

La salida de consola de la aplicación, que muestra los posibles errores, se canaliza a la consola de Kudu.

Implementación dependiente del marco en ejecución en una versión preliminar

Requiere la instalación de la extensión de sitio ASP.NET Core {VERSION} (x86) Runtime.

1. cd D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.x32 ({X.Y} es la versión del runtime)
2. Ejecute la aplicación: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dll

La salida de consola de la aplicación, que muestra los posibles errores, se canaliza a la consola de Kudu.

Prueba de una aplicación de 64 bits (x64)

Versión actual

• Si la aplicación es una implementación dependiente del marco de 64 bits (x64):
  1. cd D:\Program Files\dotnet
  2. Ejecute la aplicación: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dll
• Si la aplicación es una implementación independiente:
  1. cd D:\home\site\wwwroot
  2. Ejecute la aplicación: {ASSEMBLY NAME}.exe

La salida de consola de la aplicación, que muestra los posibles errores, se canaliza a la consola de Kudu.

Implementación dependiente del marco en ejecución en una versión preliminar

Requiere la instalación de la extensión de sitio ASP.NET Core {VERSION} (x64) Runtime.

1. cd D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.x64 ({X.Y} es la versión del runtime)
2. Ejecute la aplicación: dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dll

La salida de consola de la aplicación, que muestra los posibles errores, se canaliza a la consola de Kudu.

Registro de stdout del módulo ASP.NET Core (Azure App Service)

Advertencia

La imposibilidad de deshabilitar el registro de stdout puede dar lugar a un error de la aplicación o del servidor. No hay ningún límite en el tamaño del archivo de registro ni en el número de archivos de registro creados. Use únicamente el registro de stdout para solucionar problemas de inicio de la aplicación.

Para el registro general en una aplicación ASP.NET Core, use una biblioteca de registro que limite el tamaño del archivo de registro y realice la rotación de los registros. Para más información, consulte los proveedores de registro de terceros.

El registro stdout del módulo ASP.NET Core con frecuencia registra mensajes de error útiles que no se encuentran en el registro de eventos de la aplicación. Para habilitar y ver los registros de stdout:

1. En Azure Portal, vaya a la aplicación web.
2. En la hoja App Service, escriba kudu en el cuadro de búsqueda.
3. Seleccione Herramientas avanzadas>Ir.
4. Seleccione Consola de depuración > CMD.
5. Vaya a site/wwwroot.
6. Seleccione el icono de lápiz para editar el archivo web.config.
7. En el elemento <aspNetCore />, establezca stdoutLogEnabled="true" y seleccione Guardar.

Establezca stdoutLogEnabled="false" para deshabilitar el registro de stdout una vez que haya solucionado los problemas.

Para obtener más información vea Módulo de ASP.NET Core (ANCM) para IIS.

Registro de depuración del módulo ASP.NET Core (Azure App Service)

El registro de depuración del módulo de ASP.NET Core ofrece un registro adicional, más profundo, del módulo ASP.NET Core. Para habilitar y ver los registros de stdout:

1. Para habilitar el registro de diagnóstico mejorado, realice cualquiera de las acciones siguientes:
   • Siga las instrucciones de Registros de diagnóstico mejorados para configurar la aplicación para un registro de diagnóstico mejorado. Vuelva a implementar la aplicación.
   • Agregue la <handlerSettings> que se muestra en Registros de diagnóstico mejorados al archivo web.config de la aplicación activa mediante la consola de Kudu:
     1. Abra Herramientas avanzadas en el área Herramientas de desarrollo. Seleccione el botón Ir→. Se abre la consola de Kudu en una nueva pestaña o ventana del explorador.
     2. Mediante la barra de navegación de la parte superior de la página, abra la consola de depuración y seleccione CMD.
     3. Abra las carpetas para la ruta de acceso site>wwwroot. Seleccione el icono de lápiz para editar el archivo web.config. Agregue la sección <handlerSettings> como se muestra en Registros de diagnóstico mejorados. Seleccione el botón Guardar.
2. Abra Herramientas avanzadas en el área Herramientas de desarrollo. Seleccione el botón Ir→. Se abre la consola de Kudu en una nueva pestaña o ventana del explorador.
3. Mediante la barra de navegación de la parte superior de la página, abra la consola de depuración y seleccione CMD.
4. Abra las carpetas para la ruta de acceso site>wwwroot. Si no ha proporcionado una ruta de acceso para el archivo aspnetcore debug.log, el archivo aparece en la lista. Si ha proporcionado una ruta de acceso, vaya a la ubicación del archivo de registro.
5. Abra el archivo de registro con el botón de lápiz situado junto al nombre del archivo.

Deshabilite el registro de depuración una vez haya solucionado los problemas:

Para deshabilitar el registro de depuración mejorado, realice cualquiera de las acciones siguientes:

• Quite localmente la <handlerSettings> del archivo web.config y vuelva a implementar la aplicación.
• Use la consola de Kudu para editar el archivo web.config y quite la sección <handlerSettings>. Guarde el archivo.

Para más información, vea Creación y redireccionamiento de registros con el módulo de ASP.NET Core.

Advertencia

Si no deshabilita el registro de depuración, es posible que se produzcan errores en la aplicación o el servidor. No hay ningún límite para el tamaño del archivo de registro. Use únicamente el registro de depuración para solucionar problemas de inicio de la aplicación.

Para el registro general en una aplicación ASP.NET Core, use una biblioteca de registro que limite el tamaño del archivo de registro y realice la rotación de los registros. Para más información, consulte los proveedores de registro de terceros.

Aplicación lenta o que no responde (Azure App Service)

Cuando una aplicación responda con lentitud o no responda a una solicitud, consulta Solución de problemas de rendimiento de aplicaciones web lentas en Azure App Service.

Hojas de supervisión

Las hojas de supervisión proporcionan una alternativa a la experiencia de solución de problemas de los métodos descritos anteriormente en el tema. Estas hojas se pueden usar para diagnosticar errores de la serie 500.

Confirme que están instaladas las extensiones de ASP.NET Core. Si no lo están, instálelas manualmente:

1. En la sección de la hoja HERRAMIENTAS DE DESARROLLO, seleccione la hoja Extensiones.
2. Aparecerán en la lista las extensiones de ASP.NET Core.
3. Si las extensiones no están instaladas, seleccione el botón Add (Agregar).
4. Elija las extensiones de ASP.NET Core de la lista.
5. Seleccione Aceptar para aceptar los términos legales.
6. Seleccione Aceptar en la hoja Agregar extensión.
7. Un mensaje emergente informativo indica si las extensiones se han instalado correctamente.

Si el registro de stdout no está habilitado, siga estos pasos:

1. En Azure Portal, seleccione la hoja Herramientas avanzadas en el área HERRAMIENTAS DE DESARROLLO. Seleccione el botón Ir→. Se abre la consola de Kudu en una nueva pestaña o ventana del explorador.
2. Mediante la barra de navegación de la parte superior de la página, abra la consola de depuración y seleccione CMD.
3. Abra las carpetas a la ruta de acceso sitio>wwwroot y desplácese hacia abajo para mostrar el archivo web.config en la parte inferior de la lista.
4. Haga clic en el icono de lápiz junto al archivo web.config.
5. Establezca stdoutLogEnabled en true y cambie la ruta de acceso de stdoutLogFile a: \\?\%home%\LogFiles\stdout.
6. Seleccione Save (Guardar) para guardar el archivo web.config actualizado.

Continúe para activar el registro de diagnóstico:

1. En Azure Portal, seleccione la hoja Registros de diagnóstico.
2. Seleccione el conmutador Activado en Registro de la aplicación (sistema de archivos) y Mensajes de error detallados. Seleccione el botón Guardar en la parte superior de la hoja.
3. Para incluir el seguimiento de solicitudes con error, también conocido como almacenamiento en búfer de eventos de solicitudes con error (FREB), seleccione el conmutador Activado en Seguimiento de solicitudes con error.
4. Seleccione la hoja Secuencia de registro, que aparece inmediatamente bajo la hoja Registros de diagnóstico en el portal.
5. Realice una solicitud a la aplicación.
6. Dentro de los datos de la secuencia de registro, se indica la causa del error.

No olvide deshabilitar el registro de stdout cuando finalice la solución de problemas.

Para ver los registros de seguimiento de solicitudes con error (registros FREB):

1. Vaya a la hoja Diagnose and solve problems (Diagnosticar y resolver problemas) de Azure Portal.
2. Seleccione Failed Request Tracing Logs (Registros de seguimiento de solicitudes con error) en el área SUPPORT TOOLS (HERRAMIENTAS DE SOPORTE TÉCNICO) de la barra lateral.

Para más información, consulte la sección sobre los seguimientos de solicitudes con error del tema Habilitación del registro de diagnóstico para aplicaciones web en Azure App Service y el artículo Preguntas más frecuentes sobre el rendimiento de aplicaciones para Web Apps de Azure: ¿Cómo se activa el seguimiento de solicitudes con error?.

Para más información, consulte Habilitación del registro de diagnóstico para aplicaciones web en Azure App Service.

Advertencia

La imposibilidad de deshabilitar el registro de stdout puede dar lugar a un error de la aplicación o del servidor. No hay ningún límite en el tamaño del archivo de registro ni en el número de archivos de registro creados.

Para el registro rutinario en una aplicación ASP.NET Core, use una biblioteca de registro que limite el tamaño del archivo de registro y realice la rotación de los registros. Para más información, consulte los proveedores de registro de terceros.

Solución de problemas de IIS

Registro de eventos de la aplicación (IIS)

Acceda al registro de eventos de la aplicación:

1. Abra el menú Inicio, busque Visor de eventos y seleccione la aplicación Visor de eventos.
2. En Visor de eventos, abra el nodo Registros de Windows.
3. Seleccione Aplicación para abrir el registro de eventos de la aplicación.
4. Busque los errores asociados a la aplicación objeto del error. Los errores tienen un valor de Módulo AspNetCore de IIS o Módulo AspNetCore de IIS Express en la columna Origen.

Ejecución de la aplicación en un símbolo del sistema

Muchos errores de inicio no generan información útil en el registro de eventos de la aplicación. La causa de algunos errores se puede encontrar mediante la ejecución de la aplicación en un símbolo del sistema en el sistema de hospedaje.

Implementación dependiente de marco de trabajo

Si la aplicación es una implementación dependiente del marco:

1. En un símbolo del sistema, vaya a la carpeta de implementación y ejecute la aplicación mediante la ejecución del ensamblado de la aplicación con dotnet.exe. En el siguiente comando, sustituya el nombre del ensamblado de la aplicación por <nombre_ensamblado>: dotnet .\<assembly_name>.dll.
2. La salida de consola de la aplicación, que muestra los posibles errores, se escribe en la ventana de la consola.
3. Si los errores se producen al realizar una solicitud a la aplicación, realice una solicitud al host y el puerto donde escucha Kestrel. Con el host y el puerto predeterminados, realizar una solicitud a http://localhost:5000/. Si la aplicación responde normalmente en la dirección del punto de conexión de Kestrel, es más probable que el problema esté relacionado con la configuración de hospedaje que con la propia aplicación.

Implementación autocontenida

Si la aplicación es una implementación independiente:

1. En un símbolo del sistema, vaya a la carpeta de implementación y ejecute el archivo ejecutable de la aplicación. En el siguiente comando, sustituya el nombre del ensamblado de la aplicación por <nombre_ensamblado>: <assembly_name>.exe.
2. La salida de consola de la aplicación, que muestra los posibles errores, se escribe en la ventana de la consola.
3. Si los errores se producen al realizar una solicitud a la aplicación, realice una solicitud al host y el puerto donde escucha Kestrel. Con el host y el puerto predeterminados, realizar una solicitud a http://localhost:5000/. Si la aplicación responde normalmente en la dirección del punto de conexión de Kestrel, es más probable que el problema esté relacionado con la configuración de hospedaje que con la propia aplicación.

Registro de stdout del módulo ASP.NET Core (IIS)

Para habilitar y ver los registros de stdout:

1. Vaya a la carpeta de implementación del sitio en el sistema de hospedaje.
2. Si la carpeta Logs no existe, cree la carpeta. Para obtener instrucciones sobre cómo habilitar MSBuild para crear la carpeta logs automáticamente en la implementación, consulte el tema Estructura de directorios.
3. Edite el archivo web.config. Establezca stdoutLogEnabled en true y cambie la ruta de acceso de stdoutLogFile para que apunte a la carpeta logs (por ejemplo, .\logs\stdout). stdout en la ruta de acceso es el prefijo del nombre del archivo de registro. Cuando se crea el registro, se agregan automáticamente una marca de tiempo, un identificador de proceso y una extensión de archivo. Cuando se usa stdout como prefijo para el nombre de archivo, un archivo de registro se llama normalmente stdout_20180205184032_5412.log.
4. Asegúrate de que identity del grupo de aplicaciones tiene permisos de escritura en la carpeta logs.
5. Guarde el archivo web.config actualizado.
6. Realice una solicitud a la aplicación.
7. Vaya a la carpeta logs. Busque y abra el registro más reciente de stdout.
8. Estudie el registro para ver los errores.

Deshabilite el registro de stdout una vez haya solucionado los problemas:

1. Edite el archivo web.config.
2. Establezca stdoutLogEnabled en false.
3. Guarde el archivo.

Para obtener más información vea Módulo de ASP.NET Core (ANCM) para IIS.

Advertencia

La imposibilidad de deshabilitar el registro de stdout puede dar lugar a un error de la aplicación o del servidor. No hay ningún límite en el tamaño del archivo de registro ni en el número de archivos de registro creados.

Para el registro rutinario en una aplicación ASP.NET Core, use una biblioteca de registro que limite el tamaño del archivo de registro y realice la rotación de los registros. Para más información, consulte los proveedores de registro de terceros.

Registro de depuración del módulo ASP.NET Core (IIS)

Agregue la siguiente configuración de controlador al archivo web.config de la aplicación para habilitar el registro de depuración del módulo ASP.NET Core:

<aspNetCore ...>
  <handlerSettings>
    <handlerSetting name="debugLevel" value="file" />
    <handlerSetting name="debugFile" value="c:\temp\ancm.log" />
  </handlerSettings>
</aspNetCore>

Confirma que la ruta de acceso especificada para el registro existe y que identity del grupo de aplicaciones tiene permisos de escritura en la ubicación.

Para más información, vea Creación y redireccionamiento de registros con el módulo de ASP.NET Core.

Habilitación de la página de excepciones para el desarrollador

La variable de entorno ASPNETCORE_ENVIRONMENT se puede agregar a web.config para ejecutar la aplicación en el entorno de desarrollo. Siempre y cuando el entorno no se invalide al inicio de la aplicación con UseEnvironment en el generador de host, la configuración de la variable de entorno permite que aparezca la página de excepciones del desarrollador cuando se ejecuta la aplicación.

<aspNetCore processPath="dotnet"
      arguments=".\MyApp.dll"
      stdoutLogEnabled="false"
      stdoutLogFile=".\logs\stdout"
      hostingModel="InProcess">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
  </environmentVariables>
</aspNetCore>

Solo se recomienda establecer la variable de entorno para ASPNETCORE_ENVIRONMENT cuando se use en servidores de ensayo o pruebas que no estén expuestos a Internet. Quite la variable de entorno del archivo web.config cuando termine de solucionar los problemas. Para información sobre la configuración de variables de entorno en web.config, consulte el elemento secundario environmentVariables de aspNetCore.

Obtención de datos de una aplicación

Si una aplicación es capaz de responder a solicitudes, obtenga solicitudes, conexiones y datos adicionales de la aplicación mediante el middleware en línea del terminal. Para obtener más información y código de ejemplo, vea Solución de problemas y depuración de proyectos de ASP.NET Core.

Aplicación lenta o que no responde (IIS)

Un volcado de memoria es una instantánea de la memoria del sistema que puede ayudar a determinar la causa de un bloqueo de la aplicación, un error de inicio o una aplicación lenta.

Bloqueo o excepción de la aplicación

Obtenga y analice un volcado de memoria en Informe de errores de Windows (WER):

1. Cree una carpeta para almacenar los archivos de volcado de memoria en c:\dumps. El grupo de aplicaciones debe tener acceso de escritura a la carpeta.

2. Ejecute el script EnableDumps de PowerShell:

   • Si la aplicación usa el modelo de hospedaje en proceso, ejecute el script w3wp.exe:

     .\EnableDumps w3wp.exe c:\dumps
     

   • Si la aplicación usa el modelo de hospedaje fuera de proceso, ejecute el script dotnet.exe:

     .\EnableDumps dotnet.exe c:\dumps
     

3. Ejecute la aplicación en las condiciones que hacen que se produzca el bloqueo.

4. Una vez que se haya producido el bloqueo, ejecute el script DisableDumps de PowerShell:

   • Si la aplicación usa el modelo de hospedaje en proceso, ejecute el script w3wp.exe:

     .\DisableDumps w3wp.exe
     

   • Si la aplicación usa el modelo de hospedaje fuera de proceso, ejecute el script dotnet.exe:

     .\DisableDumps dotnet.exe
     

Después de que se bloquee la aplicación y se complete la recopilación del volcado de memoria, la aplicación puede finalizar con normalidad. El script de PowerShell configura WER de modo que recopile un máximo de cinco volcados de memoria por aplicación.

Advertencia

Los volcados de memoria pueden ocupar una gran cantidad de espacio en disco (hasta varios gigabytes cada uno).

La aplicación no responde, produce un error durante el inicio o se ejecuta con normalidad

Si una aplicación deja de responder pero no se bloquea, produce un error durante el inicio o se ejecuta con normalidad, consulta User-Mode Dump Files: Choosing the Best Tool para seleccionar una herramienta apropiada para generar el volcado de memoria:

Análisis del volcado de memoria

El volcado de memoria se puede analizar de varias maneras. Para obtener más información, vea Analyzing a User-Mode Dump File (Análisis de un archivo de volcado de memoria en modo de usuario).

Borrado de memorias caché de paquetes

Una aplicación en funcionamiento deja de ejecutarse inmediatamente después de actualizar el SDK de .NET Core en la máquina de desarrollo o de cambiar las versiones del paquete en la aplicación. En algunos casos, los paquetes incoherentes pueden interrumpir una aplicación al realizar actualizaciones importantes. La mayoría de estos problemas puede corregirse siguiendo estas instrucciones:

1. Elimine las carpetas bin y obj.

2. Borre las memorias caché del paquete ejecutando dotnet nuget locals all --clear desde un shell de comandos.

   Otra manera de borrar las memorias caché de paquetes es usando la herramienta nuget.exe y ejecutando el comando nuget locals all -clear. nuget.exe no es una instalación agrupada con el sistema operativo de escritorio de Windows y se debe obtener de forma independiente en el sitio web de NuGet.

3. Restaure el proyecto y vuelva a compilarlo.

4. Elimine todos los archivos de la carpeta de implementación del servidor antes de volver a implementar la aplicación.

Recursos adicionales

• Depuración de código fuente de .NET y ASP.NET Core con Visual Studio
• Solución de problemas y depuración de proyectos de ASP.NET Core
• Solución de problemas comunes para Azure App Service e IIS con ASP.NET Core
• Controlar errores en ASP.NET Core
• Módulo ASP.NET Core (ANCM) para IIS

Documentación de Azure

• Application Insights para ASP.NET Core
• Sección sobre la depuración remota de las aplicaciones web del artículo Solución de problemas de una aplicación web en Azure App Service con Visual Studio
• Introducción a diagnósticos de Azure App Service
• Cómo: Supervisar aplicaciones en Azure App Service
• Solución de problemas de una aplicación web en Azure App Service con Visual Studio
• Solucionar los errores HTTP de "502 Puerta de enlace no válida" y "503 Servicio no disponible" en las aplicaciones web de Azure
• Solucionar los problemas de rendimiento reducido de aplicaciones web en Azure App Service
• Preguntas más frecuentes sobre el rendimiento de aplicaciones para Web Apps de Azure
• Azure Web App sandbox (App Service runtime execution limitations) (Espacio aislado de Azure Web App [limitaciones de ejecución del entono de tiempo de ejecución de App Service])

Documentación de Visual Studio

• Depuración remota de ASP.NET Core en IIS en Azure en Visual Studio 2017
• Depuración remota de ASP.NET Core en un equipo remoto de IIS en Visual Studio 2017
• Información sobre cómo depurar con Visual Studio

Documentación de Visual Studio Code

• Depuración con Visual Studio Code