Visão geral da instalação guiada

Se ainda não o fez, cadastre-se para obter uma conta gratuita New Relic para poder instrumentar seus sistemas e enviar dados de telemetria para a New Relic. Nossa instalação guiada cria um comando CLI personalizado para o seu ambiente que baixa e instala a CLI do New Relic e o agente de infraestrutura. Recomendamos que você consulte nosso guia de práticas recomendadas de monitoramento de infraestrutura antes de começar.

Pronto para começar? Clique no botão Guided install. Ou, se sua organização estiver localizada em um data center da UE, clique em EU Guided install. Ou, se sua organização estiver localizada em um data center do JP, clique em JP Guided install.

Nossa instalação guiada descobre o aplicativo, a infraestrutura e as fontes log em execução no seu ambiente e recomenda quais devem ser instrumentados. A instalação automatiza a configuração e implantação de cada sistema que você escolher como instrumento.

Por que isso importa

Com nossa instalação guiada, você pode instrumentar seu aplicativo e infraestrutura e começar a ver seus dados no New Relic em minutos.

A instalação guiada usa nossa interface de linha de comando (CLI), o agente de infraestrutura para seu ambiente host e uma biblioteca de receitas de instalação para instrumentar seu aplicativo e infraestrutura para você. Isso significa menos trabalho para você.

Como nossas receitas de instrumentação são de código aberto, você pode modificar receitas existentes ou criar novas, para atender às suas necessidades.

Sinalizadores CLI

Personalize e depure sua instalação com sinalizadores CLI. Use o sinalizador "assumir sim" -y para instalação automatizada com padrões razoáveis, altere o detalhamento da saída com --debug ou --trace, adicione tag ou use receitas de instalação personalizadas. Você pode encontrar uma lista completa de opções disponíveis em nosso repositório de código aberto no GitHub.

Alguns detalhes técnicos

A instalação guiada New Relic utiliza receitas de instalação de código aberto para instrumento de integração no host. Essas receitas incluem comandos de instalação e setup, informações de log e metadados relacionados ao que está sendo instalado. Eles são escritos no formato YAML para cada tipo de sistema a ser instrumentado e possuem todos os detalhes de instalação necessários para instalar o agente de infraestrutura para uma integração específica. Informações adicionais estão disponíveis em nosso repositório de código aberto no GitHub.

Receitas

A instalação guiada automatiza a descoberta, configuração e instalação do agente e integração New Relic . No entanto, pode haver momentos em que você queira instrumentá-los um por um usando o comando de instalação CLI.

Para instalar qualquer agente e integração individual, você usaria um comando semelhante ao seguinte, que especifica o tipo de integração que deseja instalar. Esta é a sintaxe do Linux:

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n INSERT_THE_RECIPE_NAME

Por exemplo, para instalar a integração Apache:

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID /usr/local/bin/newrelic install -n apache-open-source-integration

Esta é a sintaxe do Windows:

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; (New-Object System.Net.WebClient).DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install

Nosso código aberto agente e integração envia métricas de desempenho e dados de inventário de seus servidores e aplicativo para a plataforma New Relic . Você pode visualizar dashboardspredefinidos de seus dados métricos, criar políticas de alertas e criar suas próprias consultas e gráficos personalizados.

A tabela abaixo lista o agente e integração suportados pelo comando CLI instalação guiada. Os comandos específicos de integração no host são fornecidos para sua referência:

Instale versões específicas do agente de infraestrutura

A CLI agora oferece suporte à instalação de versões específicas do agente de infraestrutura. Este recurso é particularmente útil para ambientes que exigem consistência na implantação ou precisam manter compatibilidade com sistemas específicos.

Por padrão, se você não especificar uma versão, a CLI instalará automaticamente a versão mais recente disponível do agente de infraestrutura. Para instalar uma versão específica, anexe o número da versão ao nome da receita usando o símbolo @ :

$
newrelic install -n infrastructure-agent-installer@X.XX.X

Onde X.XX.X representa o número da versão (por exemplo, 1.64.0). Para encontrar as versões disponíveis do agente de infraestrutura e seus detalhes de lançamento, consulte as notas de lançamento do agente de infraestrutura.

Para Linux:

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n infrastructure-agent-installer@1.64.0

Para Windows:

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; (New-Object System.Net.WebClient).DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n infrastructure-agent-installer@1.62.0

Use uma chave de licença específica

Por padrão, a CLI usa sua chave de usuário para buscar a chave de licença da sua conta, e as receitas configuram agentes e integrações com essa chave. Para usar uma chave de licença diferente, defina a variável de ambiente NEW_RELIC_LICENSE_KEY como uma chave de licença de ingestão.

Para Linux:

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION NEW_RELIC_LICENSE_KEY=INSERT_YOUR_LICENSE_KEY /usr/local/bin/newrelic install -n INSERT_THE_RECIPE_NAME

Para Windows:

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; (New-Object System.Net.WebClient).DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; $env:NEW_RELIC_LICENSE_KEY='INSERT_YOUR_LICENSE_KEY'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install

Solucionar problemas comuns

À medida que identificamos áreas onde a instalação guiada falha, iremos documentá-las aqui e fornecer algumas orientações sobre resolução de problemas.

$
sudo mysql -e "CREATE USER 'newrelic'@'localhost' IDENTIFIED BY 'YOUR_SELECTED_PASSWORD';"

$
sudo mysql -e "GRANT REPLICATION CLIENT ON *.* TO 'newrelic'@'localhost' WITH MAX_USER_CONNECTIONS 5;"

$
sudo mysql -e "GRANT SELECT ON *.* TO 'newrelic'@'localhost' WITH MAX_USER_CONNECTIONS 5;"