Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

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

Поскольку у GitHub Support нет доступа к вашей среде, иногда нам требуются дополнительные сведения.

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

GitHub Support может попросить вас предоставить дополнительные данные в виде очищенных файлов журналов. Вас могу попросить предоставить три типа файлов журналов.

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

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

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

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

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

Создание диагностического файла в Management Console

Этот метод можно использовать, если у вас нет ключа SSH.

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

    Снимок экрана: значок ракетного корабля для доступа к параметрам администратора сайта

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

    Снимок экрана: ссылка "Администратор сайта" 1. На боковой панели слева нажмите Management Console . Вкладка "Management Console" на боковой панели слева 1. При появлении запроса введите пароль Management Console. Экран разблокировки Management Console 4. В правом верхнем углу Management Console нажмите Поддержка. Кнопка для доступа к области поддержки

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

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

Этот метод можно использовать без входа в Management Console.

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

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

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

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

  • журналы, связанные с проверкой подлинности, которые могут быть полезны при устранении ошибок проверки подлинности или настройке LDAP, CAS или SAML;
  • журнал Management Console;
  • 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: журналы Collectd;
  • mail-logs/mail.log: журналы доставки электронной почты SMTP.

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

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

Совет. При обращении в GitHub Support вам будет отправлено сообщение с подтверждением, которое будет содержать ссылку на ваше обращение. Если GitHub Support запрашивает у вас пакет поддержки, можно использовать ссылку на обращение для отправки пакета поддержки.

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

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

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

    Снимок экрана: значок ракетного корабля для доступа к параметрам администратора сайта

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

    Снимок экрана: ссылка "Администратор сайта" 1. На боковой панели слева нажмите Management Console . Вкладка "Management Console" на боковой панели слева 1. При появлении запроса введите пароль Management Console. Экран разблокировки Management Console 4. В правом верхнем углу Management Console нажмите Поддержка. Кнопка для доступа к области поддержки

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

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

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

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

Примечание. При использовании конфигурации георепликации или кластеризации 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 щелкните фотографию профиля и выберите Ваши предприятия. Раздел "Ваши предприятия" в раскрывающемся меню для фотографии профиля в GitHub Enterprise Server

  3. В списке предприятий щелкните предприятие, которое требуется просмотреть. Название предприятия в списке ваших предприятий 1. На боковой панели корпоративной учетной записи щелкните Параметры. Вкладка "Параметры" на боковой панели корпоративной учетной записи

  4. На боковой панели слева щелкните Корпоративное лицензирование. Снимок экрана: ссылка "Корпоративное лицензирование" на боковой панели параметров корпоративной учетной записи

  5. В разделе "Справка по GitHub Enterprise" нажмите Отправить пакет поддержки. Снимок экрана: пункт "Отправить ссылку на пакет поддержки".

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

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

  8. Щелкните Отправить.

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

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

  • У вас есть доступ по протоколу SSH к your GitHub Enterprise Server instance.
  • Исходящие подключения HTTPS через TCP-порт 443 разрешены из your GitHub Enterprise Server instance в enterprise-bundles.github.com и esbtoolsproduction.blob.core.windows.net.
  1. Отправьте пакет на наш сервер пакетов поддержки:
    $ ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'

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

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

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

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

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

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

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

  • У вас есть доступ по протоколу SSH к your GitHub Enterprise Server instance.
  • Исходящие подключения HTTPS через TCP-порт 443 разрешены из your GitHub Enterprise Server instance в enterprise-bundles.github.com и esbtoolsproduction.blob.core.windows.net.
  1. Отправьте пакет на наш сервер пакетов поддержки:
    $ ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u -x'

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