Habilitación de los registros de ejecución de secuencias en Azure Functions

A menudo, cuando desarrolla una aplicación, quiere ver lo que se escribe en los registros casi en tiempo real cuando se ejecuta en Azure.

Hay dos maneras de ver una secuencia de los archivos de registro que generan las ejecuciones de la función.

• Live Metrics Stream (recomendado): cuando la aplicación de funciones está conectada a Application Insights, puede ver los datos de registro y otras métricas casi en tiempo real en Azure Portal mediante Live Metrics Stream. Use este método cuando supervise funciones que se ejecutan en varias instancias y admite todos los tipos de plan. En este método se usan datos muestreados.

• Streaming integrado de registros: la plataforma de App Service le permite ver una secuencia de los archivos de registro de aplicaciones. Esto equivale a la salida que se ve al depurar las funciones durante el desarrollo local y cuando se usa la pestaña Prueba del portal. Se muestra toda la información basada en el registro. Para más información, consulte Registros de Stream. Este método de streaming solo admite una instancia y no se puede usar con una aplicación que se ejecuta en Linux en un plan de consumo. Cuando la función se escala a varias instancias, no se muestran los datos de otras instancias con este método.

Las secuencias de registro se pueden ver tanto en el portal como en la mayoría de los entornos de desarrollo locales.

Portal

Puede ver ambos tipos de secuencias de registro en el portal.

Para ver los registros de secuencias en el portal, seleccione la pestaña Características de la plataforma en la aplicación de función. Luego, en Supervisión, elija Secuencias de registro.

Esto conecta la aplicación con el servicio de secuencias de registro, y los registros de aplicación se muestran en la ventana. Puede alternar entre Registros de aplicaciones y Registros de servidor web.

Para ver Live Metrics Stream de su aplicación, seleccione la pestaña Información general de la aplicación de funciones. Cuando haya habilitado Application Insights, verá un vínculo a Application Insights en Características configuradas. Este vínculo lo llevará a la página Application Insights correspondiente a la aplicación.

En Application Insights, seleccione Live Metrics Stream. Las entradas de los registros muestreados se muestran en Telemetría de ejemplo.

Visual Studio Code

Para activar los registros de streaming de su aplicación de funciones en Azure:

1. Seleccione F1 para abrir la paleta de comandos y, a continuación, busque y ejecute el comando Azure Functions: Start Streaming Logs (Azure Functions: Iniciar transmisión de registros).

2. Seleccione su aplicación de funciones en Azure y seleccione Yes (Sí) para habilitar el registro de aplicaciones de la aplicación de funciones.

3. Desencadene las funciones en Azure. Observará que los datos de registro se muestran en la ventana de salida de Visual Studio Code.

4. Cuando haya terminado, recuerde ejecutar el comando Azure Functions: Stop Streaming Logs (Azure Functions: Detener transmisión de registros) para deshabilitar el registro de la aplicación de funciones.

Core Tools

Use el comando func azure functionapp logstream para empezar a recibir registros de streaming de una aplicación de funciones específica que se ejecuta en Azure, como en este ejemplo:

func azure functionapp logstream <FunctionAppName>

Nota

Dado que el streaming de registro integrado aún no está habilitado para las aplicaciones de funciones que se ejecutan en Linux en un plan de consumo, debe habilitar Live Metrics Stream para ver los registros casi en tiempo real.

Use este comando para mostrar Live Metrics Stream en una nueva ventana del explorador.

func azure functionapp logstream <FunctionAppName> --browser

CLI de Azure

Puede habilitar los registros de secuencias con la CLI de Azure. Use los siguientes comandos para iniciar sesión, elija su suscripción y transmita los archivos de registro:

az login
az account list
az account set --subscription <subscriptionNameOrId>
az webapp log tail --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME>

Azure PowerShell

Puede habilitar los registros de secuencias con Azure PowerShell. Para PowerShell, use el comando Set-AzWebApp para habilitar el registro en la aplicación de funciones, como se muestra en el siguiente fragmento de código:

# Enable Logs
Set-AzWebApp -RequestTracingEnabled $True -HttpLoggingEnabled $True -DetailedErrorLoggingEnabled $True -ResourceGroupName $ResourceGroupName -Name $AppName

Para obtener más información, vea el código de ejemplo completo.

Pasos siguientes

• Monitor Azure Functions
• Análisis de la telemetría de Azure Functions en Application Insights