GitHub 지원에 데이터 제공

GitHub 지원는 사용자 환경에 액세스할 수 없으므로 사용자로부터 몇 가지 추가 정보가 필요한 경우가 있습니다.

누가 이 기능을 사용할 수 있는 있나요?

Site administrators and enterprise owners can provide data to GitHub 지원.

이 문서의 내용

진단 파일 및 지원 번들 정보

사용자 환경에서 GitHub Enterprise Server 인스턴스의 문제를 해결하는 데 도움이 되도록 GitHub 지원에서 하나 이상의 데이터 형식을 요청할 수 있습니다.

데이터파일 형식설명
진단 파일일반 텍스트인스턴스의 설정 및 환경에 대한 정보가 포함되어 있습니다.
지원 번들보관기본적으로 지난 2일 동안의 진단 파일 및 삭제된 로그 파일이 포함되어 있습니다.
확장 지원 번들보관지난 8일 동안의 진단 파일 및 삭제된 로그 파일이 포함되어 있습니다.

로그 파일 삭제 정보

인증 토큰, 키 및 비밀은 지원 번들 또는 진단 파일 내에 포함된 다음 로그 디렉터리에 있는 로그 파일에서 제거됩니다.

  • alambic-logs
  • babeld-logs
  • codeload-logs
  • enterprise-manage-logs
  • github-logs
  • hookshot-logs
  • lfs-server-logs
  • semiotic-logs
  • task-dispatcher-logs
  • pages-logs
  • registry-logs
  • render-logs
  • svn-bridge-logs

진단 파일 만들기 및 공유

진단 파일은 다음을 포함하는 GitHub Enterprise Server 인스턴스의 설정 및 환경에 대한 개요입니다.

  • 회사 이름, 만료 날짜 및 사용자 라이선스 수를 포함한 클라이언트 라이선스 정보
  • 버전 번호 및 SHA
  • VM 아키텍처
  • 호스트 이름, 프라이빗 모드, SSL 설정
  • 목록 로드 및 처리
  • 네트워크 설정
  • 인증 방법 및 세부 정보
  • 리포지토리, 사용자 및 기타 설치 데이터 수

관리 콘솔에서 또는 ghe-diagnostics 명령줄 유틸리티를 실행하여 인스턴스에 대한 진단을 다운로드할 수 있습니다.

관리 콘솔에서 진단 파일 만들기

현재 SSH 액세스 권한이 없는 경우 관리 콘솔에서 진단 파일을 만들 수 있습니다.

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

  3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

  4. 여러 관리 콘솔 사용자 계정을 만든 경우 루트 사이트 관리자** 또는 관리 콘솔 사용자를 선택합니다**. 관리 콘솔 사용자 계정에 대한 자세한 내용은 "관리 콘솔에 대한 액세스 관리"을 참조하세요.

  5. 관리 콘솔 자격 증명을 입력합니다. 계속을 클릭합니다.

  6. 위쪽 탐색 모음에서 지원을 클릭합니다.

    관리 콘솔의 머리글 스크린샷. "지원"으로 레이블이 지정된 탭이 주황색 윤곽선으로 강조 표시됩니다.

  7. 진단 정보 다운로드를 클릭합니다.

SSH를 사용하여 진단 파일 만들기

관리 콘솔에 로그인하지 않고도 이 방법을 사용할 수 있습니다.

ghe-diagnostics 명령줄 유틸리티를 사용하여 인스턴스에 대한 진단을 검색합니다.

ssh -p122 admin@HOSTNAME -- 'ghe-diagnostics' > diagnostics.txt

지원 번들 만들기 및 공유

지원 요청을 제출한 후 지원 번들을 우리 팀과 공유하도록 요청할 수 있습니다. 지원 번들은 다음과 같은 인스턴스의 진단 및 중요한 로그를 포함하는 gzip 압축 tar 보관 파일입니다.

  • 인증 오류 문제를 해결하거나 LDAP, CAS 또는 SAML을 구성할 때 유용할 수 있는 인증 관련 로그
  • 관리 콘솔 로그
  • github-logs/exceptions.log: 사이트에서 발생한 500개의 오류에 대한 정보
  • github-logs/audit.log: GitHub Enterprise Server 감사 로그
  • babeld-logs/babeld.log: Git 프록시 로그
  • system-logs/haproxy.log: HAProxy 로그
  • elasticsearch-logs/github-enterprise.log: Elasticsearch 로그
  • configuration-logs/: GitHub Enterprise Server 구성 로그
  • collectd/logs/collectd.log: 수집된 로그
  • mail-logs/mail.log: SMTP 이메일 배달 로그

자세한 내용은 "엔터프라이즈의 감사 로그 정보"을(를) 참조하세요.

지원 번들에는 기본적으로 지난 2일 동안의 로그가 포함됩니다. 정확한 기간을 일 단위로 지정할 수 있습니다. 지난 8일 동안의 로그를 제공하려는 경우 추가 지원 번들을 다운로드할 수 있습니다. 자세한 내용은 "추가 지원 번들 만들기 및 공유"를 참조하세요.

팁: GitHub 지원에 문의하면 티켓 참조 링크가 포함된 확인 이메일이 전송됩니다. GitHub 지원에서 지원 번들을 업로드하도록 요청하는 경우 티켓 참조 링크를 사용하여 지원 번들을 업로드할 수 있습니다.

관리 콘솔에서 지원 번들 만들기

웹 기반 관리 콘솔에 액세스할 수 있고 아웃바운드 인터넷에 액세스할 수 있는 경우 다음 단계를 사용하여 지원 번들을 만들고 공유할 수 있습니다.

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

  3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

  4. 여러 관리 콘솔 사용자 계정을 만든 경우 루트 사이트 관리자** 또는 관리 콘솔 사용자를 선택합니다**. 관리 콘솔 사용자 계정에 대한 자세한 내용은 "관리 콘솔에 대한 액세스 관리"을 참조하세요.

  5. 관리 콘솔 자격 증명을 입력합니다. 계속을 클릭합니다.

  6. 위쪽 탐색 모음에서 지원을 클릭합니다.

    관리 콘솔의 머리글 스크린샷. "지원"으로 레이블이 지정된 탭이 주황색 윤곽선으로 강조 표시됩니다.

  7. 지원 번들 다운로드를 클릭합니다.

  8. 지원 엔지니어가 지원 번들 업로드 링크를 제공한 경우 이 링크를 사용합니다. 그렇지 않으면 https://support.github.com/을 방문하여 지원을 받을 자격이 있는 엔터프라이즈 계정에 로그인합니다(메시지가 표시되는 경우).

  9. https://support.github.com/uploads을 방문하여 지원 번들을 업로드합니다.

SSH를 사용하여 지원 번들 만들기

GitHub Enterprise Server 인스턴스에 대한 SSH 액세스 권한이 있고 아웃바운드 인터넷에 액세스할 수 있는 경우 다음 단계를 사용하여 지원 번들을 만들고 공유할 수 있습니다.

참고: GitHub Enterprise Server 인스턴스가 지역 복제 구성에 있거나 인스턴스가 클러스터인 경우 ghe-cluster-support-bundle 명령을 사용하여 지원 번들을 검색해야 합니다. 자세한 내용은 "명령줄 유틸리티"을 참조하세요.

  1. SSH를 통해 지원 번들을 다운로드합니다.

    ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o' > support-bundle.tgz

    ghe-support-bundle 명령 사용에 대한 자세한 내용은 "명령줄 유틸리티”을(를) 참조하세요.

  2. 지원 엔지니어가 지원 번들 업로드 링크를 제공한 경우 이 링크를 사용합니다. 그렇지 않으면 https://support.github.com/을 방문하여 지원을 받을 자격이 있는 엔터프라이즈 계정에 로그인합니다(메시지가 표시되는 경우).

  3. https://support.github.com/uploads을 방문하여 지원 번들을 업로드합니다.

엔터프라이즈 계정을 사용하여 지원 번들 업로드

  1. GitHub.com으로 이동합니다.

  2. GitHub.com의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 Your enterprises(내 엔터프라이즈)를 클릭합니다.

  3. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  4. 엔터프라이즈 계정 사이드바에서 설정을 선택합니다.

  5. 설정에서 라이센스 을(를) 클릭합니다.

  6. "GitHub Enterprise 도움말"에서 지원 번들 업로드를 클릭합니다.

    엔터프라이즈 설정 페이지의 "GitHub Enterprise 도움말" 섹션 스크린샷. "지원 번들 링크 업로드"가 진한 주황색 사각형으로 강조 표시되어 있습니다.

  7. "엔터프라이즈 계정 선택"에서 드롭다운 메뉴를 사용하여 지원 번들의 연결된 계정을 선택합니다.

  8. "GitHub Enterprise 지원를 위한 지원 번들 업로드"에서 지원 번들을 선택하려면 파일 선택을 클릭하거나 지원 번들 파일을 파일 선택으로 끌어옵니다.

  9. 업로드를 클릭합니다.

SSH를 사용하여 지원 번들 직접 업로드

다음과 같은 경우 지원 번들을 서버에 직접 업로드할 수 있습니다.

  • SSH를 통해 GitHub Enterprise Server 인스턴스에 액세스할 수 있습니다.
  • TCP 포트 443을 통한 아웃바운드 HTTPS 연결은 GitHub Enterprise Server 인스턴스에서 enterprise-bundles.github.com 및 _esbtoolsproduction.blob.core.windows.net_으로 허용됩니다.

  1. 번들을 지원 번들 서버에 업로드합니다.

    ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'

추가 지원 번들 만들기 및 공유

지원 번들에는 기본적으로 지난 2일 동안의 로그가 포함되며, 추가 지원 번들에는 지난 8일 동안의 로그가 포함됩니다. GitHub 지원에서 조사 중인 이벤트가 이틀 이전에 발생한 경우 추가 지원 번들을 공유하도록 요청할 수 있습니다. 추가 번들을 다운로드하려면 SSH 액세스 권한이 필요합니다. 관리 콘솔에서 추가 번들을 다운로드할 수 없습니다.

번들이 너무 커지는 것을 방지하기 위해 번들은 회전 및 압축되지 않은 로그만 포함합니다. GitHub Enterprise Server의 로그 회전은 예상되는 로그 크기에 따라 다양한 로그 파일에 대해 다양한 빈도(매일 또는 매주)로 발생합니다.

SSH를 사용하여 추가 지원 번들 만들기

GitHub Enterprise Server 인스턴스에 대한 SSH 액세스 권한이 있고 아웃바운드 인터넷에 액세스할 수 있는 경우 다음 단계를 사용하여 추가 지원 번들을 만들고 공유할 수 있습니다.

  1. ghe-support-bundle 명령에 -x 플래그를 추가하여 SSH를 통해 추가 지원 번들을 다운로드합니다.

    ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o -x' > support-bundle.tgz

  2. 지원 엔지니어가 지원 번들 업로드 링크를 제공한 경우 이 링크를 사용합니다. 그렇지 않으면 https://support.github.com/을 방문하여 지원을 받을 자격이 있는 엔터프라이즈 계정에 로그인합니다(메시지가 표시되는 경우).

  3. https://support.github.com/uploads을 방문하여 지원 번들을 업로드합니다.

SSH를 사용하여 추가 지원 번들 직접 업로드

다음과 같은 경우 지원 번들을 서버에 직접 업로드할 수 있습니다.

  • SSH를 통해 GitHub Enterprise Server 인스턴스에 액세스할 수 있습니다.
  • TCP 포트 443을 통한 아웃바운드 HTTPS 연결은 GitHub Enterprise Server 인스턴스에서 enterprise-bundles.github.com 및 _esbtoolsproduction.blob.core.windows.net_으로 허용됩니다.

  1. 번들을 지원 번들 서버에 업로드합니다.

    ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u -x'

추가 참고 자료