지원 번들 생성
지원 번들을 사용하면 문제 해결 또는 분석을 위한 관련 데이터(로그, 구성 및 메트릭 데이터)가 포함된 압축된 TAR 파일을 생성할 수 있습니다. 필요한 경우, 이러한 번들 파일을 Apstra 지원 팀에 보내 컬렉터 관련 문제를 진단할 수 있습니다.
지원 번들 명령줄 도구를 사용하려면 다음 예제에 표시된 대로 또는 -s 플래그와 함께 --support-bundle 명령을 실행합니다flowcoll.
기본 예
sudo /usr/share/juniper/bin/flowcoll -s
고급 예제
sudo /usr/share/juniper/bin/flowcoll -s -sc /my/config/dir -sl /my/log/dir -st 3 -si 3000
명령이 성공적으로 실행되면 도구는 와 유사한 ef_support_bundle-20230831T164759.tar.gz디렉토리 /home 에 압축된 TAR 파일을 생성합니다.
명령줄 옵션
옵션을 지정하지 않으면 다음 표에 표시된 대로 지정된 기본값이 사용됩니다.
| 선택 |
속기 |
기본값 |
묘사 |
|---|---|---|---|
support-bundle |
-s |
false |
지원 번들 모드를 활성화합니다. |
support-bundle-config-dir |
-sc |
/etc/flowcoll |
수집기의 구성 디렉터리에 대한 경로입니다. |
--support-bundle-logs-dir |
-sl |
/var/log/flowcoll |
수집기의 로그 디렉터리에 대한 경로입니다. |
--support-bundle-metrics-interval |
-si |
1000 |
메트릭이 수집되는 간격(ms)입니다. |
--support-bundle-metrics-times |
-st |
1 |
지표가 수집되는 횟수입니다. |
--support-bundle-output |
-so |
<Working directory> |
출력 파일이 기록되는 경로입니다. |
수집 간격(-si) 및 시간(st)을 조정하면 시간 경과에 따른 메트릭의 추세를 더 쉽게 추적하고 파악할 수 있습니다.
엔드포인트별 지원 번들 생성
다음 방법을 사용하여 지원 번들을 생성할 수 있습니다.
-
HTTP 메서드:
POST -
홈페이지:
/support-bundle
요청 본문
요청 소년의 모든 필드는 선택 사항입니다. 지정하지 않으면 기본값이 사용됩니다.
-
logDirPath (문자열): 로그 파일의 디렉터리 경로입니다. 기본 경로는 다음과 같습니다.
/var/log/juniper/flowcoll -
configDirPath (문자열): 구성 파일의 디렉토리 경로입니다. 기본 경로는 다음과 같습니다.
/etc/juniper
쿼리 매개 변수
-
간격 (정수): 메트릭을 가져오는 간격(ms)입니다. 기본 간격은 ms입니다
1000. - 배
(정수): 메트릭 엔드포인트를 가져오는 횟수입니다. 기본값은 입니다
1.
인증: 이 엔드포인트는 수집기가 특별히 구성된 경우에만 기본 인증을 지원합니다. 구성에 대한 자세한 내용은 일반 옵션 섹션의 API 옵션을 참조하십시오.
엔드포인트별 지원 번들의 예
기본 예
다음 예제에서는 기본 설정을 사용하여 쿼리 매개 변수 또는 요청 본문이 없는 기본 예제를 보여 줍니다.
curl -X POST \ -H "Content-Type: application/json" \ -O -J \ http://localhost:8080/support-bundle
고급 예제
다음 예제에서는 요청 본문 및 쿼리 매개 변수를 포함하는 고급 curl 요청을 보여 줍니다.
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"logDirPath": "/path/to/log/dir",
"configDirPath": "/path/to/log/dir"
}' \
-O -J \
http://localhost:8080/support-bundle?interval=2000×=2
응답
표 2 에는 엔드포인트별로 지원 번들을 생성할 때 표시될 수 있는 코드 및 응답이 나와 있습니다.
| 코드 | 이유 | 설명 |
|---|---|---|
| 200 |
그래 |
성공적인 응답은 다운로드할 지원 번들 파일을 반환합니다. 파일의 명명 규칙은 다음과 같습니다. ef_support_bundle-YYYYMMDDTHHmmss.tar.gz여기서 YYYYMMDDTHHmmss 은(는) 번들이 생성된 시간을 나타내는 타임스탬프입니다. |
| 400 |
잘못된 요청 |
쿼리 매개 변수가 잘못되었음을 나타냅니다. |
| 500 |
내부 서버 오류 |
요청을 처리하는 동안 내부 서버 오류가 발생했습니다. |