Execute a CLI de diagnóstico (nrdiag)

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.

Mude o diretório para o diretório raiz do aplicativo.
Execute o seguinte:
bash
```
$curl -Ls https://download.newrelic.com/nrdiag/scripts/install.sh | bash && sudo ./nrdiag CLI_OPTIONS
```
Recomendação: avalie sua resolução de problemas com um conjunto de tarefas (-suites) e carregue arquivos relevantes para sua conta New Relic com o sinalizador de anexo (-attach).

Mude o diretório para o diretório raiz do aplicativo.
Execute o seguinte:
```
[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; (New-Object System.Net.WebClient).DownloadFile("https://download.newrelic.com/nrdiag/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; & '.\nrdiag.exe' CLI_OPTIONS
```
Recomendação: avalie sua resolução de problemas com um conjunto de tarefas (-suites) e carregue arquivos relevantes para sua conta New Relic com o sinalizador de anexo (-attach).

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:

Certifique-se de ter a CLI de diagnóstico:
- Na linha de comando, altere o diretório para o diretório raiz do seu aplicativo e certifique-se de que o arquivo nrdiag.zip esteja presente.
  OU
- Baixe manualmente a versão mais recente.
Descompacte nrdiag.zip se necessário.
No diretório nrdiag_1.2.3/linux , mova nrdiag para o diretório raiz do aplicativo.
Execute nrdiag (junto com qualquer opção CLI
bash
```
$./nrdiag CLI_OPTIONS
```
A CLI do Diagnostics gera todos os problemas descobertos e faz upload de arquivos relevantes para sua conta New Relic se você incluir a sinalização -attach .

Certifique-se de ter a CLI de diagnóstico:
- Na linha de comando, altere o diretório para o diretório raiz do aplicativo e certifique-se de que o arquivo nrdiag.zip esteja presente.
  OU
- Baixe manualmente a versão mais recente.
Descompacte nrdiag.zip se necessário.
No diretório nrdiag_1.2.3/win , mova nrdiag.exe ou nrdiag_x64.exe para o diretório raiz do aplicativo.
Para resolver problemas no aplicativo web, verifique se você está executando o executável no diretório parent do seu projeto ou especifique o local do arquivo de configuração com a opção -c .
Execute o executável (juntamente com quaisquer opções CLI do diretório em que você colocou o binário. Como algumas verificações exigem permissões elevadas, para obter melhores resultados, execute a partir de um shell de administrador.
Execute via PowerShell se você adicionar qualquer CLI_OPTIONS:
bash
```
$./nrdiag.exe CLI_OPTIONS
```
OR, para sistemas x64:
bash
```
$./nrdiag_x64.exe CLI_OPTIONS
```
A CLI de diagnóstico gera todos os problemas descobertos e carrega arquivos relevantes para a conta New Relic se você incluir a sinalização -attach .

Certifique-se de ter a CLI de diagnóstico:
- Na linha de comando, altere o diretório para o diretório raiz do aplicativo e certifique-se de que o arquivo nrdiag.zip esteja presente.
  OU
- Baixe manualmente a versão mais recente.
Descompacte nrdiag.zip se necessário.
No diretório nrdiag_1.2.3/mac , mova nrdiag para o diretório raiz do aplicativo.
Execute nrdiag (junto com qualquer opção CLI
bash
```
$./nrdiag CLI_OPTIONS
```
A CLI do Diagnostics gera todos os problemas descobertos e faz upload de arquivos relevantes para sua conta New Relic se você incluir a sinalização -attach .

Certifique-se de ter a versão mais recente da CLI de diagnóstico. Se necessário, baixe manualmente a versão mais recente.
Descompacte nrdiag.zip se necessário.
No diretório do SO nrdiag_1.2.3/ , execute nrdiag (junto com quaisquer opções da CLI:
bash
```
$./nrdiag -browser-url WEBSITE_URL CLI_OPTIONS
```
A CLI do Diagnostics gera todos os problemas descobertos e faz upload de arquivos relevantes para sua conta New Relic se você incluir a sinalização -attach .

Para solucionar problemas do aplicativo New Relic-instrumento em execução em um contêiner docker , use o comando docker exec:

Baixe e descompacte o arquivo nrdiag_latest.zip .
Copie o binário para o contêiner. Substitua IMAGE_NAME pelo nome do contêiner docker :
bash
```
$docker cp nrdiag/linux/nrdiag IMAGE_NAME:/bin
```
Execute o comando nrdiag no contêiner docker . Substitua IMAGE_NAME conforme acima e substitua APPLICATION_ROOT pelo diretório raiz do seu aplicativo, onde você instalou o agente New Relic:
bash
```
$docker exec -it -w APPLICATION_ROOT IMAGE_NAME nrdiag
```
(Opcional) Remova o binário nrdiag quando terminar:
bash
```
$docker exec IMAGE_NAME rm /bin/nrdiag
```

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 :

bash

$./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:
bash
```
$./nrdiag_x64 -suites SUITE NAMES
```
Para sistemas ARM64:
bash
```
$./nrdiag_arm64 -suites SUITE NAMES
```

Windows:

Para executar no PowerShell, adicione ./ ao início de cmd.

Para sistemas de 32 bits:
bash
```
$nrdiag.exe -suites SUITE NAMES
```
Para sistemas de 64 bits:
bash
```
$nrdiag_x64.exe -suites SUITE NAMES
```
Para sistemas ARM64:
bash
```
$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:

bash

$./nrdiag_x64 -include /entire/directory/ -attach

Para sistemas ARM64:

bash

$./nrdiag_arm64 -include /entire/directory/ -attach

Windows:

Para executar no PowerShell, adicione ./ ao início de cmd.

Para sistemas de 32 bits:

bash

$nrdiag.exe -include Path\To\File -attach

Para sistemas de 64 bits:

bash

$nrdiag_x64.exe -include \Entire\Directory\ -attach

Para sistemas ARM64:

bash

$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.

Para sistemas de 64 bits:

bash

$./nrdiag_x64 -attach

bash

$./nrdiag_x64 -api-key ${API_KEY}

Para sistemas ARM64:

bash

$./nrdiag_arm64 -attach

bash

$./nrdiag_arm64 -api-key ${API_KEY}

Para executar no PowerShell, adicione ./ ao início de cmd.

Para sistemas de 32 bits:

bash

$nrdiag.exe -attach

bash

$nrdiag.exe -api-key ${API_KEY}

Para sistemas de 64 bits:

bash

$nrdiag_x64.exe -attach

bash

$nrdiag_x64.exe -api-key ${API_KEY}

Para sistemas ARM64:

bash

$nrdiag_arm64.exe -attach

bash

$nrdiag_arm64.exe -api-key ${API_KEY}

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.

bash

$./nrdiag -region eu ...

Esta tradução de máquina é fornecida para sua comodidade.

Instale e execute a CLI de diagnóstico

Linux

Windows

Procedimentos de instalação manual específicos da plataforma

Linux

Windows

Mac OS

Monitoramento de browser

Docker contêiner

Sinalizador de suítes (opção CLI altamente recomendada)

Roteiro

Saída de script

Resultados do script

Listar, visualizar e executar um script

Listar script disponível

Ver um script

Execute um script

Execute um script com argumentos

Execute um script junto com suítes

Incluir arquivos adicionais no zip

Carregar resultados para uma conta New Relic

Importante

Upload automático de conta

Linux e macOS

Windows

Seleção de região

Esta tradução de máquina é fornecida para sua comodidade.

Execute a CLI de diagnóstico (nrdiag)

Instale e execute a CLI de diagnóstico.css-21sua1{background:none;border:none;width:0;padding:0;}

Windows

Procedimentos de instalação manual específicos da plataforma

Linux

Windows

Mac OS

Monitoramento de browser

Docker contêiner

Sinalizador de suítes (opção CLI altamente recomendada)

Roteiro

Saída de script

Resultados do script

Listar, visualizar e executar um script

Listar script disponível

Ver um script

Execute um script

Execute um script com argumentos

Execute um script junto com suítes

Incluir arquivos adicionais no zip

Carregar resultados para uma conta New Relic

Importante

Upload automático de conta

Linux e macOS

Windows

Seleção de região

Instale e execute a CLI de diagnóstico