Предоставление данных для службы поддержки GitHub

Сведения о файлах диагностики и пакетах поддержки

Чтобы устранить неполадки с экземпляром GitHub Enterprise Server в вашей среде, Служба поддержки GitHub может запрашивать один или несколько типов данных.

Data	File format	Description
Файл диагностики	Открытый текст	Содержит сведения о параметрах и среде экземпляра.
Пакет поддержки	Архив	Содержит файл диагностика и файлы журнала с очисткой за последние два дня по умолчанию.
Пакет расширенной поддержки	Архив	Содержит файл диагностика и файлы журналов, которые были удалены за последние восемь дней.

Сведения об очистке файлов журнала

Маркеры проверки подлинности, ключи и секреты удаляются из файлов журналов в следующих каталогах журналов, содержащихся в пакете поддержки или файле диагностики:

• 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;
• Архитектура виртуальной машины
• имя узла, частный режим, параметры SSL;
• списки загрузки и процессов;
• Параметры сети
• метод проверки подлинности и подробности;
• количество репозиториев, пользователей и другие данные установки.

Можно скачать диагностику для своего экземпляра из Консоль управления или с помощью программы командной строки ghe-diagnostics.

Создание диагностического файла в Консоль управления

Вы можете создать файл диагностики из Консоль управления, если у вас нет доступа К SSH.

1. В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .

2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.

3. На боковой панели " "Администратор сайта" щелкните Консоль управления.

4. Если вы создали несколько учетных записей пользователей Консоль управления, выберите администратора корневого сайта или Консоль управления пользователя. Дополнительные сведения о учетных записях пользователей Консоль управления см. в разделе Управление доступом к консоли управления.

5. Введите учетные данные Консоль управления . Затем нажмите кнопку Продолжить.

6. В верхней панели навигации нажмите кнопку "Поддержка".

   

7. Нажмите кнопку Скачать диагностические сведения.

Создание диагностического файла с помощью SSH

Этот метод можно использовать без входа в Консоль управления.

Используйте служебную программу командной строки ghe-diagnostics для получения диагностических сведений для вашего экземпляра.

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

Создание и отправка пакетов поддержки

После отправки запроса на поддержку мы можем попросить вас предоставить нашей команде пакет поддержки. Пакет поддержки — это архив tar со сжатием gzip, который включает диагностические данные и важные журналы из вашего экземпляра, такие как:

• журналы, связанные с проверкой подлинности, которые могут быть полезны при устранении ошибок проверки подлинности или настройке 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: журналы Collectd;

• mail-logs/mail.log: журналы доставки электронной почты SMTP.

Дополнительные сведения см. в разделе Сведения о журнале аудита для предприятия.

Пакеты поддержки включают журналы за последние два дня по умолчанию. Вы можете указать точную длительность в днях. Чтобы предоставить журналы за последние восемь дней, можно скачать расширенный пакет поддержки. Дополнительные сведения см. в статье "Создание и совместное использование пакетов расширенной поддержки".

Создание пакета поддержки в Консоль управления

Эти действия можно использовать для создания и отправки пакета поддержки, если вы можете получить доступ к веб-версии Консоль управления и имеете исходящий доступ к Интернету.

1. В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .

2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.

3. На боковой панели " "Администратор сайта" щелкните Консоль управления.

4. Если вы создали несколько учетных записей пользователей Консоль управления, выберите администратора корневого сайта или Консоль управления пользователя. Дополнительные сведения о учетных записях пользователей Консоль управления см. в разделе Управление доступом к консоли управления.

5. Введите учетные данные Консоль управления . Затем нажмите кнопку Продолжить.

6. В верхней панели навигации нажмите кнопку "Поддержка".

   

7. Щелкните Скачать пакет поддержки.

8. Если инженер службы поддержки предоставил вам ссылку для отправки пакета поддержки, используйте эту ссылку. В противном случае перейдите на страницу https://support.github.com/ и войдите (при появлении запроса) в учетную запись предприятия, у которой есть право на поддержку.

9. Перейдите на страницу https://support.github.com/uploads и отправьте пакет поддержки.

Создание пакета поддержки с помощью SSH

Эти действия можно использовать для создания и совместного использования пакета поддержки, если у вас есть SSH-доступ к ваш экземпляр GitHub Enterprise Server и исходящий доступ к Интернету.

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 Enterprise Cloud.

2. В правом верхнем углу GitHubщелкните фото профиля, а затем щелкните "Ваши предприятия".

3. В списке предприятий щелкните предприятие, которое требуется просмотреть.

4. В левой части страницы на боковой панели учетной записи предприятия щелкните Параметры.

5. В разделе Settings, щелкните License.

6. В разделе "Справка по GitHub Enterprise" нажмите Отправить пакет поддержки.

   

7. В разделе "Выбор учетной записи предприятия" используйте раскрывающееся меню, чтобы выбрать связанную учетную запись пакета поддержки.

8. В разделе "Отправить пакет поддержки для Поддержка GitHub Enterprise" нажмите кнопку Выбрать файл или перетащите файл пакета поддержки в поле Выбрать файл, чтобы выбрать пакет поддержки.

9. Нажмите кнопку Отправить.

Отправка пакета поддержки напрямую по SSH

Можно отправить пакет поддержки напрямую на наш сервер, если:

• У вас есть SSH-доступ к ваш экземпляр GitHub Enterprise Server.
• Исходящие подключения HTTPS через TCP-порт 443 разрешены от ваш экземпляр GitHub Enterprise Server до enterprise-bundles.github.com и esbtoolsproduction.blob.core.windows.net.

1. Отправьте пакет на наш сервер пакетов поддержки:

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

Создание и отправка расширенных пакетов поддержки

Пакеты поддержки включают журналы за последние два дня по умолчанию, а __ расширенные пакеты поддержки включают журналы за последние восемь дней. Если события, которые изучает Служба поддержки GitHub произошли более двух дней назад, мы можем попросить вас предоставить расширенный пакет поддержки. Вам потребуется доступ по протоколу SSH для скачивания расширенного пакета. Нельзя скачать расширенный пакет с помощью Консоль управления.

Чтобы избежать создания слишком больших пакетов, пакеты содержат только журналы, которые не были ротированы и сжаты. Ротация журналов в GitHub Enterprise Server выполняется с различной периодичностью (ежедневно или еженедельно) для разных файлов журналов в зависимости от того, насколько большим ожидается их размер.

Создание пакета расширенной поддержки с помощью SSH

Эти действия можно использовать для создания и совместного использования расширенного пакета поддержки, если у вас есть SSH-доступ к ваш экземпляр GitHub Enterprise Server и у вас есть исходящий доступ к Интернету.

1. Скачайте пакет расширенной поддержки через SSH, добавив флаг -x в команду ghe-support-bundle:

   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.
• Исходящие подключения HTTPS через TCP-порт 443 разрешены от ваш экземпляр GitHub Enterprise Server до enterprise-bundles.github.com и esbtoolsproduction.blob.core.windows.net.

1. Отправьте пакет на наш сервер пакетов поддержки:

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

Дополнительные материалы

• Сведения о поддержке GitHub
• Создание проверки работоспособности для предприятия