진단 CLI 설치 및 실행
진단 CLI는 Linux 및 Windows에서 단일 명령으로 설치하고 실행할 수 있습니다. 이 설치 방법은 진단 CLI 바이너리를 현재 작업 디렉터리에 다운로드합니다. 진단 CLI는 에이전트 구성 파일 및 기타 관련 데이터에 대한 루트 디렉터리 및 하위 디렉터리를 자동으로 검색합니다.
플랫폼별 수동 설치 절차
진단 CLI를 수동으로 설치하고 실행하려면 플랫폼에 대한 절차를 따르십시오.
스위트 플래그(권장되는 CLI 옵션)
제품군은 특정 제품 또는 문제를 대상으로 하는 상태 확인 모음입니다. 제품군을 사용하면 문제 해결 범위를 좁히고 오탐지 발생을 줄일 수 있습니다.
사용 가능한 제품군 목록을 검토하려면 -help suites
옵션과 함께 진단 CLI를 실행합니다.
./nrdiag -help suites
nrdiag
으로 제품군을 실행하려면 -suites
플래그와 하나 이상의 제품군 이름(예: java
)을 제공하여 인수로 실행할 수 있습니다.
Linux and macOS:
64비트 시스템의 경우:
./nrdiag_x64 -suites SUITE NAMESARM64 시스템의 경우:
./nrdiag_arm64 -suites SUITE NAMES
Windows:
PowerShell에서 실행하려면 cmd
시작 부분에 ./
를 추가합니다.
32비트 시스템의 경우:
nrdiag.exe -suites SUITE NAMES64비트 시스템의 경우:
nrdiag_x64.exe -suites SUITE NAMESARM64 시스템의 경우:
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 and macOS:
64비트 시스템의 경우:
./nrdiag_x64 -include /entire/directory/ -attachARM64 시스템의 경우:
./nrdiag_arm64 -include /entire/directory/ -attach
Windows:
PowerShell에서 실행하려면 cmd
시작 부분에 ./
를 추가합니다.
32비트 시스템의 경우:
nrdiag.exe -include Path\To\File -attach64비트 시스템의 경우:
nrdiag_x64.exe -include \Entire\Directory\ -attachARM64 시스템의 경우:
nrdiag_arm64.exe -include \Entire\Directory\ -attach
New Relic 계정에 결과 업로드
중요
시스템이 외부 IP 주소에 연결하도록 구성되지 않은 경우 이 방법은 작동하지 않습니다. 대신 이메일에 있는 출력 파일을 New Relic 지원팀에 첨부하십시오.
자동 계정 업로드
진단 CLI가 실행될 때 결과를 뉴렐릭 계정에 자동으로 업로드하려면 -attach
또는 -api-key
복합줄 플래그를 사용하세요. -attach
플래그는 환경에서 발견된 모든 뉴렐릭 클러스터 키의 유효성을 검사하고 인스턴스 키와 연결된 계정에 실행을 업로드합니다. 또는 -api-key
플래그는 유효한 인스턴스 키의 존재 여부에 관계없이 실행을 업로드하기 위해 제공된 사용합니다.
결과를 계정에 업로드하면 nrdiag-output.json
및 nrdiag-output.zip
의 콘텐츠가 자동으로 업로드됩니다.
지역 선택
기본적으로 진단 CLI는 미국 데이터 센터에서 호스팅되는 New Relic 계정에 결과를 업로드합니다. 계정이 EU 데이터 센터에서 호스팅되는 경우 명령에 -region eu
추가해야 합니다.
./nrdiag -region eu ...