Você pode pedir a um agente de programação de IA, como Claude Code, Cursor, GitHub Copilot ou Codex, para adicionar o New Relic ao seu projeto. O agente lê nossa documentação de instalação, determina qual agente do New Relic o seu projeto precisa e faz as alterações para você.
Antes de você começar
- Conta New Relic — Se você não tiver uma, inscreva-se para obter uma conta New Relic.
- Chave de licença — Você precisará da sua . Para encontrá-la, consulte Chave de licença.
Importante
Mantenha sua chave de licença fora do contexto do agente. Não a cole no chat. Configure-a você mesmo como a variável de ambiente NEW_RELIC_LICENSE_KEY onde seu aplicativo é executado.
Copie este prompt
Abra o seu agente de codificação de IA na pasta do seu projeto e cole este prompt:
Dica
Siga as instruções em https://docs.newrelic.com/docs/new-relic-solutions/get-started/install-with-ai.md para adicionar o New Relic a este projeto.
Após a execução do agente, verifique quais arquivos ele alterou e confirme se os dados estão chegando ao New Relic.
Instruções para agentes de IA
Se você for um agente de IA instalando o New Relic, siga estas etapas:
Encontre a stack: observe os arquivos do projeto, como
package.json,pom.xml,build.gradle,requirements.txt,pyproject.toml,go.mod,*.csproj,composer.json,Gemfile,Dockerfile, manifestos do Kubernetes ou Helm charts. Se a stack não estiver clara, pergunte ao usuário o que monitorar.Escolha o guia de instalação: escolha o guia correspondente nos guias de instalação abaixo. Para um URL em
/docs/, adicione.mdao final para obter uma versão em markdown.Mantenha a chave de licença fora do seu contexto: a chave é um segredo. Você nunca precisa do valor dela.
- Não solicite a chave ao usuário. Se o usuário a colar no chat, oriente-o a revogá-la e criar uma nova.
- Faça referência à chave apenas pelo nome
NEW_RELIC_LICENSE_KEY. Caso um guia coloque a chave em um arquivo de configuração, em vez disso, leia-a dessa variável de ambiente. - Não execute comandos nem leia arquivos que mostrariam a chave, como arquivos
env,printenv,echo $NEW_RELIC_LICENSE_KEY,.envou armazenamentos de segredos. - Execute
test -n "$NEW_RELIC_LICENSE_KEY" && echo set || echo missingpara verificar se a chave está configurada sem expô-la.
Siga o guia:
- Peça ao usuário um nome de aplicativo ou sugira um com base no nome do projeto.
- Se a conta do usuário estiver na região de data center da UE ou do JP, use os endpoints que o guia fornece para essa região.
Verifique: Peça ao usuário para definir
NEW_RELIC_LICENSE_KEYe reiniciar o aplicativo, em seguida, siga Verificar a instalação. Se nenhum dado aparecer, consulte a página de resolução de problemas listada para essa tecnologia.Resuma: Informe ao usuário quais arquivos você alterou e onde encontrar o aplicativo dele no New Relic: APM & Services para aplicativos, Browser ou Mobile para frontends e Infrastructure para hosts.
Verifique a instalação
Verifique em duas etapas: primeiro se o agente está em execução, depois se os dados dele chegaram ao New Relic.
Verifique se o agente está em execução
Essas verificações não precisam de acesso à conta do New Relic do usuário. Ao ler logs, pesquise por linhas específicas em vez de imprimir arquivos inteiros.
Tecnologia | Verificar |
|---|---|
Agentes APM | Pesquise erros no log do agente. Os agentes Java e Ruby registram |
Python | Execute |
Kubernetes | Execute |
Hosts Linux | Execute |
Navegador web | Carregue uma página e verifique se o código-fonte dela contém o trecho |
Verifique se os dados chegaram ao New Relic
Execute a consulta para a tecnologia que você instalou, substituindo cada espaço reservado pelo valor que você configurou. Os dados podem levar alguns minutos para aparecer, e algumas consultas só retornam resultados depois que o aplicativo processa tráfego.
Tecnologia | Consulta |
|---|---|
Agentes APM |
|
Qualquer aplicativo APM, após o tráfego |
|
Docker |
|
Kubernetes |
|
Anfitriões |
|
Navegador da web, após o carregamento de uma página |
|
Mobile, após uma sessão |
|
Uma contagem acima de zero significa que os dados estão fluindo. Existem duas maneiras de executar uma consulta, e nenhuma delas expõe um segredo a você:
- Peça ao usuário para colar isso no criador de consulta no New Relic e informar o resultado.
- Use a CLI do New Relic se o usuário a tiver instalado e definido uma como a variável de ambiente
NEW_RELIC_API_KEY. Executenewrelic nrql query --accountId ACCOUNT_ID --query 'QUERY'. A chave de API do usuário também é um segredo, portanto, trate-a da mesma forma que a chave de licença.
Guias de instalação
Aplicativos e serviços
Cada entrada tem um link para o guia de instalação dessa linguagem, com um link de resolução de problemas caso nenhum dado seja exibido.
Tecnologia | Guia de instalação | Se nenhum dado aparecer |
|---|---|---|
Node.js | ||
Java | ||
Python | ||
.NET | ||
Go | ||
PHP | ||
Ruby | ||
C e C++ | ||
OpenTelemetry |
Contêineres e serverless
Os guias a seguir abrangem workloads em contêineres e funções serverless.
Tecnologia | Guia de instalação |
|---|---|
Docker | |
Cluster do Kubernetes | |
Aplicativos no Kubernetes | |
AWS Lambda |
Frontends
Os guias a seguir abrangem o monitoramento de navegadores e de aplicativos móveis.
Tecnologia | Guia de instalação |
|---|---|
Navegador web | |
iOS | |
Android |
Anfitriões
Os guias a seguir abordam o agente de infraestrutura para hosts Linux e Windows.
Tecnologia | Guia de instalação |
|---|---|
Linux | Instale o agente de infraestrutura com um gerenciador de pacote |
Windows |
Para qualquer item não listado aqui, consulte a instalação manual do New Relic.