Container Service for Kubernetes:Go application monitoring

Pré-requisitos

• Crie um cluster ACK. Recomendamos o uso de um cluster gerenciado ACK. Para obter instruções, consulte Create an ACK managed cluster.

  A criação de novos clusters dedicados ACK foi descontinuada, mas os clusters dedicados existentes continuam com suporte. Para mais informações, consulte Create an ACK dedicated cluster (discontinued).

• Sua aplicação Go usa a versão 1.18 ou posterior.

• Você ativou o activated ARMS.

  O ARMS é um service de gerenciamento de desempenho de aplicações (APM) da Alibaba Cloud. Para saber mais sobre o ARMS, consulte What is ARMS? e What is Application Monitoring?.

Etapa 1: Instalar o ack-onepilot, o add-on de monitoramento de aplicações do ARMS

1. Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, clique em no nome do seu cluster. No painel de navegação à esquerda, clique em Components and Add-ons.

Etapa 2: Compilar o arquivo binário Go e criar a imagem do container

Use a ferramenta de build aprimorada instgo junto com um ambiente de build Go local (Go 1.18 ou posterior) para compilar seu programa Go em um arquivo binário que envia dados de monitoramento ao ARMS.

1. (Opcional) Se o projeto incluir um diretório vendor durante o build, adicione -mod=vendor após go build.

2. Execute o comando wget para baixar a ferramenta de build instgo.

   Durante o processo de build, o instgo é atualizado automaticamente. Salve o instgo em um diretório onde o usuário do build tenha permissões de escrita.

   Nota

   O instgo é uma ferramenta de build do ARMS que instrumenta seu projeto Go, permitindo que o ARMS monitore sua aplicação.

   Se o ambiente de build tiver acesso à internet para o Object Storage Service (OSS), selecione a URL de download via internet de China (Hangzhou) correspondente ao sistema operacional e à arquitetura do ambiente.

   Comandos de download

   Linux (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo

   Linux (ARM64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-arm64" -O instgo

   Mac (ARM64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-darwin-arm64" -O instgo

   Mac (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-darwin-amd64" -O instgo

   Windows (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-windows-amd64.exe" -O instgo.exe

3. Torne a ferramenta de build executável.

   Linux/Mac

   # Grant the executable permission.
   chmod +x instgo

   Windows

   No Windows, não é necessário conceder permissão de execução.

4. (Opcional) Configure um UID como parâmetro de build.

   Importante

   Se você pular esta etapa, o instgo instalará a versão mais recente do agente ARMS por padrão.

   Configurar um UID requer o instgo 1.4.5 ou posterior. Use o comando set para definir um UID como parâmetro de build.

   # The UID is the ID of your Alibaba Cloud primary account.
   instgo set --uid={YourAliyunUid}

5. Adicione instgo como prefixo ao comando de build original e execute-o.

   instgo go build {arg1} {arg2} {arg3}

   Se usar go install para compilar o projeto, também adicione instgo como prefixo ao comando de build original.

6. Use o arquivo binário gerado na etapa anterior para criar a imagem do container.

Etapa 3: Ativar o monitoramento de aplicações do ARMS para sua aplicação Go

1. Faça login no console ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, clique em no nome do seu cluster. No painel de navegação à esquerda, escolha Workloads > Deployments.

3. Na página Deployments, localize sua aplicação e clique em Edit YAML na coluna Actions.

4. No arquivo yaml, adicione as seguintes labels no nível spec.template.metadata.

   labels:
     aliyun.com/app-language: golang # Required for Go applications. This indicates that this is a Go application.
     armsPilotAutoEnable: 'on'
     armsPilotCreateAppName: "<YOUR-DEPLOYMENT-NAME>"    # Replace <YOUR-DEPLOYMENT-NAME> with your application name.

Etapa 4: Visualizar detalhes do monitoramento

1. Após cerca de um minuto, acesse o console ARMS. No painel de navegação à esquerda, escolha Application Monitoring > Applications para visualizar a aplicação Go e os dados enviados por ela.

   Uma aplicação chamada otel-go-server aparecerá na lista de aplicações. Um status verde indica que a aplicação está funcionando normalmente. Verifique métricas de monitoramento, como requisições por segundo, taxa de erro e tempo médio de resposta, para confirmar o envio dos dados.

2. Na coluna Application Name, clique em no nome da sua aplicação para acessar a página de monitoramento de aplicações no console ARMS e visualizar os detalhes. Para mais informações, consulte Application overview.

(Opcional) Etapa 5: Liberar recursos

Se não precisar mais monitorar a aplicação, desinstale o agente ARMS. Para mais informações, consulte Uninstall the ARMS agent for Go.

Documentos relacionados

Para conectar aplicações Java ou Python em um cluster ACK ao monitoramento de aplicações do ARMS, consulte Java application monitoring e Python application monitoring.