Сведения о системных журналах

Сведения о системных журналах для GitHub Enterprise Server

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

Файлы журнала обычного текста на диске, хранящиеся в системном журнале или определенных службах
Двоичные файлы журнала, хранящиеся в журнале

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

Пользователи с административным доступом SSH к экземпляру GitHub Enterprise Server могут получать доступ к системным журналам и считывать их. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).

Вы можете пересылать системные журналы и журналы аудита во внешнюю систему для анализа или более длительного хранения. Дополнительные сведения см. в разделе [AUTOTITLE и Пересылка журналов](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise).

Помимо просмотра системных журналов, вы можете отслеживать действия в экземпляре другими способами. Например, можно просматривать журналы аудита и отправлять журналы или настраивать глобальные веб-перехватчики. Дополнительные сведения см. в разделе Мониторинг активности на предприятии.

Примечание.

Следующие списки журналов не предназначены для полного использования.

Файлы системного журнала

GitHub Enterprise Server записывает несколько категорий системных журналов на диск экземпляра в виде обычного текста. Пользователи с правами администратора SSH для экземпляра могут анализировать эти файлы с помощью таких средств командной строки Linux, как cat, , tail``headи less``more.

        [Файлы журналов для баз данных](#log-files-for-databases)

        [Файлы журнала для приложения GitHub](#log-files-for-the-github-application)

        [Файлы журнала для HTTP-сервера](#log-files-for-the-http-server)

        [Файлы журнала для Консоль управления](#log-files-for-the-management-console)

        [Файлы журнала для конфигурации экземпляра](#log-files-for-instance-configuration)

        [Файлы журнала для поиска](#log-files-for-search)

        [Файлы журналов для системных служб](#log-files-for-system-services)

Файлы журналов для баз данных

Следующие файлы журнала записывают события из служб баз данных в экземпляре.

Путь	Description
/var/log/mysql/mysql.log	Записывает события, связанные с базой данных MySQL экземпляра.
/var/log/mysql/mysql.err	Записывает ошибки, связанные с базой данных MySQL экземпляра.
/data/user/mssql/log/errorlog	Записывает ошибки, связанные с базой данных MSSQL экземпляра. Дополнительные сведения о других событиях см . в журналах для баз данных далее в этой статье.

Файлы журнала для приложения GitHub

Следующие файлы журнала записывают события из приложения GitHub в вашем экземпляре.

Путь	Description
/var/log/github/audit.log	Записывает события пользователя, репозитория и системы для действий в приложении GitHub в вашем экземпляре. Вы можете фильтровать записи в журнале с помощью ключевого `github_audit` слова.
/var/log/github/exceptions.log	Записывает исключения, с которыми сталкивается приложение GitHub.
/var/log/github/gitauth.log	Записывает запросы проверки подлинности Git с помощью ПРОТОКОЛА HTTPS или SSH. Служба `babeld` обрабатывает все запросы и действия проверки подлинности Git.
/var/log/github/production.log	Записывает внутренние события для приложения GitHub. Для запросов на веб-сайт включает действие контроллера, которое ответило. Может содержать записи с различными структурами в зависимости от источника задания или запроса.

Файлы журнала для HTTP-сервера

Следующие файлы журнала записывают события с HTTP-сервера экземпляра.

Путь	Description
/var/log/nginx/error.log*	Записывает ошибки для веб-запросов.
/var/log/nginx/gist.log	Записывает HTTP-запросы, связанные с gists. Дополнительные сведения см. в разделе Создание gist.
/var/log/nginx/gist.error.log	Записывает ошибки, связанные с HTTP-запросами для gists.
/var/log/nginx/github.log	Записывает HTTP-запросы в приложение GitHub.
/var/log/nginx/github.error.log	Записывает ошибки, связанные с HTTP-запросами.
/var/log/nginx/pages.log	Записывает HTTP-запросы, связанные с данными GitHub Pages. Дополнительные сведения см. в разделе Что такое GitHub Pages?.
/var/log/nginx/pages.error.log	Записывает ошибки, связанные с HTTP-запросами для GitHub Pages.

Файлы журнала для Консоль управления

Следующие файлы журнала содержат события из данных Консоль управления. Дополнительные сведения см. в разделе Сведения о консоли управления.

Путь	Description
/var/log/enterprise-manage/audit.log	Записывает действие в данных экземпляра variables.enterprise.management_console %}.
/var/log/enterprise-manage/unicorn.log	Записывает операции HTTP и HTTPS, выполняемые администраторами в Консоль управления с помощью веб-интерфейса или REST API.

Файлы журнала для конфигурации экземпляра

Следующие файлы журнала содержат события, связанные с конфигурацией экземпляра.

Путь	Description
/data/user/common/ghe-config.log	Записывает события, связанные с последним запуском конфигурации. Если выполнение конфигурации завершается сбоем, выходные данные в журнал останавливается. Этот журнал также записывает сведения о миграциях, выполняемых во время обновления программного обеспечения экземпляра. Дополнительные сведения см. в разделе Служебные программы командной строки.
/data/user/config-apply/logs/YYYYMMDD/*	Хранит файлы журналов для предыдущих запусков конфигурации. Экземпляр хранит файлы в каталоге, который отражает дату, и каждое имя файла отражает узел и идентификатор запуска.

Путь

Description

/data/user/common/ghe-config.log

Записывает события, связанные с последним запуском конфигурации. Если выполнение конфигурации завершается сбоем, выходные данные в журнал останавливается. Этот журнал также записывает сведения о миграциях, выполняемых во время обновления программного обеспечения экземпляра. Дополнительные сведения см. в разделе Служебные программы командной строки.

/data/user/config-apply/logs/YYYYMMDD/*

Хранит файлы журналов для предыдущих запусков конфигурации. Экземпляр хранит файлы в каталоге, который отражает дату, и каждое имя файла отражает узел и идентификатор запуска.

Файлы журнала для поиска

Следующие файлы журналов содержат события из служб, которые предоставляют функции поиска для вашего экземпляра.

Путь	Description
/var/log/elasticsearch/github-enterprise.log	Записывает события, связанные со службой Elasticsearch, которая используется экземпляром для предоставления служб поиска.

Файлы журналов для системных служб

Следующие журналы содержат события из системных служб в экземпляре.

Путь	Description
/var/log/coredumps.log	Записывает сведения о системных процессах, которые неожиданно завершаются.
/var/log/boot.log	Записывает сведения о процессе загрузки экземпляра.
/var/log/chrony/	Этот каталог содержит журналы, связанные с синхронизацией протокола NTP и системными часами экземпляра. Дополнительные сведения см. в разделе Настройка синхронизации времени.
/var/log/haproxy.log	Записывает все веб-запросы и запросы API к экземпляру. Для HTTP-подключений записи содержат URL-адрес, запрошенный клиентом, а также метод HTTP для запроса.
/var/log/ssh-console-audit.log	Записывает команды, выполняемые администраторами с помощью административной оболочки (SSH). Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).
/var/log/mail-replies/metroplex.log	Записывает сведения о почте, которую получает ваш экземпляр. Дополнительные сведения см. в разделе Настройка электронной почты для получения уведомлений.

Системные журналы в системном журнале

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

Пользователи с правами администратора SSH для экземпляра могут анализировать эти журналы с помощью journalctl команды. Дополнительные сведения см . в разделе journalctl(1) на страницах вручную для Linux.

Чтобы просмотреть журналы в системном журнале, выполните следующую команду, заменив SERVICE-NAME именем службы из следующего списка журналов. Для просмотра журналов всех других контейнерных служб запустите nomad job status и используйте ID его в качестве ИМЕНИ СЛУЖБЫ.

journalctl -t SERVICE-NAME

        [Журналы журналов для приложения GitHub](#journal-logs-for-the-github-application)

        [Журналы журналов для Git](#journal-logs-for-git)

        [Журналы журналов для хранилища](#journal-logs-for-storage)

Журналы журналов для приложения GitHub

Следующие журналы записывают события из приложения GitHub в вашем экземпляре.

Название сервиса	Description
github-resqued	Записывает события, связанные с фоновыми заданиями. Если задание включает встроенную или внешнюю проверку подлинности, этот журнал содержит сведения о запросе. Если экземпляр использует проверку подлинности LDAP и синхронизацию LDAP включен, события синхронизации LDAP отображаются в этом журнале. Дополнительные сведения см. в разделе Использование протокола LDAP.
github-unicorn	Записывает операции HTTP и HTTPS, выполняемые пользователями в веб-интерфейсе экземпляра или через API. Если операция включает встроенную или внешнюю проверку подлинности, этот журнал содержит сведения о запросе. Если ведение журнала отладки включено для проверки подлинности LDAP или SAML, сведения об уровне отладки для прошедших проверку подлинности запросов отображаются в этом журнале. Дополнительные сведения см. в разделе [AUTOTITLE или Использование протокола LDAP](/admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication#configuring-saml-debugging).

Название сервиса

Description

github-resqued

Записывает события, связанные с фоновыми заданиями. Если задание включает встроенную или внешнюю проверку подлинности, этот журнал содержит сведения о запросе.

Если экземпляр использует проверку подлинности LDAP и синхронизацию LDAP включен, события синхронизации LDAP отображаются в этом журнале. Дополнительные сведения см. в разделе Использование протокола LDAP.

github-unicorn

Записывает операции HTTP и HTTPS, выполняемые пользователями в веб-интерфейсе экземпляра или через API. Если операция включает встроенную или внешнюю проверку подлинности, этот журнал содержит сведения о запросе.

Если ведение журнала отладки включено для проверки подлинности LDAP или SAML, сведения об уровне отладки для прошедших проверку подлинности запросов отображаются в этом журнале. Дополнительные сведения см. в разделе [AUTOTITLE или Использование протокола LDAP](/admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication#configuring-saml-debugging).

Журналы журналов для Git

В следующих журналах содержатся события, связанные с действием Git в экземпляре.

Название сервиса	Description
babeld	Записывает события для всех действий Git в экземпляре, включая проверку подлинности для доступа к репозиторию.
codeload	Записывает события для действий, связанных с созданием или извлечением архивов кода для репозиториев в экземпляре.
gpgverify	Записывает события, связанные с проверкой подписи. Дополнительные сведения см. в разделе Сведения о проверке подписи фиксации.

Журналы журналов для хранилища

В следующих журналах содержатся события из служб, которые хранят или извлекают данные в экземпляре.

Название сервиса	Description
alambic	Записывает события, связанные с хранилищем и извлечением файлов, таких как Git LFS , изображения аватаров, вложения файлов из комментариев в веб-интерфейсе и архивы выпуска.

Журналы журналов для баз данных

В следующих журналах содержатся события, связанные со службами баз данных в экземпляре.

Название сервиса	Description
mysql	Записывает события, связанные с базой данных MySQL экземпляра.
mssql	Записывает события, связанные с базой данных MSSQL экземпляра.

Журналы журналов для веб-перехватчиков

Следующие файлы журнала содержат события, связанные с веб-перехватчиками, которые отправляет экземпляр.

Название сервиса	Description
hookshot-go	Записывает события для всех действий веб-перехватчика в экземпляре, включая триггерные веб-перехватчики, поставки и сбои.

Сведения о системных журналах в пакетах поддержки

Если вы создаете пакет поддержки, файл содержит системные журналы. Дополнительные сведения см. в разделе Предоставление данных в поддержку GitHub.

В этой статье