GitHub Enterprise Server에 대한 지원 번들 정보

GitHub Enterprise Server 인스턴스에서 문제가 발생할 때, 지원 번들은 GitHub 지원 문제를 신속하게 해결하는 데 필요한 진단 데이터를 제공합니다.

이 기사에서

지원 번들 정보

지원 번들은 GitHub Enterprise Server 인스턴스의 진단 데이터가 포함된 압축된 아카이브입니다. 지원 번들을 사용하여 GitHub 지원와 문제에 대해 협력하고 인스턴스의 구성, 상태, 활동을 요약한 Health Check 보고서를 생성할 수 있습니다.

지원 번들을 생성하는 경우

다음과 같은 여러 시나리오에서 지원 번들을 생성합니다.

지원 티켓 조사

GitHub 지원는 성능 문제, 서비스 오류, 인증 문제 또는 기타 운영 문제를 조사하는 경우 지원 번들을 요청할 수 있습니다. 먼저 지원 티켓을 발급한 후, 번들을 생성하고 이를 케이스에 연결할 수 있도록 티켓 번호를 포함하세요. 세부 정보는 명령줄 유틸리티(을)를 참조하세요.

헬스 체크 분석

지원 번들을 생성하여 헬스 체크 보고서를 만들 수 있습니다. 상태 검사는 지원 번들 데이터를 분석하고 인스턴스의 상태, 보안, Git 작업 및 API 사용량을 보고합니다. 자세한 내용은 엔터프라이즈에 대한 상태 검사 생성을(를) 참조하세요.

지원 번들의 콘텐츠

지원 번들에는 인스턴스의 여러 범주의 데이터가 포함됩니다. 정확한 내용은 GitHub Enterprise Server 버전 및 구성에 따라 달라집니다.

시스템 및 인스턴스 정보

지원 번들에는 버전 정보, 시스템 구성, 라이선스 세부 정보 및 명령의 출력 ghe-diagnostics 과 같은 인스턴스의 설정 및 환경에 대한 진단 데이터가 포함됩니다. 진단 정보의 전체 목록은 GitHub 지원에 데이터 제공을 참조하세요.

로그 파일

지원 번들에는 인스턴스의 시스템 서비스, 애플리케이션 및 데이터베이스의 로그 파일이 포함됩니다. 수집된 로그 데이터의 양은 번들 유형에 따라 달라집니다. 사용 가능한 로그 파일에 대한 자세한 내용은 시스템 로그 정보을 참조하세요.

표준 및 확장 번들

지원 번들에는 두 가지 유형이 있습니다. 표준 번들은 생성 속도가 더 작고 빠르며 확장 번들은 심층적인 문제 해결을 위해 보다 포괄적인 데이터를 제공합니다.

표준 번들확장 번들(-x 플래그)
          **로그 기간** | 2일 | 8일 |

| 회전된 로그 파일 | 제외 | 포함됨 | | 코어 덤프 | 제외 | 포함됨 | | 디스크 사용 현황 보고서 | 제외 | 포함됨 | | 핫패치 로그 | 최신 전용 | 모든 버전 |

GitHub 지원는 번들을 생성할 유형을 알려 드립니다. 의심스러운 경우 모든 진단 데이터를 사용할 수 있도록 확장 번들을 생성합니다. 플래그를 사용하여 --period 사용자 지정 로그 기간을 지정할 수도 있습니다(예: --period '4 days').

서비스 상태 및 메트릭

지원 번들에는 인스턴스에서 실행되는 주요 서비스에 대한 현재 서비스 상태, 프로세스 정보, 성능 메트릭 및 구성 파일이 포함됩니다.

고가용성 정보

인스턴스에서 고가용성 또는 클러스터링을 사용하는 경우 지원 번들은 다음과 같습니다.

  • 복제 상태 및 지연 정보
  • 클러스터 노드 구성
  • 캐시 복제본 세부 정보

데이터 개인 정보 보호 및 보안

지원 번들은 중요한 정보를 보호하면서 문제를 진단하는 데 도움이 되도록 설계되었습니다.

  •         **삭제**: 암호, 토큰 및 프라이빗 키와 같은 중요한 데이터는 수집 전에 제거되거나 난독 처리됩니다.

  •         **리포지토리 콘텐츠 없음**: 지원 번들에는 소스 코드, 커밋 데이터 또는 파일 콘텐츠와 같은 Git 리포지토리의 콘텐츠가 포함되지 않습니다.

  •         **사용자 데이터**: 지원 번들은 시스템 로그에 표시되는 것 이상으로 사용자 프로필 정보를 포함하지 않습니다.

  •         **라이선스 정보**: 번들에는 조직 이름 및 라이선스 참조가 포함되어 있으므로 GitHub 지원에서 인스턴스를 식별할 수 있습니다.

GitHub 지원에 지원 번들을 제공할 경우, GitHub은 데이터를 오직 지원 요청 해결 목적으로만 사용합니다. GitHub에서 데이터를 처리하는 방법에 대한 자세한 내용은 GitHub 개인정보처리방침을 참조하세요.

번들 크기 및 생성 시간 지원

지원 번들 크기 및 생성 시간은 다음에 따라 다릅니다.

  • 인스턴스 크기 및 활동 수준
  • 리포지토리의 수 및 크기
  • 마지막 로그 회전 이후의 시간
  • 인스턴스에서 클러스터링 또는 고가용성을 사용하는지 여부

일반적인 지원 번들은 수백MB에서 몇 GB까지 다양합니다. 번들을 생성하는 데는 작은 인스턴스의 경우 몇 분에서 매우 크거나 많이 로드된 인스턴스의 경우 1시간 이상 걸릴 수 있습니다.

대규모 지원 번들은 생성 중에 인스턴스 성능에 영향을 줄 수 있습니다. 다음을 고려하십시오.

  •         **시스템 로드**: 지원 번들을 생성하면 CPU, 메모리 및 디스크 I/O 리소스가 사용됩니다.

  •         **타이밍**: 가능하면 사용량이 적은 시간 동안 지원 번들을 생성합니다.

  •         **유지 관리 모드**: 인스턴스에 심각한 성능 문제가 있는 경우 성공적으로 완료되도록 지원 번들을 생성하기 전에 유지 관리 모드를 사용하도록 설정하는 것이 좋습니다. 자세한 내용은 [AUTOTITLE](/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode)을(를) 참조하세요.

성능 영향 감소

이 ghe-support-bundle 명령은 가장 낮은 CPU 및 I/O 우선 순위에서 자동으로 실행되므로 프로덕션 워크로드가 우선합니다. 생성 중에 리소스 사용량을 더 줄이기 위해 다음 플래그를 사용할 수 있습니다.

  •         `--no-async` (`-n`): 컬렉션을 병렬 대신 순차적으로 실행하여 리소스 경합을 줄입니다.

  •         `--num-jobs 1` (`-l 1`): 병렬 처리를 단일 컬렉션 스레드로 제한합니다. 기본값은 사용 가능한 CPU 수의 3분의 1입니다.

예를 들어 성능에 미치는 영향을 최소화하면서 확장 번들을 생성하고 업로드하려면 다음을 수행합니다.

ghe-support-bundle -x -u --no-async --num-jobs 1

다른 진단 도구와의 관계

지원 번들은 다른 모니터링 및 진단 기능과 함께 작동합니다.

진단 파일

이 ghe-diagnostics 명령은 전체 지원 번들의 정보 하위 집합을 포함하는 더 작은 진단 파일을 생성합니다. 진단 파일은 빠른 상태 검사 또는 전체 지원 번들을 생성할 수 없는 경우에 유용합니다. 진단 출력은 모든 지원 번들에도 포함됩니다.

대시보드를 모니터하다

관리 콘솔의 모니터 페이지에서는 인스턴스에 대한 실시간 및 기록 측정치를 제공합니다. 자세한 내용은 모니터 대시보드을(를) 참조하세요.

지원 번들 생성 및 공유

"관리 콘솔 또는 명령줄을 사용하여 지원 번들을 생성하고 공유할 수 있습니다." 자세한 지침은 GitHub 지원에 데이터 제공을 참조하세요.

클러스터링에 대한 고려 사항

GitHub Enterprise Server 클러스터링을 사용하는 경우 다음을 생성할 수 있습니다.

  •         **노드별 번들**: 개별 클러스터 노드에 대한 번들을 지원합니다.

  •         **클러스터 번들**: `ghe-cluster-support-bundle`를 사용하여 모든 클러스터 노드에서 결합된 번들입니다.

GitHub 지원는 조사 중인 문제에 따라 생성할 번들의 유형을 알려 드립니다.

실패한 지원 번들 생성

번들 생성 실패의 가장 일반적인 원인은 사용 가능한 디스크 공간이 부족하다는 것입니다 /data/user/tmp. 지원 번들은 압축 전에 이 디렉터리에 어셈블되므로 압축되지 않은 데이터를 저장할 충분한 공간이 필요합니다. 번들을 생성하기 전에 사용 가능한 공간을 확인합니다.

df -h /data/user/tmp

생성이 실패하거나 비정상적으로 시간이 오래 걸리는 경우 공간을 /data/user/tmp 확보하고 다시 시도하십시오. 문제가 지속되면 GitHub 지원에 문의하여 도움을 받으세요. 대안으로, ghe-diagnostics 명령을 사용하여 더 작은 진단 파일을 생성할 수 있습니다.

추가 읽기

  •         [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs)

  •         [AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities#ghe-support-bundle)

  •         [AUTOTITLE](/support/contacting-github-support/providing-data-to-github-support)