진단 CLI(nrdiag) 실행

진단 CLI 설치 및 실행

진단 CLI는 Linux 및 Windows에서 단일 명령으로 설치하고 실행할 수 있습니다. 이 설치 방법은 진단 CLI 바이너리를 현재 작업 디렉터리에 다운로드합니다. 진단 CLI는 에이전트 구성 파일 및 기타 관련 데이터에 대한 루트 디렉터리 및 하위 디렉터리를 자동으로 검색합니다.

디렉토리를 애플리케이션의 루트 디렉토리로 변경합니다.
다음을 실행합니다.
```
curl -Ls https://download.newrelic.com/nrdiag/scripts/install.sh | bash && sudo ./nrdiag CLI_OPTIONS
```
권장 사항: 작업 세트 (-suites)로 문제 해결 범위를 지정하고 첨부 플래그 (-attach)를 사용하여 New Relic 계정에 관련 파일을 업로드하십시오.

디렉토리를 애플리케이션의 루트 디렉토리로 변경합니다.

다음을 실행합니다.

[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

권장 사항: 작업 세트 (-suites)로 문제 해결 범위를 지정하고 첨부 플래그 (-attach)를 사용하여 New Relic 계정에 관련 파일을 업로드하십시오.

플랫폼별 수동 설치 절차

진단 CLI를 수동으로 설치하고 실행하려면 플랫폼에 대한 절차를 따르십시오.

진단 CLI가 있는지 확인하십시오.
- 명령줄에서 디렉터리를 애플리케이션의 루트 디렉터리로 변경하고 nrdiag.zip 파일이 있는지 확인합니다.
  또는
- 최신 버전을 수동으로 다운로드합니다 .
필요한 경우 nrdiag.zip 의 압축을 풉니다.
nrdiag_1.2.3/linux 디렉토리에서 nrdiag 을 애플리케이션의 루트 디렉토리로 이동합니다.
모든 CLI 옵션 과 함께 nrdiag 실행
```
./nrdiag CLI_OPTIONS
```
진단 CLI는 발견한 모든 문제를 출력하고 -attach 플래그를 포함하는 경우 관련 파일을 New Relic 계정에 업로드합니다.

진단 CLI가 있는지 확인하십시오.
- 명령줄에서 디렉터리를 애플리케이션의 루트 디렉터리로 변경하고 nrdiag.zip 파일이 있는지 확인합니다.
  또는
- 최신 버전을 수동으로 다운로드합니다 .
필요한 경우 nrdiag.zip 의 압축을 풉니다.
nrdiag_1.2.3/win 디렉토리에서 nrdiag.exe 또는 nrdiag_x64.exe 를 애플리케이션의 루트 디렉토리로 이동합니다.
웹 애플리케이션 문제를 해결하려면 프로젝트의 상위 디렉토리에서 실행 파일을 실행하고 있는지 확인하거나 -c 옵션을 사용하여 구성 파일 위치를 지정하세요.
바이너리를 배치한 디렉터리의 CLI 옵션 과 함께 실행 파일을 실행합니다. 일부 검사에는 높은 권한이 필요하므로 최상의 결과를 얻으려면 관리자 셸에서 실행합니다.
CLI_OPTIONS 을 추가하는 경우 PowerShell을 통해 실행:
```
./nrdiag.exe CLI_OPTIONS
```
또는 x64 시스템의 경우:
```
./nrdiag_x64.exe CLI_OPTIONS
```
진단 CLI는 발견한 모든 문제를 출력하고 -attach 플래그를 포함하는 경우 관련 파일을 New Relic 계정에 업로드합니다.

진단 CLI가 있는지 확인하십시오.
- 명령줄에서 디렉터리를 애플리케이션의 루트 디렉터리로 변경하고 nrdiag.zip 파일이 있는지 확인합니다.
  또는
- 최신 버전을 수동으로 다운로드합니다 .
필요한 경우 nrdiag.zip 의 압축을 풉니다.
nrdiag_1.2.3/mac 디렉토리에서 nrdiag 을 애플리케이션의 루트 디렉토리로 이동합니다.
모든 CLI 옵션 과 함께 nrdiag 실행
```
./nrdiag CLI_OPTIONS
```
진단 CLI는 -attach 플래그를 포함하는 경우 발견한 모든 문제를 출력하고 관련 파일을 New Relic 계정에 업로드합니다.

최신 버전의 진단 CLI가 있는지 확인하십시오. 필요한 경우 최신 버전을 수동으로 다운로드합니다 .
필요한 경우 nrdiag.zip 의 압축을 풉니다.
nrdiag_1.2.3/ OS 디렉터리에서 nrdiag 를 실행합니다( CLI 옵션 과 함께:
```
./nrdiag -browser-url WEBSITE_URL CLI_OPTIONS
```
진단 CLI는 -attach 플래그를 포함하는 경우 발견한 모든 문제를 출력하고 관련 파일을 New Relic 계정에 업로드합니다.

Docker 컨테이너에서 실행되는 New Relic-instrumented 애플리케이션의 문제를 해결하려면 docker exec 명령어를 사용하세요.

nrdiag_latest.zip 파일을 다운로드 하고 압축을 풉니다.
바이너리를 컨테이너에 복사합니다. IMAGE_NAME 을 도커 컨테이너의 이름으로 바꿉니다.
```
docker cp nrdiag/linux/nrdiag IMAGE_NAME:/bin
```
Docker 컨테이너에서 nrdiag 명령을 실행합니다. 위와 같이 IMAGE_NAME 을 바꾸고 APPLICATION_ROOT 를 New Relic 에이전트를 설치한 애플리케이션의 루트 디렉터리로 바꿉니다.
```
docker exec -it -w APPLICATION_ROOT IMAGE_NAME nrdiag
```
(선택사항) 완료되면 nrdiag 바이너리를 제거합니다.
```
docker exec IMAGE_NAME rm /bin/nrdiag
```

스위트 플래그(권장되는 CLI 옵션)

제품군은 특정 제품 또는 문제를 대상으로 하는 상태 확인 모음입니다. 제품군을 사용하면 문제 해결 범위를 좁히고 오탐지 발생을 줄일 수 있습니다.

사용 가능한 제품군 목록을 검토하려면 -help suites 옵션과 함께 진단 CLI를 실행합니다.

./nrdiag -help suites

nrdiag 으로 제품군을 실행하려면 -suites 플래그와 하나 이상의 제품군 이름(예: java )을 제공하여 인수로 실행할 수 있습니다.

Linux 및 macOS:

64비트 시스템의 경우:
```
./nrdiag_x64 -suites SUITE NAMES
```
ARM64 시스템의 경우:
```
./nrdiag_arm64 -suites SUITE NAMES
```

Windows:

PowerShell에서 실행하려면 cmd 시작 부분에 ./ 를 추가합니다.

32비트 시스템의 경우:
```
nrdiag.exe -suites SUITE NAMES
```
64비트 시스템의 경우:
```
nrdiag_x64.exe -suites SUITE NAMES
```
ARM64 시스템의 경우:
```
nrdiag_arm64.exe -suites SUITE NAMES
```

스크립트

스크립트는 작업으로 수집되지 않은 정보에 대한 추가 데이터 소스를 제공합니다. 사용 가능한 스크립트 카탈로그는 Diagnostic CLI의 github 저장소 에서 찾을 수 있습니다.

스크립트 출력

스크립트 출력은 화면에 인쇄되고 스크립트 이름(예: name-of-script.out)을 기반으로 파일에 저장됩니다. 이는 -output-path 에서 지정한 디렉토리에 저장되며 기본값은 현재 디렉토리입니다.

스크립트는 현재 작업 디렉터리나 -output-path 에서 지정한 디렉터리로 파일을 출력할 수도 있습니다. 모든 출력 파일은 ScriptOutput/ 디렉터리의 결과 zip에 포함됩니다.

스크립트 결과

스크립트 실행 결과는 다음 스키마를 사용하여 nrdiag-output.json 파일에서 찾을 수 있습니다.

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

Output 필드에는 stdout 출력이 포함되어 있습니다. 20000자를 초과하면 잘리고 OutputTruncated 필드가 true 로 설정됩니다. 잘리더라도 zip 파일의 ScriptOutput/ 디렉터리에서 전체 출력을 계속 사용할 수 있습니다.

스크립트가 생성한 파일 목록은 Outputfiles 필드에서 찾을 수 있습니다.

스크립트 나열, 보기 및 실행

zip에 추가 파일 포함

지원팀과 공유하고 싶은 추가 파일이 있는 경우 -include 명령줄 플래그를 사용하여 nrdiag-output.zip 파일에 포함할 수 있습니다. 이것은 단일 파일 또는 디렉토리와 함께 사용할 수 있습니다. 디렉토리가 제공되면 모든 하위 디렉토리가 포함됩니다. 포함된 파일의 총 크기 제한은 4GB입니다.

이것을 -attach 과 함께 사용 하여 파일을 New Relic 계정에 업로드하십시오 .

Linux 및 macOS:

64비트 시스템의 경우:

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

ARM64 시스템의 경우:

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

Windows:

PowerShell에서 실행하려면 cmd 시작 부분에 ./ 를 추가합니다.

32비트 시스템의 경우:

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

64비트 시스템의 경우:

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

ARM64 시스템의 경우:

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

New Relic 계정에 결과 업로드

중요

시스템이 외부 IP 주소에 연결하도록 구성되지 않은 경우 이 방법은 작동하지 않습니다. 대신 이메일에 있는 출력 파일을 New Relic 지원팀에 첨부하십시오.

자동 계정 업로드

Diagnostics CLI가 실행될 때 결과를 New Relic 계정에 자동으로 업로드하려면 -attach 또는 -api-key 명령줄 플래그를 사용하십시오. -attach 플래그는 환경에서 찾은 모든 New Relic 라이센스 키의 유효성을 검사하고 라이센스 키와 연결된 계정에 실행을 업로드합니다. 또는 -api-key 플래그는 유효한 라이센스 키의 존재 여부에 관계없이 실행을 업로드하기 위해 제공됩니다.

결과를 계정에 업로드하면 nrdiag-output.json 및 nrdiag-output.zip 의 콘텐츠가 자동으로 업로드됩니다.

PowerShell에서 실행하려면 cmd 시작 부분에 ./ 를 추가합니다.

32비트 시스템의 경우:

nrdiag.exe -attach

또는

nrdiag.exe -api-key ${API_KEY}

64비트 시스템의 경우:

nrdiag_x64.exe -attach

또는

nrdiag_x64.exe -api-key ${API_KEY}

ARM64 시스템의 경우:

nrdiag_arm64.exe -attach

또는

nrdiag_arm64.exe -api-key ${API_KEY}

지역 선택

기본적으로 진단 CLI는 미국 데이터 센터에서 호스팅되는 New Relic 계정에 결과를 업로드합니다. 계정이 EU 데이터 센터에서 호스팅되는 경우 명령에 -region eu 추가해야 합니다.

./nrdiag -region eu ...

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

진단 CLI 설치 및 실행

Linux

윈도우

플랫폼별 수동 설치 절차

Linux

윈도우

맥 OS

브라우저 모니터링

도커 컨테이너

스위트 플래그(권장되는 CLI 옵션)

스크립트

스크립트 출력

스크립트 결과

스크립트 나열, 보기 및 실행

사용 가능한 스크립트 나열

스크립트 보기

스크립트 실행

인수를 사용하여 스크립트 실행

제품군과 함께 스크립트 실행

zip에 추가 파일 포함

New Relic 계정에 결과 업로드

중요

자동 계정 업로드

리눅스와 macOS

윈도우

지역 선택