Após a instalação do agente em uma aplicação Go, o Application Real-Time Monitoring Service (ARMS) inicia o monitoramento. É possível visualizar dados como topologia da aplicação, pilhas de chamadas e análise de SQL. Este tópico descreve como instalar manualmente o agente para uma aplicação Go.
Para aplicações implantadas em ambiente Kubernetes, não instale o agente manualmente. Em vez disso, instale o componente para conexão com o ARMS. Para mais informações, consulte Instalar o agente Go para Container Service for Kubernetes (ACK) e Container Compute Service (ACS) usando o componente ack-onepilot.
Em caso de dúvidas sobre o agente Go, entre em contato conosco pelo grupo de perguntas e respostas do DingTalk (ID: 159215000379).
Pré-requisitos
Garanta que o ambiente de compilação tenha conexão com a internet ou com uma rede interna da Alibaba Cloud. O grupo de segurança do ambiente deve permitir tráfego TCP de saída nas portas 8080, 9990, 80 e 443.
Verifique o ambiente de rede. Para mais informações, consulte Configurações de rede para monitoramento de aplicações Go.
Confira o sistema operacional, a arquitetura, a versão do Go e a versão do framework do ambiente de compilação. Para mais detalhes, consulte Componentes e frameworks Go suportados pelo ARMS Application Monitoring.
Etapa 1: Compilar a imagem da aplicação Golang
-
(Opcional) Se o projeto utilizar o modo vendor para compilação ou se os parâmetros de compilação incluírem
-mod=vendor, verifique o seguinte:-
Verifique se o arquivo go.mod contém a dependência
google.golang.org/protobuf, direta ou indiretamente. Caso contrário, siga as instruções abaixo: Confira se os parâmetros de compilação incluem
-mod=vendor. Caso não incluam, adicione-mod=vendorapósgo build.
-
-
Use o comando
wgetpara baixe a ferramenta de compilação instgo. Selecione o endereço de download conforme o ambiente de compilação e a região da máquina.O instgo é atualizado automaticamente durante a compilação. Salve-o em uma pasta onde você tenha permissões de modificação.
NotaO Instgo é uma ferramenta de compilação fornecida pelo ARMS para aplicações Go. Após compilar o projeto Go com o instgo, o ARMS poderá monitorar a aplicação.
A ferramenta de compilação é a mesma para todas as regiões. Se o ambiente puder acessar o Object Storage Service (OSS) pela internet, use o endereço de download público da China (Hangzhou) correspondente ao sistema operacional e à arquitetura.
-
Conceda permissões de execução à ferramenta de compilação.
Linux/Mac
# Grant executable permissions chmod +x instgoWindows
Não são necessárias permissões de execução no Windows.
-
Obtenha a LicenseKey e configure os parâmetros de compilação.
ImportanteSe esta etapa for ignorada, o instgo entrará no modo de desenvolvimento e instalará a versão mais recente do agente ARMS por padrão. Para implantar a aplicação em ambiente de produção, configure os seguintes parâmetros.
-
Obtenha a LicenseKey chamando a operação OpenAPI DescribeTraceLicenseKey.
Na página DescribeTraceLicenseKey, clique em Debug. Selecione uma região e clique em Initiate Call para obter a LicenseKey.
-
Após obter a LicenseKey, use o comando
setpara defina os parâmetros de compilação.instgo set --licenseKey=${YourLicenseKey}
-
-
Adicione
instgocomo prefixo ao comando de compilação original e execute-o.instgo go build {arg1} {arg2} {arg3}Se usar
go installpara compilar o projeto, também é possível adicionarinstgocomo prefixo ao comando. Crie a imagem usando o arquivo binário compilado na etapa anterior.
Etapa 2: Configurar variáveis de ambiente
-
Após a compilação, adicione manualmente as seguintes variáveis de ambiente à aplicação Go:
export ARMS_ENABLE=true export ARMS_APP_NAME=xxx # Application name. export ARMS_REGION_ID=xxx # The region ID of your Alibaba Cloud account. export ARMS_LICENSE_KEY=xxx # The LicenseKey obtained in Step 1. -
Alternativamente, em vez de usar
exportpara expor variáveis de ambiente, especifique-as durante a compilação usandoldflags.Substitua
modulepelo nome do módulo no arquivo go.mod. Os outros parâmetros correspondem às variáveis de ambiente listadas acima.instgo go build -ldflags " -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.ArmsApmName=${appName}' -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.ArmsEnable=true' -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.LicenseKey=${licenseKey}' -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.RegionId=${regionId}'"
(Opcional) Referência de instalação Docker
Em ambientes Docker, modifique o Dockerfile com base no exemplo a seguir.
### .....
ENV ARMS_ENABLE=true
ENV ARMS_APP_NAME={AppName}
ENV ARMS_REGION_ID={regionId}
ENV ARMS_LICENSE_KEY={licenseKey}
### Add your custom Dockerfile logic below.
### ......Verificar os resultados
Após cerca de um minuto, acesse a página no console do ARMS. Se a aplicação Go aparecer na página e houver dados de monitoramento reportados, a instalação do agente foi bem-sucedida.
