Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

이 버전의 GitHub Enterprise는 다음 날짜에 중단됩니다. 2023-03-15. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 성능 향상, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

GitHub 지원에 데이터 제공

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

진단 파일 및 지원 번들 정보

GitHub 지원에서 삭제된 로그 파일 형식으로 추가 데이터를 제공하도록 요청할 수 있습니다. 세 가지 유형의 로그 파일을 제공하도록 요청할 수 있습니다.

진단 파일에는 GitHub Enterprise Server 인스턴스의 설정 및 환경에 대한 정보가 포함되고, 지원 번들에는 지난 2일 동안의 진단 및 로그가 포함되며, 추가 지원 번들에는 지난 7일 동안의 진단 및 로그도 포함됩니다.

로그 파일 삭제 정보

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

  • 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(사이트 관리자)을 클릭합니다.

    “Site admin”(사이트 관리자) 링크 스크린샷 1. 왼쪽 사이드바에서 관리 콘솔 을 클릭합니다. 왼쪽 사이드바의 관리 콘솔 탭 1. 메시지가 표시되면 관리 콘솔 암호를 입력합니다. 관리 콘솔 잠금 해제 화면 4. 관리 콘솔의 오른쪽 상단에서 Support(지원)를 클릭합니다. 지원 영역에 액세스하는 단추

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

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/ghe-config.log: GitHub Enterprise Server 구성 로그
  • collectd/logs/collectd.log: 수집된 로그
  • mail-logs/mail.log: SMTP 이메일 배달 로그

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

지원 번들에는 지난 2일 동안의 로그가 포함됩니다. 지난 7일 동안의 로그를 가져오려면 추가 지원 번들을 다운로드할 수 있습니다. 자세한 내용은 "추가 지원 번들 만들기 및 공유"를 참조하세요.

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

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

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

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

    사이트 관리자 설정에 액세스하기 위한 우주선 아이콘 스크린샷

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

    “Site admin”(사이트 관리자) 링크 스크린샷 1. 왼쪽 사이드바에서 관리 콘솔 을 클릭합니다. 왼쪽 사이드바의 관리 콘솔 탭 1. 메시지가 표시되면 관리 콘솔 암호를 입력합니다. 관리 콘솔 잠금 해제 화면 4. 관리 콘솔의 오른쪽 상단에서 Support(지원)를 클릭합니다. 지원 영역에 액세스하는 단추

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

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

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

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

참고: 지역 복제 구성 또는 GitHub Enterprise 클러스터링을 사용하는 경우 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/ 을 방문하여 지원을 받을 자격이 있는 엔터프라이즈 계정에 로그인합니다(메시지가 표시되는 경우). 1. https://support.github.com/uploads 을 방문하여 지원 번들을 업로드합니다.

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

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

  2. GitHub.com의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 Your enterprises(내 엔터프라이즈)를 클릭합니다.  프로필 사진에 대한 드롭다운 메뉴의 “Your enterprises”(내 엔터프라이즈)GitHub Enterprise Server

  3. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다. 엔터프라이즈 목록에 있는 엔터프라이즈의 이름 1. 엔터프라이즈 계정 사이드바에서 설정을 클릭합니다. 엔터프라이즈 계정 사이드바의 설정 탭

  4. 왼쪽 사이드바에서 엔터프라이즈 라이선스를 클릭합니다. 엔터프라이즈 계정 설정 사이드바에서 "엔터프라이즈 라이선스" 링크를 보여주는 스크린샷.

  5. "GitHub Enterprise 도움말"에서 지원 번들 업로드를 클릭합니다. "지원 번들 링크 업로드"를 보여주는 스크린샷.

  6. "엔터프라이즈 계정 선택" 아래의 드롭다운 메뉴에서 지원 번들과 연결된 계정을 선택합니다. 지원 번들의 엔터프라이즈 계정을 선택하기 위한 드롭다운 메뉴를 보여주는 스크린샷.

  7. "GitHub Enterprise 지원를 위한 지원 번들 업로드"에서 지원 번들을 선택하려면 파일 선택을 클릭하거나 지원 번들 파일을 파일 선택으로 끌어옵니다. 지원 번들 파일을 업로드하는 "파일 선택" 단추를 보여주는 스크린샷.

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

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

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

  • GitHub Enterprise Server 인스턴스에 대한 SSH 액세스 권한이 있습니다.
  • TCP 포트 443을 통한 아웃바운드 HTTPS 연결은 GitHub Enterprise Server 인스턴스에서 enterprise-bundles.github.comesbtoolsproduction.blob.core.windows.net 허용됩니다.
  1. 번들을 지원 번들 서버에 업로드합니다.
    $ ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'

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

지원 번들에는 지난 2일 동안의 로그가 포함되며, 추가 지원 번들에는 지난 7일 동안의 로그가 포함됩니다. 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/ 을 방문하여 지원을 받을 자격이 있는 엔터프라이즈 계정에 로그인합니다(메시지가 표시되는 경우). 1. https://support.github.com/uploads 을 방문하여 지원 번들을 업로드합니다.

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

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

  • GitHub Enterprise Server 인스턴스에 대한 SSH 액세스 권한이 있습니다.
  • TCP 포트 443을 통한 아웃바운드 HTTPS 연결은 GitHub Enterprise Server 인스턴스에서 enterprise-bundles.github.comesbtoolsproduction.blob.core.windows.net 허용됩니다.
  1. 번들을 지원 번들 서버에 업로드합니다.
    $ ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u -x'

추가 참고 자료