Instale e execute a CLI de diagnóstico
A CLI de diagnóstico pode ser instalada e executada com um único comando no Linux e no Windows. Este método de instalação fará download do binário da CLI de diagnóstico para o diretório de trabalho atual. A CLI de diagnóstico pesquisa automaticamente em seu diretório raiz e subdiretórios arquivos de configuração do agente e outros dados relevantes.
Procedimentos de instalação manual específicos da plataforma
Para instalar e executar manualmente a CLI de diagnóstico, siga os procedimentos para sua plataforma:
Sinalizador de suítes (opção CLI altamente recomendada)
Um conjunto é uma coleção de verificações de integridade que tratam de produtos ou problemas específicos. Usar um conjunto pode ajudar a estreitar o escopo da resolução de problemas e reduzir a ocorrência de falso positivo.
Para revisar uma lista de pacotes disponíveis, execute a CLI de diagnóstico com a opção -help suites
:
./nrdiag -help suites
Para executar conjuntos com nrdiag
, forneça o sinalizador -suites
e um ou mais nomes de conjuntos (por exemplo, java
) para serem executados como argumentos.
Linux and macOS:
Para sistemas de 64 bits:
./nrdiag_x64 -suites SUITE NAMESPara sistemas ARM64:
./nrdiag_arm64 -suites SUITE NAMES
Windows:
Para executar no PowerShell, adicione ./
ao início de cmd
.
Para sistemas de 32 bits:
nrdiag.exe -suites SUITE NAMESPara sistemas de 64 bits:
nrdiag_x64.exe -suites SUITE NAMESPara sistemas ARM64:
nrdiag_arm64.exe -suites SUITE NAMES
Roteiro
Script fornece uma fonte de dados adicional para informações que não são coletadas por uma tarefa. O catálogo de scripts disponíveis pode ser encontrado no repositório github do Diagnostic CLI.
Saída de script
A saída do script é impressa na tela e salva em um arquivo baseado no nome do script (por exemplo, name-of-script.out
). Isso é salvo no diretório especificado por -output-path
, sendo o padrão o diretório atual.
O script também pode enviar arquivos para o diretório de trabalho atual ou para o diretório especificado por -output-path
. Todos os arquivos de saída estão incluídos no zip de resultados no diretório ScriptOutput/
.
Resultados do script
Os resultados da execução de um script podem ser encontrados no arquivo nrdiag-output.json
com o seguinte esquema:
"Script": { "Name": "example", "Description": "Example Description", "Output": "example output", "OutputFiles": [ "/path/to/example.out", "/path/to/another-file.out" ], "OutputTruncated": false}
O campo Output
contém a saída stdout. Se tiver mais de 20.000 caracteres, ele será truncado e o campo OutputTruncated
será definido como true
. Mesmo se trucado, a saída completa ainda estará disponível no diretório ScriptOutput/
do arquivo zip.
Uma lista de arquivos criados pelo script pode ser encontrada no campo Outputfiles
.
Listar, visualizar e executar um script
Incluir arquivos adicionais no zip
Se você tiver arquivos adicionais que gostaria de compartilhar com o suporte, poderá incluí-los no arquivo nrdiag-output.zip
usando o sinalizador de linha de comando -include
. Isso pode ser usado com um único arquivo ou diretório. Se um diretório for fornecido, todos os seus subdiretórios serão incluídos. O limite de tamanho total dos arquivos incluídos é de 4 GB.
Use isso em combinação com -attach
para fazer upload dos arquivos para sua conta New Relic.
Linux and macOS:
Para sistemas de 64 bits:
./nrdiag_x64 -include /entire/directory/ -attachPara sistemas ARM64:
./nrdiag_arm64 -include /entire/directory/ -attach
Windows:
Para executar no PowerShell, adicione ./
ao início de cmd
.
Para sistemas de 32 bits:
nrdiag.exe -include Path\To\File -attachPara sistemas de 64 bits:
nrdiag_x64.exe -include \Entire\Directory\ -attachPara sistemas ARM64:
nrdiag_arm64.exe -include \Entire\Directory\ -attach
Carregar resultados para uma conta New Relic
Importante
Se o seu sistema não estiver configurado para conectar-se a endereços IP externos, este método não funcionará. Em vez disso, anexe os arquivos de saída em um e-mail para o suporte da New Relic.
Upload automático de conta
Para fazer upload dos resultados automaticamente para uma conta New Relic quando a CLI do Diagnostics for executada, use os sinalizadores de linha de comando -attach
ou -api-key
. O sinalizador -attach
validará quaisquer chaves de licença New Relic encontradas em seu ambiente e fará upload da execução para a conta associada à chave de licença. Como alternativa, o sinalizador -api-key
usará o fornecido para fazer upload da execução, independentemente da presença de uma chave de licença válida.
O upload dos seus resultados para uma conta fará o upload automático do conteúdo de nrdiag-output.json
e nrdiag-output.zip
.
Seleção de região
Por padrão, a CLI do Diagnostics carrega os resultados para contas New Relic hospedadas no data center dos EUA. Se sua conta estiver hospedada no data center da UE, adicione -region eu
ao comando.
./nrdiag -region eu ...