Transmita logs do console do aplicativo Azure Spring Apps em tempo real

Use as seguintes etapas para transmitir logs no portal do Azure:

1. Vá para a página Visão geral da sua instância de serviço do Azure Spring Apps e selecione Aplicativos no painel de navegação.

2. Encontre seu aplicativo de destino e selecione o menu de contexto.

3. No menu de contexto pop-up, selecione Exibir fluxo de log.

   

Por padrão, os logs começam a ser transmitidos para uma instância de aplicativo selecionada aleatoriamente. Você pode selecionar o seu depois.

Por conveniência, há muitos pontos de entrada para transmitir logs. Você pode encontrá-los nos seguintes painéis:

• O painel Lista de aplicativos
• O painel Lista de implantação
• O painel de lista de instâncias do aplicativo

Esta seção fornece exemplos de como usar a CLI do Azure para produzir logs de cauda. Para evitar especificar repetidamente o nome do grupo de recursos e da instância de serviço, use os seguintes comandos para definir o nome padrão do grupo de recursos e o nome do cluster:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

O grupo de recursos e o nome do serviço são omitidos nos exemplos a seguir.

Exibir o log de cauda de um aplicativo com uma única instância

Se um aplicativo nomeado auth-service tiver apenas uma instância, você poderá exibir o log da instância do aplicativo com o seguinte comando:

az spring app logs --name <application-name>

O comando retorna logs semelhantes aos exemplos a seguir, onde auth-service é o nome do aplicativo.

...
2020-01-15 01:54:40.481  INFO [auth-service,,,] 1 --- [main] o.apache.catalina.core.StandardService  : Starting service [Tomcat]
2020-01-15 01:54:40.482  INFO [auth-service,,,] 1 --- [main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.22]
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/uaa]  : Initializing Spring embedded WebApplicationContext
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.s.web.context.ContextLoader  : Root WebApplicationContext: initialization completed in 7203 ms

...

Exibir o log de cauda de um aplicativo com várias instâncias

Se existirem várias instâncias para o aplicativo chamado auth-service, você poderá exibir o log de instâncias usando a -i/--instance opção.

Primeiro, execute o seguinte comando para obter os nomes de instância do aplicativo:

az spring app show --name auth-service --query properties.activeDeployment.properties.instances --output table

O comando produz resultados semelhantes à seguinte saída:

Name                                         Status    DiscoveryStatus
-------------------------------------------  --------  -----------------
auth-service-default-12-75cc4577fc-pw7hb  Running   UP
auth-service-default-12-75cc4577fc-8nt4m  Running   UP
auth-service-default-12-75cc4577fc-n25mh  Running   UP

Em seguida, você pode transmitir logs de uma instância de aplicativo usando a opção, da -i/--instance seguinte maneira:

az spring app logs --name auth-service --instance auth-service-default-12-75cc4577fc-pw7hb

Você também pode obter detalhes de instâncias de aplicativo no portal do Azure. Depois de selecionar Aplicativos no painel de navegação esquerdo do serviço Azure Spring Apps, selecione Instâncias de Aplicativo.

Transmita continuamente novos logs

Por padrão, imprime apenas os logs existentes transmitidos para o console do aplicativo e, em seguida, az spring app logs sai. Se você quiser transmitir novos logs, adicione o -f/--follow argumento, conforme mostrado no exemplo a seguir:

az spring app logs --name auth-service --follow

Quando você usa o --follow argumento para gerar logs instantâneos, o serviço de streaming de log do Azure Spring Apps envia logs de pulsação para o cliente a cada minuto, a menos que seu aplicativo esteja gravando logs constantemente. As mensagens de registro de pulsação usam o seguinte formato: 2020-01-15 04:27:13.473: No log from server.

Use o seguinte comando para verificar todas as opções de log suportadas:

az spring app logs --help

Formatar logs estruturados JSON

Os logs de aplicativos estruturados são exibidos no formato JSON, que pode ser difícil de ler. Você pode usar o --format-json argumento para formatar logs no formato JSON em um formato mais legível. Para obter mais informações, consulte Log de aplicativo estruturado para Azure Spring Apps.

O exemplo a seguir mostra como usar o --format-json argumento:

# Raw JSON log
$ az spring app logs --name auth-service
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Disable delta property : false"}
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Single vip registry refresh property : null"}

# Formatted JSON log
$ az spring app logs --name auth-service --format-json
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Disable delta property : false
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Single vip registry refresh property : null

O --format-json argumento também aceita um formato personalizado opcional usando sintaxe de cadeia de caracteres de formato. Para obter mais informações, consulte Formatar sintaxe de cadeia de caracteres.

O exemplo a seguir mostra como usar a sintaxe de cadeia de caracteres de formato:

# Custom format
$ az spring app logs --name auth-service --format-json="{message}{n}"
Disable delta property : false
Single vip registry refresh property : null

O formato padrão que está sendo usado é:

{timestamp} {level:>5} [{thread:>15.15}] {logger{39}:<40.40}: {message}{n}{stackTrace}

Use as seguintes etapas para habilitar um ponto de extremidade de streaming de log na rede pública:

1. Selecione a instância de serviço do Azure Spring Apps implantada em sua rede virtual e selecione Rede no menu de navegação.

2. Selecione a guia Injeção de Vnet.

3. Alterne o status dos recursos do Dataplane na rede pública para habilitar um ponto de extremidade de streaming de log na rede pública. Este processo demora alguns minutos.

   

Use o seguinte comando para habilitar o ponto de extremidade público do fluxo de log:

az spring update \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --enable-dataplane-public-endpoint true