Tutorial: Monitorar seus aplicativos do Service Fabric usando ELK

Este tutorial é a quarta parte de uma série. Ele mostra como usar ELK (Elasticsearch, Logstash e Kibana) para monitorar aplicativos do Service Fabric em execução no Azure.

Na quarta parte da série, você aprende a:

Nesta série de tutoriais você aprenderá a:

Pré-requisitos

Antes de começar este tutorial:

• Se você não tiver uma assinatura do Azure, crie uma conta gratuita
• Configure seu aplicativo para emitir logs para o local especificado na parte dois.
• Conclua a terceira parte e tenha um cluster do Service Fabric em execução configurado para enviar logs para Hubs de Eventos.
• A política no Hub de Eventos que possui a permissão 'Ouvir' e a chave primária associada do grupo três.

Descarregar a aplicação de demonstração de votação

Se você não criou o aplicativo de exemplo de votação na parte um desta série de tutoriais, você pode baixá-lo. Em uma janela de comando, execute o seguinte comando para clonar o repositório de aplicativo de exemplo para sua máquina local.

git clone https://github.com/Azure-Samples/service-fabric-java-quickstart

Criar um servidor ELK no Azure

Você pode usar um ambiente ELK pré-configurado para este tutorial e, se já tiver um, vá para a seção Setup Logstash . No entanto, se você não tiver um, as etapas a seguir criarão um no Azure.

1. Crie um ELK certificado pela Bitnami no Azure. Para os fins do tutorial, não há quaisquer especificações específicas a seguir para a criação deste servidor.

2. Vá para o seu recurso no portal do Azure e aceda à guia Diagnóstico de Inicialização na seção Suporte + Solução de Problemas. Em seguida, clique na guia Serial Log .

   

3. Fazer uma pesquisa nos logs onde a senha é necessária para aceder à instância do Kibana. Ele se assemelha ao seguinte trecho:

   [   25.932766] bitnami[1496]: #########################################################################
   [   25.948656] bitnami[1496]: #                                                                       #
   [   25.962448] bitnami[1496]: #        Setting Bitnami application password to '[PASSWORD]'           #
   [   25.978137] bitnami[1496]: #        (the default application username is 'user')                   #
   [   26.004770] bitnami[1496]: #                                                                       #
   [   26.029413] bitnami[1496]: #########################################################################
   

4. Pressione o botão conectar na página Visão geral do servidor no portal do Azure para obter os detalhes de logon.

   

5. SSH no servidor que hospeda a imagem ELK usando o seguinte comando

   ssh [USERNAME]@[CONNECTION-IP-OF-SERVER]
   
   Example: ssh testaccount@104.40.63.157
   

Configurar o ELK

1. O primeiro passo é carregar o ambiente ELK

   sudo /opt/bitnami/use_elk
   

2. Se você estiver usando um ambiente existente, será necessário executar o seguinte comando para interromper o serviço Logstash

   sudo /opt/bitnami/ctlscript.sh stop logstash
   

3. Execute o seguinte comando para instalar o plug-in Logstash para Hubs de Eventos.

   logstash-plugin install logstash-input-azureeventhub
   

4. Crie ou modifique seu arquivo de configuração Logstash existente com o seguinte conteúdo: Se você estiver criando o arquivo, ele deverá ser criado em /opt/bitnami/logstash/conf/access-log.conf se estiver usando a imagem ELK Bitnami no Azure.

   input
   {
       azureeventhub
       {
           key => "[RECEIVER-POLICY-KEY-FOR-EVENT-HUB]"
           username => "[RECEIVER-POLICY-NAME]"
           namespace => "[EVENTHUB-NAMESPACENAME]"
           eventhub => "[EVENTHUB-NAME]"
           partitions => 4
       }
   }
   
   output {
        elasticsearch {
            hosts => [ "127.0.0.1:9200" ]
        }
    }
   

5. Para verificar a configuração, execute o seguinte comando:

   /opt/bitnami/logstash/bin/logstash -f /opt/bitnami/logstash/conf/ --config.test_and_exit
   

6. Iniciar o serviço Logstash

   sudo /opt/bitnami/ctlscript.sh start logstash
   

7. Verifique o seu Elasticsearch para se certificar de que está a receber dados

   curl 'localhost:9200/_cat/indices?v'
   

8. Aceda ao seu painel do Kibana em http://SERVER-IP e introduza o nome de utilizador e a palavra-passe no Kibana. Se você usou a imagem ELK no Azure, o nome de usuário padrão é 'usuário' e a senha é a obtida do Diagnóstico de Inicialização.

   

Próximos passos

Neste tutorial, você aprendeu como:

Avance para o tutorial seguinte: