Ejecute la CLI de diagnóstico (nrdiag)

Instale y ejecute la CLI de diagnóstico

La CLI de diagnóstico se puede instalar y ejecutar con un solo comando en Linux y Windows. Este método de instalación descargará el binario de la CLI de diagnóstico al directorio de trabajo actual. La CLI de diagnóstico busca automáticamente en su directorio raíz y subdirectorios archivos de configuración del agente y otros datos relevantes.

Cambie el directorio al directorio raíz de la aplicación.
Ejecute lo siguiente:
```
curl -Ls https://download.newrelic.com/nrdiag/scripts/install.sh | bash && sudo ./nrdiag CLI_OPTIONS
```
Recommendation:
Alcance su resolución de problemas con un conjunto de tareas (-suites) y cargue archivos relevantes a su cuenta de New Relic con la marca de archivo adjunto (-attach).

Cambie el directorio al directorio raíz de la aplicación.

Ejecute lo siguiente:

[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

Recommendation:

Alcance su resolución de problemas con un conjunto de tareas (-suites) y cargue archivos relevantes a su cuenta de New Relic con la marca de archivo adjunto (-attach).

Procedimientos de instalación manual específicos de la plataforma

Para instalar y ejecutar manualmente la CLI de diagnóstico, siga los procedimientos para su plataforma:

Asegúrese de tener la CLI de diagnóstico:
- Desde la línea de comando, cambie el directorio al directorio raíz de su aplicación y asegúrese de que el archivo nrdiag.zip esté presente.
  O
- Descargue manualmente la última versión.
Descomprima nrdiag.zip si es necesario.
Desde el directorio nrdiag_1.2.3/linux , mueva nrdiag al directorio raíz de la aplicación.
Ejecute nrdiag (junto con cualquier opción CLI
```
./nrdiag CLI_OPTIONS
```
La CLI de diagnóstico genera cualquier problema que descubre y carga archivos relevantes a su cuenta de New Relic si incluye la marca -attach .

Asegúrese de tener la CLI de diagnóstico:
- Desde la línea de comando, cambie el directorio al directorio raíz de la aplicación y asegúrese de que el archivo nrdiag.zip esté presente.
  O
- Descargue manualmente la última versión.
Descomprima nrdiag.zip si es necesario.
Desde el directorio nrdiag_1.2.3/win , mueva nrdiag.exe o nrdiag_x64.exe al directorio raíz de la aplicación.
Para la resolución de problemas de la aplicación web, asegúrese de ejecutar el ejecutable desde el directorio parent de su proyecto o especifique la ubicación del archivo de configuración con la opción -c .
Ejecute el ejecutable (junto con las opciones CLI del directorio donde colocó el archivo binario). Dado que algunas comprobaciones requieren permisos elevados, para obtener mejores resultados, ejecútelas desde un shell de administración.
Ejecute a través de PowerShell si agrega algún CLI_OPTIONS:
```
./nrdiag.exe CLI_OPTIONS
```
OR, para sistemas x64:
```
./nrdiag_x64.exe CLI_OPTIONS
```
La CLI de diagnóstico genera cualquier problema que descubre y carga archivos relevantes a la cuenta de New Relic si incluye la marca -attach .

Asegúrese de tener la CLI de diagnóstico:
- Desde la línea de comando, cambie el directorio al directorio raíz de la aplicación y asegúrese de que el archivo nrdiag.zip esté presente.
  O
- Descargue manualmente la última versión.
Descomprima nrdiag.zip si es necesario.
Desde el directorio nrdiag_1.2.3/mac , mueva nrdiag al directorio raíz de la aplicación.
Ejecute nrdiag (junto con cualquier opción CLI
```
./nrdiag CLI_OPTIONS
```
La CLI de diagnóstico genera cualquier problema que descubre y carga archivos relevantes a su cuenta de New Relic si incluye la marca -attach .

Asegúrese de tener la última versión de la CLI de diagnóstico. Si es necesario, descargue manualmente la última versión.
Descomprima nrdiag.zip si es necesario.
Desde el directorio del sistema operativo nrdiag_1.2.3/ , ejecute nrdiag (junto con las opciones de CLI:
```
./nrdiag -browser-url WEBSITE_URL CLI_OPTIONS
```
La CLI de diagnóstico genera cualquier problema que descubre y carga archivos relevantes a su cuenta de New Relic si incluye la marca -attach .

Para solucionar problemas de su aplicación instrumentada New Relic que se ejecuta en un contenedor docker , use el comando docker exec:

Descargue y descomprima el archivo nrdiag_latest.zip .
Copie el binario al contenedor. Reemplace IMAGE_NAME con el nombre de su contenedor docker :
```
docker cp nrdiag/linux/nrdiag IMAGE_NAME:/bin
```
Ejecute el comando nrdiag en el contenedor de la docker . Reemplace IMAGE_NAME como arriba y reemplace APPLICATION_ROOT con el directorio raíz de su aplicación, donde instaló el agente New Relic:
```
docker exec -it -w APPLICATION_ROOT IMAGE_NAME nrdiag
```
(Opcional) Elimine el binario nrdiag cuando haya terminado:
```
docker exec IMAGE_NAME rm /bin/nrdiag
```

Bandera de Suites (opción CLI muy recomendada)

Una suite es una colección de controles de salud que apuntan a productos o problemas específicos. El uso de una suite puede ayudar a limitar el alcance de la resolución de problemas y reducir la aparición de falsos positivos.

Para revisar una lista de suites disponibles, ejecute la CLI de diagnóstico con la opción -help suites :

./nrdiag -help suites

Para ejecutar conjuntos con nrdiag, proporcione la marca -suites y uno o más nombres de conjuntos (por ejemplo, java) para ejecutar como argumentos.

Linux and macOS:

Para sistemas de 64 bits:
```
./nrdiag_x64 -suites SUITE NAMES
```
Para sistemas ARM64:
```
./nrdiag_arm64 -suites SUITE NAMES
```

Windows:

Para ejecutar desde PowerShell, agregue ./ al inicio de cmd.

Para sistemas de 32 bits:
```
nrdiag.exe -suites SUITE NAMES
```
Para sistemas de 64 bits:
```
nrdiag_x64.exe -suites SUITE NAMES
```
Para sistemas ARM64:
```
nrdiag_arm64.exe -suites SUITE NAMES
```

Scripts

El script proporciona una fuente de datos adicional para información que no se recopila mediante una tarea. El catálogo de scripts disponibles se puede encontrar en el repositorio github de la CLI de diagnóstico.

Salida script

La salida del script se imprime en la pantalla y se guarda en un archivo según el nombre del script (por ejemplo, name-of-script.out). Esto se guarda en el directorio especificado por -output-path, de forma predeterminada es el directorio actual.

El script también puede generar archivos, ya sea en el directorio de trabajo actual o en el directorio especificado por -output-path. Todos los archivos de salida se incluyen en el zip de resultados en el directorio ScriptOutput/ .

Resultados script

Los resultados de ejecutar un script se pueden encontrar en el archivo nrdiag-output.json con el siguiente esquema:

"Script": {
    "Name": "example",
    "Description": "Example Description",
    "Output": "example output",
    "OutputFiles": [
        "/path/to/example.out",
        "/path/to/another-file.out"
    ],
    "OutputTruncated": false
}

El campo Output contiene la salida estándar. Si tiene más de 20.000 caracteres, se trunca y el campo OutputTruncated se establece en true. Incluso si se trunca, el resultado completo todavía está disponible en el directorio ScriptOutput/ del archivo zip.

Puede encontrar una lista de archivos que creó el script en el campo Outputfiles .

Enumerar, ver y ejecutar un script

Incluir archivos adicionales en el zip

Si tiene archivos adicionales que le gustaría compartir con el soporte, puede incluirlos en el archivo nrdiag-output.zip usando la marca de línea de comando -include . Esto se puede utilizar con un solo archivo o un directorio. Si se proporciona un directorio, se incluyen todos sus subdirectorios. El límite de tamaño total de los archivos incluidos es de 4 GB.

Utilízalo en combinación con -attach para cargar los archivos en tu cuenta de New Relic.

Linux and macOS:

Para sistemas de 64 bits:

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

Para sistemas ARM64:

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

Windows:

Para ejecutar desde PowerShell, agregue ./ al inicio de cmd.

Para sistemas de 32 bits:

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

Para sistemas de 64 bits:

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

Para sistemas ARM64:

nrdiag_arm64.exe -include \Entire\Directory\ -attach

Cargar resultados a una cuenta New Relic

Importante

Si su sistema no está configurado para conectarse a direcciones IP externas, este método no funcionará. En su lugar, adjunte los archivos de salida en un correo electrónico al soporte de New Relic.

Carga automática de cuenta

Para cargar sus resultados automáticamente a una cuenta de New Relic cuando se ejecuta la CLI de Diagnóstico, utilice los indicadores de línea de comando -attach o -api-key . La bandera -attach validará cualquier clave de licencia de New Relic que se encuentre en su entorno y cargará la ejecución en la cuenta asociada con la clave de licencia. Alternativamente, la bandera -api-key utilizará el proporcionado para cargar la ejecución, independientemente de la presencia de una clave de licencia válida.

Al cargar sus resultados en una cuenta, se cargarán automáticamente los contenidos de nrdiag-output.json y nrdiag-output.zip.

Para ejecutar desde PowerShell, agregue ./ al inicio de cmd.

Para sistemas de 32 bits:

nrdiag.exe -attach

nrdiag.exe -api-key ${API_KEY}

Para sistemas de 64 bits:

nrdiag_x64.exe -attach

nrdiag_x64.exe -api-key ${API_KEY}

Para sistemas ARM64:

nrdiag_arm64.exe -attach

nrdiag_arm64.exe -api-key ${API_KEY}

Selección de región

De forma predeterminada, la CLI de Diagnóstico carga los resultados en las cuentas de New Relic alojadas en el centro de datos de EE. UU. Si su cuenta está alojada en el centro de datos de la UE, asegúrese de agregar -region eu al comando.

./nrdiag -region eu ...

Te ofrecemos esta traducción automática para facilitar la lectura.

Ejecute la CLI de diagnóstico (nrdiag)

Instale y ejecute la CLI de diagnóstico

Linux

Windows

Procedimientos de instalación manual específicos de la plataforma

Linux

Windows

Mac OS

monitoreo del navegador

Contenedor docker

Bandera de Suites (opción CLI muy recomendada)

Scripts

Salida script

Resultados script

Enumerar, ver y ejecutar un script

Listar script disponible

Ver un script

Ejecutar un script

Ejecutar un script con argumentos

Ejecute un script junto con suites

Incluir archivos adicionales en el zip

Cargar resultados a una cuenta New Relic

Importante

Carga automática de cuenta

Linux y macOS

Windows

Selección de región

Te ofrecemos esta traducción automática para facilitar la lectura.

Ejecute la CLI de diagnóstico (nrdiag)

Instale y ejecute la CLI de diagnóstico.css-21sua1{background:none;border:none;width:0;padding:0;}

Windows

Procedimientos de instalación manual específicos de la plataforma

Linux

Windows

Mac OS

monitoreo del navegador

Contenedor docker

Bandera de Suites (opción CLI muy recomendada)

Scripts

Salida script

Resultados script

Enumerar, ver y ejecutar un script

Listar script disponible

Ver un script

Ejecutar un script

Ejecutar un script con argumentos

Ejecute un script junto con suites

Incluir archivos adicionales en el zip

Cargar resultados a una cuenta New Relic

Importante

Carga automática de cuenta

Linux y macOS

Windows

Selección de región

Instale y ejecute la CLI de diagnóstico