Сведения об экспорте данных журнала аудита и событий Git
Вы можете экспортировать журнал аудита, скачав JSON или CSV-файл с вашего предприятия на .GitHub При экспорте событий журнала аудита можно запросить один или несколько поддерживаемых квалификаторов, чтобы отфильтровать определенные события журнала для экспорта. См . раздел AUTOTITLE.
Журнал аудита перечисляет события, активируемые действиями, влияющими на ваше предприятие за последние 180 дней. События Git хранятся в журнале аудита семь дней —
Можно экспортировать данные событий Git, скачав JSON-файл из журнала аудита предприятия. В отличие от данных журнала аудита, вы не можете запрашивать определенные события Git для фильтрации и экспорта в пользовательском интерфейсе журнала аудита.
Примечание.
При экспорте событий Git события, инициированные через веб-браузер или REST или API GraphQL, не включаются. Например, если пользователь объединяет запрос на вытягивание в веб-браузере, изменения отправляются в базовую ветвь, но событие Git для этой отправки в экспорт не включается.
В качестве альтернативы экспорту событий журнала можно использовать API для получения событий аудита. Дополнительные сведения см. в разделе Использование API журнала аудита для предприятия.
Ограничения экспорта
Существует жёсткое ограничение при экспорте журналов аудита для вашего предприятия. Эти ограничения могут быть либо:
- 100 МБ сжатый файл, или
- 10 минут экспорта на обработку, или
- И то, и другое.
Чтобы избежать этих ограничений, мы рекомендуем фильтровать журнал аудита в меньший набор данных перед экспортом. Дополнительные сведения см. в разделе Доступ к журналу аудита для предприятия.
Если вы планируете просматривать большой набор аудиторских журналов, мы рекомендуем транслировать ваши логи во внешнюю систему управления данными. Дополнительные сведения см. в разделе Потоковая передача журнала аудита для предприятия.
Экспортированные ключи и значения логарифма
В файле, который будет создан после экспорта журнала, вы найдете указанные ниже ключи и значения.
| Ключ | Пример значения |
|---|---|
action | team.create |
actor | octocat |
user | codertocat |
actor_location.country_code | US |
org | octo-org |
repo | octo-org/documentation |
created_at | 1429548104000 (Метка времени показывает время, прошедшее после Epoch, в миллисекундах.) |
data.email | octocat@nowhere.com |
data.hook_id | 245 |
data.events | ["issues", "issue_comment", "pull_request", "pull_request_review_comment"] |
data.events_were | ["push", "pull_request", "issues"] |
data.target_login | octocat |
data.old_user | hubot |
data.team | octo-org/engineering |
Экспорт данных журнала аудита
- Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
- В левой части страницы на боковой панели учетной записи предприятия щелкните Settings.
- В разделе "Параметры" щелкните журнал аудита.
- При необходимости можно экспортировать только отфильтрованные результаты, выполнить поиск по одному или нескольким поддерживаемым квалификаторами или фильтрам журналов.
- Выберите выпадающее меню «Экспорт» и выберите формат файла.
Экспорт данных событий Git
Можно также экспортировать данные событий Git по диапазону дат. Данные экспортируются в виде сжатого файла JSON с разделителями новой строки.
-
Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
-
В левой части страницы на боковой панели учетной записи предприятия щелкните Settings.
-
В разделе "Параметры" щелкните журнал аудита.
-
Выберите выпадающее меню «Экспорт Git Events» и выберите диапазон дат для экспорта событий журнала.
-
Нажмите «Скачать результаты».
-
Чтобы извлечь данные JSON, распакуйте файл с помощью клиента или команды архивной программы. Например:
gunzip export-avocado-corp-1642896556.json.gz