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

Instale o servidor APM

1. Conecte-se à sua instância ECS como um usuário comum. Consulte Conectar-se a uma instância Linux usando senha ou chave.

2. Baixe o pacote do servidor APM.

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

3. Extraia o pacote.

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

Configure o servidor APM

1. Acesse o diretório do servidor APM.

   cd apm-server-7.10.2-linux-x86_64/

2. Abra o arquivo de configuração.

   vim apm-server.yml

3. Atualize a configuração com os detalhes do seu cluster do Elasticsearch.

   Parâmetro	Descrição
   apm-server.host	Endereço e porta nos quais o servidor APM escuta. Formato: <IP>:<porta>. O valor 0.0.0.0:8200 escuta em todas as interfaces.
   output.elasticsearch.hosts	Endpoint do seu cluster do Elasticsearch. Use o endpoint interno se a instância ECS e o cluster estiverem na mesma Virtual Private Cloud (VPC). Se estiverem em VPCs diferentes, use o endpoint público e configure uma lista de permissões de IP público. Consulte Visualize as informações básicas de um cluster e Configure uma lista de permissões de endereços IP públicos ou privados para um cluster do Elasticsearch.
   output.elasticsearch.username	Nome de usuário para o Elasticsearch. O padrão é elastic. Para usar uma conta personalizada, crie primeiro uma função e conceda a ela as permissões de gravação necessárias. Consulte Usar o mecanismo RBAC fornecido pelo Elasticsearch X-Pack para implementar controle de acesso.
   output.elasticsearch.password	Senha do nome de usuário acima. A senha da conta elastic é definida durante a criação do cluster. Para redefini-la, consulte Redefinir a senha de acesso de um cluster do Elasticsearch.

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

Iniciar o servidor APM

Execute o comando a seguir para iniciar o servidor APM em segundo plano e redirecionar a saída para um arquivo de log.

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

O servidor APM inicia, conecta-se ao Elasticsearch no endpoint especificado e expõe a API do agente na porta 8200. Para verificar se o servidor está em execução, procure no arquivo apmserver.log uma mensagem confirmando a conexão com o Elasticsearch e indicando que o servidor está escutando na porta 8200.

Instale o agente Go

1. Inicialize um módulo Go para o seu projeto.

   sudo go mod init demo

2. Instale os pacotes do agente APM.

   Se você encontrar o erro golang.org xxxx: i/o timeout , seu ambiente não consegue acessar golang.org. Altere o proxy de módulos do Go para um espelho acessível antes de tentar novamente.

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

Defina variáveis de ambiente do agente APM

1. Abra o arquivo de perfil do shell.

   vim ~/.bash_profile

2. Adicione as seguintes variáveis de ambiente e salve o arquivo.

   Variável	Padrão	Descrição
   ELASTIC_APM_SERVICE_NAME	Nome do arquivo executável	Nome do seu serviço. Caracteres permitidos: letras, dígitos, hifens (-), sublinhados (_) e espaços.
   ELASTIC_APM_SERVER_URL	http://localhost:8200	URL do servidor APM. Defina este valor como o endereço do servidor iniciado na Etapa 1.
   ELASTIC_APM_SECRET_TOKEN	_(nenhum)_	Token secreto exigido pelo servidor APM.

   export ELASTIC_APM_SERVICE_NAME=zijian
   export ELASTIC_APM_SERVER_URL=
   export ELASTIC_APM_SECRET_TOKEN=

3. Aplique a configuração.

   source ~/.bash_profile

Instrumentar sua aplicação

O agente Elastic APM Go oferece módulos integrados para frameworks populares (como apmhttp) e uma API Tracer de nível mais baixo para instrumentação personalizada. Este exemplo usa apmhttp para encapsular um servidor HTTP padrão.

1. Crie o arquivo da aplicação.

   vim apm.go

2. Adicione o código a seguir e salve o arquivo.

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

3. Execute a aplicação.

   sudo go run apm.go

   Quando a aplicação entra em execução, o agente APM começa a enviar dados de rastreamento para o servidor APM, que os encaminha para o seu cluster do Elasticsearch.

Ative a criação automática de índices

O Alibaba Cloud Elasticsearch impõe convenções de nomenclatura de índices. O índice de onboarding do APM, criado automaticamente pelo servidor APM, não segue essas convenções; portanto, é necessário permiti-lo explicitamente.

1. Faça login no console do Kibana. Consulte Fazer login no console do Kibana.

   Este guia utiliza um cluster V7.10. As etapas de login podem variar em outras versões do Elasticsearch.

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

3. Na aba Console, execute o comando a seguir. Substitua 7.10.2 pela versão do servidor APM instalada.

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

Visualize serviços monitorados

1. Clique em no ícone no canto superior esquerdo para expandir o painel de navegação.

2. Em Observability, clique em APM.

3. A aba Services lista todos os serviços monitorados pelo agente APM.

   

4. Clique em no nome de um serviço para detalhar seus rastreamentos, transações e dados de desempenho.