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

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

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

Data	Формат файла	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;
списки загрузки и процессов;
Параметры сети
метод проверки подлинности и подробности;
количество репозиториев, пользователей и другие данные установки.

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

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

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

В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .
Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.
На боковой панели " "Администратор сайта" щелкните Консоль управления.
Если вы создали несколько учетных записей пользователей Консоль управления, выберите администратора корневого сайта или Консоль управления пользователя. Дополнительные сведения о учетных записях пользователей Консоль управления см. в разделе Управление доступом к консоли управления.
Введите учетные данные Консоль управления . Затем нажмите кнопку Продолжить.
В верхней панели навигации нажмите кнопку "Поддержка".
Нажмите кнопку Скачать диагностические сведения.

Создание диагностического файла с помощью 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.

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

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

Совет

Когда вы свяжетесь Служба поддержки GitHubс ним, вам придётся письмо с подтверждением с ссылкой на тикет. Если Служба поддержки GitHub вас попросят загрузить пакет поддержки, вы можете воспользоваться ссылкой на тикет, чтобы загрузить пакет поддержки.

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

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

В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .
Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.
На боковой панели " "Администратор сайта" щелкните Консоль управления.
Если вы создали несколько учетных записей пользователей Консоль управления, выберите администратора корневого сайта или Консоль управления пользователя. Дополнительные сведения о учетных записях пользователей Консоль управления см. в разделе Управление доступом к консоли управления.
Введите учетные данные Консоль управления . Затем нажмите кнопку Продолжить.
В верхней панели навигации нажмите кнопку "Поддержка".
Щелкните Скачать пакет поддержки.
Если инженер службы поддержки предоставил вам ссылку для отправки пакета поддержки, используйте эту ссылку. В противном случае перейдите на страницу https://support.github.com/ и войдите (при появлении запроса) в учетную запись предприятия, у которой есть право на поддержку.
Перейдите на страницу https://support.github.com/uploads и отправьте пакет поддержки.

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

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

Примечание.

Если ваш экземпляр GitHub Enterprise Server находится в конфигурации георепликации или если экземпляр является кластером, следует использовать ghe-cluster-support-bundle команду для получения пакета поддержки. Дополнительные сведения см. в разделе Служебные программы командной строки.

Скачайте пакет поддержки через SSH:
```
ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o' > support-bundle.tgz
```
Дополнительные сведения о команде ghe-support-bundle см. в разделе Служебные программы командной строки.
Если инженер службы поддержки предоставил вам ссылку для отправки пакета поддержки, используйте эту ссылку. В противном случае перейдите на страницу https://support.github.com/ и войдите (при появлении запроса) в учетную запись предприятия, у которой есть право на поддержку.
Перейдите на страницу https://support.github.com/uploads и отправьте пакет поддержки.

Отправка пакета поддержки с использованием учетной записи предприятия

Перейдите к GitHub Enterprise Cloud.
В правом верхнем углу GitHubщелкните рисунок профиля.
В зависимости от среды щелкните Предприятие или щелкните Предприятия , а затем выберите предприятие, которое требуется просмотреть.
В левой части страницы на боковой панели учетной записи предприятия щелкните Settings.
В разделе Settings, click License.
В разделе «GitHub Enterprise Справка» нажмите Загрузить пакет поддержки.
В разделе "Выбор учетной записи предприятия" используйте раскрывающееся меню, чтобы выбрать связанную учетную запись пакета поддержки.
В разделе «Загрузить пакет поддержки для Поддержка GitHub Enterprise», чтобы выбрать свой пакет поддержки, нажмите Выбрать файл или перетащите файл пакета поддержки в Выбрать файл.
Нажмите кнопку Отправить.

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

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

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

Отправьте пакет на наш сервер пакетов поддержки:
```
ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'
```

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

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

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

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

Скачайте пакет расширенной поддержки через SSH, добавив флаг -x в команду ghe-support-bundle:
```
ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o -x' > support-bundle.tgz
```
Если инженер службы поддержки предоставил вам ссылку для отправки пакета поддержки, используйте эту ссылку. В противном случае перейдите на страницу https://support.github.com/ и войдите (при появлении запроса) в учетную запись предприятия, у которой есть право на поддержку.
Перейдите на страницу https://support.github.com/uploads и отправьте пакет поддержки.

Отправка пакета расширенной поддержки напрямую с помощью SSH