Analise os logs com o Elastic (ELK) usando configurações de diagnóstico

Nota

Os planos Basic, Standarde Enterprise entraram em um período de aposentadoria em 17 de março de 2025. Para mais informações, consulte o anúncio de descontinuação Azure Spring Apps.

Este artigo aplica-se a:✅ Java ✅ C#

Este artigo aplica-se a:✅ Basic/Standard ✅ Enterprise

Este artigo mostra-lhe como usar a funcionalidade de diagnóstico do Azure Spring Apps para analisar logs com o Elastic (ELK).

O vídeo a seguir apresenta a observabilidade unificada para aplicativos Spring Boot usando o Elastic.


Definir definições de diagnóstico

Para definir as configurações de diagnóstico, use as seguintes etapas:

  1. No portal do Azure, aceda à sua instância do Azure Spring Apps.
  2. Selecione a opção de configurações de diagnóstico e, em seguida, selecione Adicionar configuração de diagnóstico.
  3. Insira um nome para a configuração, escolha Enviar para solução de parceiro, depois selecione Elastic e uma implementação do Elastic para onde deseja enviar os logs.
  4. Selecione Guardar.

Captura de ecrã do Azure portal que mostra a página de definição de Diagnóstico com opções selecionadas e o nome especificado para a definição.

Nota

Pode haver um intervalo de até 15 minutos entre quando os logs são emitidos e quando eles aparecem na implantação do Elastic. Se a instância do Azure Spring Apps for eliminada ou movida, a operação não será propagada para os recursos das definições de diagnóstico. Deve-se eliminar manualmente os recursos das definições de diagnóstico antes de realizar a operação na instância principal do Azure Spring Apps. Caso contrário, se fornecesse uma nova instância do Azure Spring Apps com o mesmo ID de recurso da eliminada, ou se mover a instância do Azure Spring Apps de volta, os recursos das definições de diagnóstico anteriores continuarão a estendê-la.

Analise os logs com o Elastic

Para saber mais sobre a implementação do Elastic no Azure, consulte Como implementar e gerir o Elastic no Microsoft Azure.

Use as seguintes etapas para analisar os logs:

  1. Na página de visão geral da implementação do Elastic no Azure portal, abra Kibana.

    Captura de ecrã do portal do Azure que mostra a página do Elasticsearch (Elastic Cloud) com o link de Deployment URL Kibana destacado.

  2. No Kibana, na barra de pesquisa na parte superior, digite Spring Cloud type:dashboard.

    Captura de ecrã do Elastic / Kibana que mostra os resultados da pesquisa para Spring Cloud type:dashboard.

  3. Selecione [Logs Azure] Visão Geral dos registos Azure Spring Apps dos resultados.

    Captura de ecrã do Elastic / Kibana que mostra os registos da consola de aplicações do Azure Spring Apps.

  4. Pesquise em dashboards prontos a usar do Azure Spring Apps utilizando consultas como as seguintes:

    azure.springcloudlogs.properties.app_name : "visits-service"
    

Analise os logs com o Kibana Query Language no Discover

Os logs de aplicativos fornecem informações críticas e logs detalhados sobre a integridade, o desempenho e muito mais do seu aplicativo. Use as seguintes etapas para analisar os logs:

  1. No Kibana, na barra de pesquisa na parte superior, escreva Descobrir e, em seguida, selecione o resultado.

    Captura de ecrã de Elastic / Kibana que mostra os resultados da pesquisa para Discover.

  2. No aplicativo Descobrir, selecione o padrão de índice de logs, se ainda não estiver selecionado.

    Captura de ecrã do Elastic / Kibana que mostra a página de registos na aplicação Descobrir.

  3. Use consultas como as das seções a seguir para ajudá-lo a entender os estados atuais e passados do seu aplicativo.

Para obter mais informações sobre consultas diferentes, consulte Guia para a linguagem de consulta Kibana.

Mostrar todos os registos das aplicações Azure Spring

Para rever uma lista de registos de aplicação de Azure Aplicações Spring, ordenados por tempo com os registos mais recentes apresentados primeiro, execute a seguinte consulta na caixa Pesquisa:

azure_log_forwarder.resource_type : "Microsoft.AppPlatform/Spring"

Captura de ecrã do Elastic / Kibana que mostra a aplicação Discover com todos os registos apresentados.

Mostrar tipos específicos de logs do Azure Spring Apps

Para rever uma lista de registos de aplicação de Azure Aplicações Spring, ordenados por tempo com os registos mais recentes apresentados primeiro, execute a seguinte consulta na caixa Pesquisa:

azure.springcloudlogs.category : "ApplicationConsole"

Captura de ecrã do Elastic / Kibana que mostra a aplicação Discover com registos específicos apresentados.

Mostrar entradas de log contendo erros ou exceções

Para revisar entradas de log não ordenadas que mencionam um erro ou exceção, execute a seguinte consulta:

azure_log_forwarder.resource_type : "Microsoft.AppPlatform/Spring" and (log.level : "ERROR" or log.level : "EXCEPTION")

Captura de tela do Elastic / Kibana que mostra o aplicativo Discover com logs de erros e exceções exibidos.

A Linguagem de Consulta Kibana ajuda-o a formar consultas, fornecendo preenchimento automático e sugestões para o ajudar a obter informações dos registos. Use sua consulta para localizar erros ou modifique os termos de consulta para encontrar códigos de erro ou exceções específicos.

Mostrar entradas de log de um serviço específico

Para revisar as entradas de log geradas por um serviço específico, execute a seguinte consulta:

azure.springcloudlogs.properties.service_name : "sa-petclinic-service"

Captura de tela do Elastic / Kibana que mostra o aplicativo Discover com logs de serviço específicos exibidos.

Mostrar logs do Config Server contendo avisos ou erros

Para revisar os logs do Config Server, execute a seguinte consulta:

azure.springcloudlogs.properties.type : "ConfigServer" and (log.level : "ERROR" or log.level : "WARN")

Captura de tela do Elastic / Kibana que mostra o aplicativo Discover com os logs do Config Server exibidos.

Mostrar registos do Registo de Serviços

Para revisar os logs do Registro de Serviço, execute a seguinte consulta:

azure.springcloudlogs.properties.type : "ServiceRegistry"

Captura de ecrã do Elastic / Kibana que mostra a aplicação Discover com os logs do Service Registry apresentados.

Visualização de logs a partir do Azure Spring Apps com Elastic

O Kibana permite visualizar dados com Dashboards e um rico ecossistema de visualizações. Para obter mais informações, consulte Painel e visualização.

Use os passos a seguir para mostrar os vários níveis de registo nos seus registos, de forma que possa avaliar a saúde geral dos serviços.

  1. Na lista de campos disponíveis à esquerda em Descobrir, procure log.level na caixa de pesquisa sob o padrão de índice logs-.

  2. Selecione o campo log.level. No painel informativo flutuante sobre log.level, selecione Visualizar.

    Captura de ecrã do Elastic / Kibana que mostra a aplicação Discover exibindo níveis de registo.

  3. A partir daqui, você pode optar por adicionar mais dados do painel esquerdo ou escolher entre várias sugestões como gostaria de visualizar seus dados.

    Captura de ecrã do Elastic / Kibana que mostra a aplicação Discover com opções de visualização.

Próximos passos