이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Sosreport 도구

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

Sosreport는 오픈소스 기반의 소프트웨어 SoS입니다. Sosreport 도구를 사용하여 문제를 디버그하는 데 도움이 되는 정보를 수집할 수 있습니다. 노드에는 Apigee가 구성 요소가 실행 중인지 확인합니다. 이 도구는 정보를 수집하고 노드의 파일 시스템에 로컬로 저장합니다.

Sosreport 도구는 구성 세부정보, 시스템 정보 및 진단 정보 아카이브에 저장합니다. Apigee 구성요소의 경우 Sosreport는 다음을 수집합니다.

실행 중인 커널 버전
로드된 모듈
시스템 및 서비스 구성 파일

Sosreport는 또한 추가 정보를 수집하기 위해 외부 프로그램을 실행합니다. 다음과 같은 정보를 포함합니다.

모든 구성요소의 Apigee 로그입니다.
런타임 진단
nodetool 명령어를 사용하여 수집된 Cassandra 진단

Sosreport 도구에는 두 가지 기본 명령이 있습니다.

sosreport: 데이터를 수집하고 보고서를 만드는 기본 명령어입니다.
apigee-sosreport: 설치에 사용되는 보조 도구입니다. Apigee 구성요소와 관련된 sosreport 플러그인을 sosreport하고 관리합니다.

설치

이 섹션에서는 sosreport 설치 방법을 설명합니다.

`sosreport`의 SoS 버전이 이미 설치된 경우

원본 sosreport의 SoS 버전 이미 시스템에 설치되어 있으므로 설치 경로가 충돌할 수 있으므로 Apigee 버전을 설정하지 마세요. 대신 디렉터리에서 Apigee 관련 플러그인을 복사하세요. /opt/apigee/apigee-sosreport/source/plugin를 적절한 Python에 할당합니다. site-packages 디렉터리를 생성합니다. 예를 들어 agigee-mgmt.py를 복사하려면 다음을 실행합니다.

Python 2를 사용하는 경우 다음을 입력합니다.

sudo cp apigee-mgmt.py /usr/lib/python2.7/site-packages/sos/plugins/

Python 3를 사용하는 경우 다음을 입력합니다.

sudo cp apigee-mgmt.py /usr/local/lib/python3.6/site-packages/sos/plugins/

플러그인이 설치되었는지 확인하려면

sudo sosreport --list-plugins

궁금한 점이 있으면 Apigee 지원팀에 문의하세요.

Apigee의 `sosreport` 버전 설치 중

sosreport의 SoS 버전이 설치 시 'gcloud compute instances list' 명령어를 입력하여 Apigee 버전을 Edge for Private Cloud가 설치된 모든 노드에서 다음 명령어를 실행합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport install
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport setup

sosreport가 설치되었는지 테스트하려면 Apigee는 다음 디렉터리에 있습니다.

/usr/lib/pythonx.x/site-packages/sos/plugins

여기서 pythonx.x은 설치된 Python 버전입니다.

또는 다음 명령어 중 하나를 실행할 수 있습니다.

Apigee 관련 플러그인만 확인하려면 다음 안내를 따르세요.

apigee-service apigee-sosreport diagnose -l

그러면 다음과 같은 Apigee 관련 플러그인 목록이 반환됩니다.

sosreport (version 3.9)

The following plugins are currently enabled:

apigee-mgmt          This is the apigee plugin for edge-management-server
apigee-mp            This is the apigee plugin for edge-message-processor
apigee-rrt           This is the apigee plugin for edge-router
apigee-sample        Main diagnostics gatehring class

모든 플러그인을 확인하려면 다음 단계를 따르세요.

apigee-service apigee-sosreport diagnose -s -l

그러면 sosreport에서 사용할 수 있는 다음 플러그인 목록이 반환됩니다.

sosreport (version 3.9)

The following plugins are currently enabled:

 acpid                ACPI daemon information
 alternatives         System alternatives
 anacron              Anacron job scheduling service
 apigee-cassandra     This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mgmt          This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mp            Main diagnostics gathering class
 apigee-rrt           This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→

………………………………………………….
………………………………………………….
………………………………………………….
←truncated→

보고서 만들기

Sosreport 도구를 사용하여 보고서를 만들려면 sosreport 명령어를 실행합니다. 필요한 플러그인 옵션과 함께 사용할 수 있습니다 (Apigee 플러그인 참고). 이 보고서가 저장되는 기본 디렉터리는 tmp 또는 /var/tmp입니다. 다른 디렉터리에 전달하여 보고서가 저장되는 디렉터리를 tmp-dir 옵션으로 변경합니다. 예를 들어 만들고 my_report-dir라는 디렉터리에 저장합니다. 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf -o apigee-mgmt  --batch --tmp-dir=my_report-dir

Sosreport의 SoS 버전을 사용하는 경우:

sudo sosreport -o apigee-mgmt  --batch --tmp-dir=my_report-dir

보고서는.tar.xz tmp-dir 옵션. .tar.xz 파일의 위치는 STDOUT 및 체크섬에 표시됩니다. 예를 들면 다음과 같습니다.

Your sosreport has been generated and saved in:
 /var/sosreport-prc-test-0-9613-2021-07-12-orwxufx.tar.xz
The checksum is: 5a8b97c6020346a688254c8b04ef86ec
For more available options for sosreport, read the man file:
sudo man sosreport

보고서는.tar.xz tmp-dir 옵션. .tar.xz file의 위치는 STDOUT에 표시되며 체크섬. 예를 들면 다음과 같습니다.

sosreport에 사용할 수 있는 추가 옵션은 man 파일을 참고하세요.

sudo man sosreport

Apigee 플러그인

다음 섹션에서는 Sosreport 도구에 대한 Apigee 플러그인을 설명합니다. 다음 구성요소가 포함됩니다.

관리 서버
메시지 프로세서
라우터
Cassandra

관리 서버

apigee-mgmt 플러그인은 다음 정보를 수집합니다. 관리 서버:

서버 호스트 이름 (기본값)
cpuinfo (기본값)
meminfo (기본값)
Java 가상 머신(JVM) 설정(예: 메모리, Djdk.tls.allowUnsafeServerCertChange 등 (기본값)
현재 관리 로그 (기본값)
10개의 순차적 최상위 및 jstacks 출력 (기본값)
전체 관리 로그 폴더 (선택사항)
config-files (선택사항)

예:

모든 기본 항목을 수집하려면 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch my_report-dir

sosreport의 SoS 버전 사용:

sudo sosreport -o apigee-mgmt --batch my_report-dir

명령어에 지정된 모든 기본 항목과 선택 항목을 수집하려면 예를 들어 구성 파일과 모든 로그를 확인하려면 다음 중 하나를 입력합니다.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

sosreport의 SoS 버전 사용:

sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

모든 데이터를 수집하려면 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

또는 다음을 입력할 수 있습니다.

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -a

sosreport의 SoS 버전 사용:

sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

또는 다음과 같이 입력할 수 있습니다.

sudo sosreport -o apigee-mgmt --batch -a

메시지 프로세서

apigee-mp 플러그인은 다음 정보를 수집합니다. 관리 프로세서 (MP):

서버 호스트 이름 (기본값)
cpuinfo (기본값)
meminfo (기본값)
buildinfo/release info (기본값)
Apigee-모든 상태 (기본값)
서버 세부정보 (기본값)
JVM 수준 설정(예: 메모리, Djdk.tls.allowUnsafeServerCertChange) 등(기본값)
현재 MP 로그 (기본값)
10개의 순차적 상단, jstacks 및 NIO 측정항목 출력 (기본값)
전체 MP 로그 폴더 (선택사항)
분류 트리 (선택사항)
힙 덤프 (선택사항)
config-files (선택사항)
런타임 trace (선택사항이며 org:env:api:rev detail인 경우에만) 제공됩니다. 참고: 플러그인은 런타임 요청을 수집할 때까지 25초 동안 대기합니다.

예:

모든 기본 항목을 수집하려면 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch

sosreport의 SoS 버전 사용:
```
sudo sosreport -o apigee-mp --batch
```

모든 기본 항목 외에 수집할 추가 선택 항목을 지정할 수도 있습니다. 예를 들어 힙 덤프를 지정하려면 -k apigee-mp.heap인 경우 다음 중 하나를 입력합니다.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.heap

sosreport의 SoS 버전 사용:

sudo sosreport -o apigee-mp --batch -k apigee-mp.heap

마찬가지로 다음과 같은 선택적 항목을 지정할 수 있습니다.

-k apigee-mp.deployments
-k apigee-mp.heap
-k apigee-mp.all-logs
-k apigee-mp.config-files
-k apigee-mp.trace=gsc-cps:test:httpbin:3

단일 명령에 여러 옵션을 지정할 수 있습니다. 예를 들면 다음과 같습니다.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs

sosreport의 SoS 버전 사용:

sudo sosreport -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs

트레이스를 제외한 모든 항목을 수집하려면 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -a

sosreport의 SoS 버전 사용:
```
sudo sosreport -o apigee-mp --batch -a
```

라우터

apigee-rrt 플러그인은 다음 정보를 수집합니다. 라우터:

서버 호스트 이름 (기본값)
cpuinfo (기본값)
meminfo (기본값)
buildinfo/release info (기본값)
Apigee-모든 상태 (기본값)
서버 세부정보 (기본값)
ps 출력입니다. 이렇게 하면 JVM 수준 설정(예: 메모리, Djdk.tls.allowUnsafeServerCertChange 등 (기본값)
현재 라우터 로그 (기본값)
잘못된 파일 이름을 포함한 vhost 파일 이름 목록 (기본값)
전체 라우터 로그 폴더 (선택사항)
config-files (선택사항)

예:

모든 기본 항목을 수집하려면 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch

sosreport의 SoS 버전 사용:
```
sudo sosreport -o apigee-rrt --batch
```

모든 기본 항목 외에 수집할 추가 선택 항목을 지정할 수도 있습니다. 예를 들어 전체 로그 폴더를 지정하려면 -k apigee-rrt.all-logs인 경우 다음 중 하나를 입력합니다.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -k apigee-rrt.all-logs

sosreport의 SoS 버전 사용:

sudo sosreport -o apigee-rrt --batch -k apigee-rrt.all-logs

마찬가지로 다음과 같은 선택적 항목을 지정할 수 있습니다.

-k apigee-rrt.all-logs
-k apigee-rrt.config-files

모든 항목을 수집하려면 다음 단계를 따르세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -a

sosreport의 SoS 버전 사용:
```
sudo sosreport -o apigee-rrt --batch -a
```

Cassandra

apigee-cassandra 플러그인은 다음 정보를 수집합니다. Cassandra 노드:

시스템 통계:

"hostname -i"
"cat /proc/cpuinfo"
"cat /proc/meminfo"
"ulimit -a"
"ps auxw"
"df -kh"
"du -sh"
"netstat -ntlpu"
"free -h"
"ifconfig -h"
"ps -ef"

Apigee 구성요소의 상태 및 버전 Apigee-모든 버전 및& Apigee-모든 상태
apigee-cassandra 로그: /opt/apigee/var/log/apigee-cassandra/의 모든 파일
커밋 로그 수
상단의 명령어 출력
스레드 덤프
구성 파일: cassandra-topology.properties, cassandra.yaml <ph type="x-smartling-placeholder">cassandra-env.sh</ph>
version, status, ring, info, gossipinfo, 매개변수에 대한 Nodetool 출력 압축 통계 -H, tpstats, netstats, cfstats, proxyhistograms

예:

모든 기본 항목을 수집하려면 다음 중 하나를 입력하세요.

Apigee의 sosreport 버전 사용:

sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-cassandra

sosreport의 SoS 버전 사용:
```
sudo sosreport -o apigee-cassandra
```

Sosreport 도구

설치

sosreport의 SoS 버전이 이미 설치된 경우

Apigee의 sosreport 버전 설치 중

보고서 만들기

Apigee 플러그인

관리 서버

예:

메시지 프로세서

예:

라우터

예:

Cassandra

예:

`sosreport`의 SoS 버전이 이미 설치된 경우

Apigee의 `sosreport` 버전 설치 중