Início Rápido: Monitorar aplicativos de ponta a ponta

Artigo
10/03/2024

Observação

Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

O plano consumo e dedicado Standard será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Esse artigo se aplica a: ❎ Basic/Standard ✅ Enterprise

Este guia de início rápido explica como monitorar aplicativos que executam o plano Enterprise do Azure Spring Apps usando o Application Insights e o Log Analytics.

Observação

Você pode monitorar suas cargas de trabalho do Spring de ponta a ponta usando qualquer ferramenta e plataforma de sua escolha, incluindo App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic ou Splunk. Para obter mais informações, confira Trabalhar com outras ferramentas de monitoramento posteriormente neste artigo.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Entenda e atenda a seção Requisitos do plano Enterprise no Azure Marketplace.
A CLI do Azure, versão 2.45.0 ou superior.
Git.
A extensão do plano Enterprise dos Aplicativos Spring do Azure. Use o comando a seguir para remover as versões anteriores e instalar a extensão do plano Enterprise mais recente. Se você instalou a extensão spring-cloud anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Recursos para monitoramento, como os criados nos seguintes guias de início rápido:

Atualizar aplicativos

Você deve fornecer manualmente a cadeia de conexão do Application Insights aos aplicativos Order Service (ASP.NET core) e Cart Service (python). As instruções a seguir descrevem como fornecer essa cadeia de conexão e aumentar a taxa de amostragem para o Application Insights.

Observação

Atualmente, apenas os buildpacks para aplicativos Java e NodeJS dão suporte à instrumentação do Application Insights.

Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Substitua os espaços reservados pelos seus valores. O nome da instância de serviço dos Aplicativos Spring do Azure deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hifens. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
```
export RESOURCE_GROUP="<resource-group-name>"
export APP_INSIGHTS_NAME="<app-insights-name>"
export KEY_VAULT_NAME="<key-vault-name>"
export AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME="<Azure-Spring-Apps-service-instance-name>"
```
Observação

Por padrão, o APP_INSIGHTS_NAME é o mesmo que o AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Use os seguintes comandos para recuperar a cadeia de conexão do Application Insights e defini-la no Key Vault:

export CONNECTION_STRING=$(az monitor app-insights component show \
    --resource-group ${RESOURCE_GROUP} \
    --app ${APP_INSIGHTS_NAME} \
    --query "connectionString" \
    --output tsv)

az keyvault secret set \
    --vault-name ${KEY_VAULT_NAME} \
    --name "ApplicationInsights--ConnectionString" \
    --value ${CONNECTION_STRING}

Use o comando a seguir para atualizar a taxa de amostragem da associação do Application Insights para aumentar a quantidade de dados disponíveis:

az spring build-service builder buildpack-binding set \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --builder-name default \
    --name default \
    --type ApplicationInsights \
    --properties sampling-rate=100 connection_string=${CONNECTION_STRING}

Use os seguintes comandos para reiniciar aplicativos para recarregar a configuração:

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name cart-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name order-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name catalog-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name frontend

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name payment-service

Se você tiver configurado o logon único, use os seguintes comandos para reiniciar aplicativos para recarregar a configuração do aplicativo de serviço de identidade:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Para os aplicativos Java e NodeJS, a reinicialização permitirá que a nova taxa de amostragem entre em vigor. Para os aplicativos não Java, a reinicialização permitirá que eles acessem a chave de instrumentação recém-adicionada do Key Vault.

Exibir logs

Há duas maneiras de ver logs no Azure Spring Apps: o Streaming de Log de logs em tempo real por instância de aplicativo ou o Log Analytics para logs agregados com capacidade de consulta avançada

Usar o streaming de log

Gere tráfego no aplicativo movendo-se pelo aplicativo, exibindo o catálogo e fazendo pedidos. Use os seguintes comandos para gerar tráfego continuamente, até o cancelamento:

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --query "properties.url" \
    --output tsv)

export GATEWAY_URL=https://${GATEWAY_URL} 

cd azure-spring-apps-enterprise/load-test/traffic-generator
./gradlew gatlingRun-com.vmware.acme.simulation.GuestSimulation.java

Use o comando a seguir para obter as 100 linhas mais recentes de logs do console do aplicativo do aplicativo Catalog Service:

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --lines 100

Ao adicionar a opção --follow, você pode obter streaming de log em tempo real de um aplicativo. Use o seguinte comando para tentar o streaming de log para o aplicativo Catalog Service:

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --follow

Dica

Você pode usar os logs do aplicativo az spring --help para explorar mais parâmetros e funcionalidades de fluxo de log.

Usar o Log Analytics

Navegue até o portal do Azure e abra a instância do Log Analytics que você criou. Você pode encontrar a instância do Log Analytics no mesmo grupo de recursos em que criou a instância do serviço Azure Spring Apps.

Na página do Log Analytics, selecione o painel Logs e execute qualquer uma das seguintes consultas de exemplo para o aplicativo Azure Spring Apps.

Digite e execute a seguinte consulta Kusto para conferir os logs do aplicativo:

AppPlatformLogsforSpring
| where TimeGenerated > ago(24h)
| limit 500
| sort by TimeGenerated
| project TimeGenerated, AppName, Log