Elasticsearch:Usar um servidor APM autogerenciado para coletar dados no Alibaba Cloud Elasticsearch

Informações básicas

Observabilidade consiste em medir sua infraestrutura, plataformas e aplicações para compreender seu estado. Diferente do monitoramento tradicional, focado na detecção e emissão de alertas sobre problemas conhecidos, a observabilidade busca explicar tudo o que ocorre em um sistema distribuído complexo. Enquanto o monitoramento se concentra na saúde do service durante e após a entrega de software, a observabilidade abrange todo o ciclo de vida de desenvolvimento e operações.

Pré-requisitos

• Crie uma instância do Alibaba Cloud Elasticsearch V7.10. Para mais informações, consulte Create an Alibaba Cloud Elasticsearch instance.

  Nota

  Recomendamos ativar o Indexing Service e o Openstore para oferecer suporte à ingestão e armazenamento de grandes volumes de dados com custo-benefício para monitoramento de desempenho de aplicações.

• Crie uma instância do Alibaba Cloud ECS com sistema operacional Linux. Para mais informações, consulte Create an instance by using the custom launch wizard.

• Instale o ambiente da linguagem Go na instância ECS.

  Nota

  Este tópico utiliza o agente APM para Go, que exige o ambiente da linguagem Go.

Procedimento

1. Step 1: Set up the APM Server

2. Step 2: Configure the APM agent

3. Step 3: View and analyze data in Kibana

Etapa 1: Criar um servidor APM

1. Conecte-se à instância ECS.

   Para mais informações, consulte Log on to a Linux instance by using Workbench.

   Nota

   As operações neste tópico utilizam uma conta de usuário comum.

2. Instale um servidor APM.

   1. Baixe o pacote de instalação de um servidor APM.

      wget https://artifacts.elastic.co/downloads/apm-server/apm-server-7.10.2-linux-x86_64.tar.gz

   2. Descompacte o pacote de instalação.

      tar -zxf apm-server-7.10.2-linux-x86_64.tar.gz

3. Modifique as configurações do servidor APM.

   1. Acesse o diretório onde o servidor APM está instalado.

      cd apm-server-7.10.2-linux-x86_64/

   2. Modifique o arquivo de configuração YML.

      vim apm-server.yml

      Modifique o arquivo YML conforme mostrado no exemplo a seguir.

      apm-server:
        host: "0.0.0.0:8200"
      output.elasticsearch:
        hosts: ["es-cn-*****.elasticsearch.aliyuncs.com:9200"]
        username: "elastic"
        password: "[pwd]"

      Parâmetro	Descrição
      apm-server	O endpoint do APM Server. Defina o valor de host como o endereço IP de escuta:porta do APM Server. Neste exemplo, o valor é 0.0.0.0:8200.
      output.elasticsearch	A configuração de saída do Elasticsearch. hosts: O endpoint público ou interno da sua instância do Elasticsearch. Para encontrar o endpoint, consulte View the basic information of an instance. Importante Se a instância do Elasticsearch e a instância ECS onde o APM Server está instalado estiverem na mesma VPC, use o endpoint interno. Caso contrário, use o endpoint público e configure uma lista de permissões de endereços IP. Para mais informações, consulte Configure a public or internal IP address whitelist for an instance. username: O nome de usuário para acessar a instância do Elasticsearch. O padrão é elastic. Se você usar um usuário personalizado, deverá atribuir as funções e permissões necessárias. Para mais informações, consulte Use Elasticsearch X-Pack roles to manage user permissions. password: A senha do usuário especificado. A senha do usuário elastic é definida durante a criação da instância. Se esquecê-la, poderá redefini-la. Para mais informações, consulte Reset the access password of an instance.

4. Inicie o servidor APM.

   sudo nohup ./apm-server -e > apmserver.log 2>&1 &

Etapa 2: Configurar um agente APM

Este tópico usa Go como exemplo .

1. Instale um agente APM.

   1. Inicialize o arquivo go.mod.

      sudo go mod init demo

   2. Instale um pacote de agente APM Go.

      sudo go get go.elastic.co/apm
      sudo go get go.elastic.co/apm/module/apmhttp

      Nota

      Um erro golang.org xxxx: i/o timeout indica que golang.org está inacessível. Para resolver isso, altere a fonte de download.

2. Configure o agente APM.

   1. Abra o arquivo de configuração de variáveis de ambiente.

      vim ~/.bash_profile

   2. No arquivo de configuração, adicione as seguintes definições para inicializar o agente APM e salve as alterações.

      # Set the service name. Allowed characters: a-z, A-Z, 0-9, -, _, and space.
      # If ELASTIC_APM_SERVICE_NAME is not set, the executable's file name is used.
      export ELASTIC_APM_SERVICE_NAME=zijian
      
      # Set a custom APM Server URL (default: http://localhost:8200).
      export ELASTIC_APM_SERVER_URL=
      
      # Use a secret token if required by the APM Server.
      export ELASTIC_APM_SECRET_TOKEN=

   3. Execute o seguinte comando para aplicar o arquivo de configuração:

      source ~/.bash_profile

3. Use o agente APM para instrumentar uma aplicação.

   1. Crie um arquivo de aplicação de exemplo chamado apm.go.

      vim apm.go

   2. Adicione as seguintes informações ao arquivo apm.go e salve-o.

      Para instrumentar sua aplicação Go, use um dos módulos de instrumentação fornecidos ou a API do tracer.

      package main
      
        import (
          "net/http"
      
          "go.elastic.co/apm/module/apmhttp"
        )
      
        func main() {
          mux := http.NewServeMux()
          http.ListenAndServe(":8080", apmhttp.Wrap(mux))
        }

   3. Execute o arquivo apm.go.

      sudo go run apm.go

Etapa 3: Visualizar e analisar dados coletados pelo servidor APM no console do Kibana

1. Faça login no console do Kibana do cluster Elasticsearch.

   Para mais informações, consulte Log on to the Kibana console.

   Nota

   Este tópico usa uma instância do Alibaba Cloud Elasticsearch V7.10 como exemplo. A interface e as operações podem variar em outras versões.

2. Na página inicial do Kibana, clique em Dev tools no canto superior direito.

3. Na aba Console, execute o script a seguir para ativar a criação automática do índice de integração do APM.

   Nota

   • O Alibaba Cloud Elasticsearch impõe convenções de nomenclatura específicas para índices criados automaticamente. Como o nome padrão do índice de integração do APM não está em conformidade, execute este comando para permitir sua criação.

   • No script a seguir, 7.10.2 é a versão do APM Server instalada.

   PUT _cluster/settings
   {
     "persistent": {
       "action.auto_create_index":"+.*,+apm-7.10.2-onboarding-*,-*"
     }
   }

4. Visualize os services monitorados pelo APM.

   A página Services do APM lista todos os services integrados em uma tabela. A tabela contém as colunas Name, Environment, Avg. response time, Trans. per minute e Error rate %, que mostram cada service integrado e suas métricas de desempenho.

   1. No canto superior esquerdo, clique no ícone para expandir o painel de navegação à esquerda.

   2. No painel de navegação, em Observability, clique em APM.

   3. A aba Services exibe todos os services do APM.

   4. Clique no nome de um service para visualizar e analisar dados relacionados a ele.