Visualize o log de aplicativos ao vivo com o serviço de streaming de logs

Concluído

Nesta unidade, você analisa como exibir um fluxo de log de aplicativo ao vivo e como os fluxos de log ao vivo podem ajudar durante o desenvolvimento de aplicativos Web.

O que é live log streaming?

A transmissão em fluxo de registos em tempo real é uma forma fácil e eficiente de ver registos em tempo real para fins de resolução de problemas. O streaming de log ao vivo fornece uma visualização rápida de todas as mensagens enviadas para os logs do aplicativo no sistema de arquivos, sem ter que passar pelo processo de localização e abertura dos logs. Para usar o log ao vivo, você se conecta ao serviço de log ao vivo a partir da linha de comando e, em seguida, pode ver o texto sendo gravado nos logs do aplicativo em tempo real.

Quais logs podem ser transmitidos?

O serviço de streaming de logs adiciona um redirecionamento dos logs do sistema de arquivos, para que você veja as mesmas informações salvas nos arquivos de log. Portanto, se você habilitar o log detalhado para ASP.NET aplicativos do Windows, por exemplo, o fluxo de log ao vivo mostrará todas as suas mensagens registradas.

Captura de tela do painel de fluxo de log ao vivo do portal do Azure mostrando a saída do contêiner de logs asp.

Cenários típicos para utilizar o registo em tempo real

O registro em tempo real é uma ferramenta útil para depuração inicial. As mensagens de registo em tempo real dão-lhe feedback imediato sobre problemas de código ou servidor. Em seguida, pode fazer uma alteração, voltar a implementar a aplicação e ver instantaneamente os resultados.

O fluxo de log ao vivo se conecta a uma única instância de aplicativo, portanto, não é útil se você tiver um aplicativo de várias instâncias. O registro ao vivo também é de uso limitado à medida que você aumenta a escala de seus aplicativos. Nesses cenários, é melhor garantir que as mensagens sejam salvas em arquivos de log que podem ser abertos e estudados offline.

Como utilizar a transmissão em fluxo de registos em tempo real

Você pode habilitar o streaming de log ao vivo a partir da linha de comando, em uma sessão do Cloud Shell diretamente do portal do Azure. Há duas opções: CLI do Azure ou comandos curl .

CLI do Azure

Para abrir o fluxo de registos, execute o seguinte comando.

az webapp log tail --name <app name> --resource-group <resource group name>

Para parar de visualizar logs dinâmicos, pressione Ctrl+C.

Curl

Para usar o Curl, você precisa de credenciais FTPS. Existem dois tipos de credenciais FTPS:

  • Âmbito da aplicação. O Azure cria automaticamente uma combinação de nome de utilizador/palavra-passe quando implementa uma aplicação Web e cada uma das aplicações possui o seu próprio conjunto de credenciais em separado.

  • Âmbito do utilizador. Você pode criar suas próprias credenciais para uso com qualquer aplicativo Web. Você pode gerenciar essas credenciais no portal do Azure, desde que já tenha pelo menos um aplicativo Web ou usando comandos da CLI do Azure.

IU do portal do Azure

Para exibir e copiar esses detalhes do portal do Azure, no menu Serviço de Aplicativo, em Implantação, selecione Centro de Implantação e selecione a guia Credenciais FTPS.

Captura de tela do painel Centro de Implantação do Serviço de Aplicativo mostrando a guia Credenciais FTPS.

Redefinir credenciais no nível do usuário

Para criar um novo conjunto de credenciais de nível de usuário, execute o seguinte comando no Cloud Shell.

az webapp deployment user set --user-name <name-of-user-to create> --password <new-password>

Nota

Os nomes de utilizador têm de ser globalmente exclusivos em todo o Azure e não apenas na sua própria subscrição ou o diretório.

Depois de criar um conjunto de credenciais, execute o seguinte comando para abrir o fluxo de log. Em seguida, ser-lhe-á solicitada a palavra-passe.

curl -u {username} https://{sitename}.scm.azurewebsites.net/api/logstream

Para fechar uma sessão de fluxo de log ativo, pressione Ctrl+C.