Go é uma linguagem compilada com um tempo de execução opaco, o que a torna incapaz de oferecer suporte à instrumentação automática como outras linguagens. Por esse motivo, o agente New Relic Go foi projetado como um SDK. Como o agente Go é um SDK, ele requer mais trabalho manual para configurar do que o agente para linguagens que suportam instrumentação automática.
Em um esforço para facilitar a instrumentação, a equipe do agente Go criou a ferramenta de instrumentação fácil do Go. Essa ferramenta faz a maior parte do trabalho para você, sugerindo alterações no seu código-fonte que instrumentam sua aplicação com o agente Go da New Relic.
Como funciona
Esta ferramenta não interfere na operação do seu aplicativo e não faz nenhuma alteração diretamente no seu código. Veja o que acontece:
- Ele analisa seu código e sugere alterações que permitem que o agente Go capture dados de telemetria.
- Você revisa as alterações no arquivo
.diffe decide quais alterações adicionar ao seu código-fonte.
Como parte da análise, esta ferramenta pode invocar go get ou outros comandos da cadeia de ferramentas da linguagem Go que podem modificar seu arquivo go.mod , mas não seu código-fonte real.
O que é instrumentado?
O escopo do que esta ferramenta pode instrumentar em seu aplicativo é limitado a estas ações:
- Capturando erros em qualquer função encapsulada ou rastreada por uma transação
- Detecte qualquer instrumentação da New Relic existente e sugira alterações ao seu código-fonte com base no código da New Relic já existente
- Rastreando funções definidas localmente que são invocadas no método
main()do aplicativo com uma transação - Rastreando funções assíncronas e literais de função com um segmento assíncrono
- Adicionando middleware à biblioteca suportada para rastreamento
- Injetando distributed tracing no tráfego externo
Bibliotecas suportadas
- biblioteca padrão
- net/http
- gin
- gRPC
- gochi
- mysql
- slog
instalação
Antes de iniciar as etapas de instalação abaixo, certifique-se de ter uma versão do Go instalada que esteja dentro da janela de suporte para o ciclo de vida atual da linguagem de programação Go.
Instalar instrumentação Go easy:
$go install github.com/newrelic/go-easy-instrumentation@latestgeração de sugestões
A ferramenta de instrumentação fácil do Go fornece sugestões para instrumentar sua aplicação Go. Revise cuidadosamente o arquivo diff gerado para verificar a correção da instrumentação.
Gerar sugestões de instrumentação
Esta ferramenta funciona melhor com o Git. Recomendamos que você verifique se sua aplicação está em uma branch sem alterações não preparadas antes de aplicar qualquer uma das alterações sugeridas. Após verificar isso, siga estas etapas para gerar, revisar e aplicar as alterações que instalam o agente Go da New Relic em uma aplicação:
- Execute o seguinte comando CLI para criar um arquivo chamado
new-relic-instrumentation.diffno seu diretório de trabalho:bash$go-easy-instrumentation instrument ../my-application/ - Abra o arquivo
.diffe verifique ou corrija o conteúdo. - Quando estiver satisfeito com as sugestões de instrumentação, salve o arquivo e aplique as alterações:bash$mv new-relic-instrumentation.diff ../my-application/$cd ../my-application$git apply new-relic-instrumentation.diff
Depois que as alterações forem aplicadas, o aplicativo deverá ser executado com o agente New Relic Go instalado. Se a instalação do agente não estiver funcionando da maneira que você deseja, você pode recuperá-la facilmente usando comandos comuns do Git. Por exemplo, você pode tentar um dos seguintes:
- Guarde as mudanças com
git stash - Reverter o código para um commit anterior
Qual é o próximo?
Se você tiver alguma sugestão ou encontrar problemas, crie um problema no Github.