Ativar registos de execução de transmissão em fluxo no Funções do Azure

Ao desenvolver uma aplicação, muitas vezes quer ver o que está a ser escrito nos registos quase em tempo real ao executar no Azure.

Existem duas formas de ver um fluxo de ficheiros de registo que estão a ser gerados pelas execuções da função.

• Transmissão em fluxo de registos incorporada: a plataforma de Serviço de Aplicações permite-lhe ver um fluxo dos seus ficheiros de registo de aplicações. Isto é equivalente ao resultado visto quando depura as suas funções durante o desenvolvimento local e quando utiliza o separador Testar no portal. Todas as informações baseadas em registos são apresentadas. Para obter mais informações, veja Registos do Stream. Este método de transmissão em fluxo suporta apenas uma única instância e não pode ser utilizado com uma aplicação em execução no Linux num plano de Consumo. Quando a função é dimensionada para várias instâncias, os dados de outras instâncias não são apresentados com este método.

• Live Metrics Stream: quando a sua aplicação de funções está ligada ao Application Insights, pode ver dados de registo e outras métricas quase em tempo real no portal do Azure com o Live Metrics Stream. Utilize este método quando monitorizar funções em execução em várias instâncias e suportar todos os tipos de planos. Este método utiliza dados de exemplo.

Os fluxos de registo podem ser visualizados no portal e na maioria dos ambientes de desenvolvimento locais.

Portal

Pode ver ambos os tipos de fluxos de registo no portal.

Para ver os registos de transmissão em fluxo no portal, selecione o separador Funcionalidades da plataforma na sua aplicação de funções. Em seguida, em Monitorização, selecione Transmissão em fluxo de registos.

Esta ação liga a sua aplicação ao serviço de transmissão em fluxo de registos e os registos de aplicações são apresentados na janela. Pode alternar entre os Registos de aplicações e os registos do servidor Web.

Para ver o Live Metrics Stream da sua aplicação, selecione o separador Descrição geral da sua aplicação de funções. Quando tiver o Application Insights ativado, verá uma ligação do Application Insights emFuncionalidades configuradas. Esta ligação direciona-o para a página do Application Insights da sua aplicação.

No Application Insights, selecione Transmissão em Fluxo de Métricas em Direto. As entradas de registo de exemplo são apresentadas em Telemetria de Exemplo.

Visual Studio Code

Para ativar os registos de transmissão em fluxo para a sua aplicação de funções no Azure:

1. Selecione F1 para abrir a paleta de comandos e, em seguida, procure e execute o comando Funções do Azure: Iniciar Registos de Transmissão em Fluxo.

2. Selecione a sua aplicação de funções no Azure e, em seguida, selecione Sim para ativar o registo de aplicações da aplicação de funções.

3. Acione as suas funções no Azure. Note que os dados de registo são apresentados na janela Output (Saída) no Visual Studio Code.

4. Quando terminar, lembre-se de executar o comando Funções do Azure: Parar Registos de Transmissão em Fluxo para desativar o registo da aplicação de funções.

Ferramentas Principais

Utilize o func azure functionapp logstream comando para começar a receber registos de transmissão em fluxo de uma aplicação de funções específica em execução no Azure, como neste exemplo:

func azure functionapp logstream <FunctionAppName>

Nota

Uma vez que a transmissão em fluxo de registos incorporada ainda não está ativada para aplicações de funções em execução no Linux num plano de Consumo, tem de ativar o Live Metrics Stream para ver os registos quase em tempo real.

Utilize este comando para apresentar o Live Metrics Stream numa nova janela do browser.

func azure functionapp logstream <FunctionAppName> --browser

CLI do Azure

Pode ativar os registos de transmissão em fluxo com a CLI do Azure. Utilize os seguintes comandos para iniciar sessão, escolher a sua subscrição e transmitir ficheiros de registo:

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

Pode ativar os registos de transmissão em fluxo com Azure PowerShell. Para o PowerShell, utilize o comando Set-AzWebApp para ativar o registo na aplicação de funções, conforme mostrado no fragmento seguinte:

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

Para obter mais informações, veja o exemplo de código completo.

Passos seguintes

• Monitorizar as Funções do Azure
• Analisar Funções do Azure telemetria no Application Insights