Skip to main content

Экспорт действий журнала аудита для предприятия

Данные аудита и событий Git можно экспортировать в файл для автономного анализа.

Кто может использовать эту функцию?

Enterprise owners

Сведения об экспорте данных журнала аудита и событий Git

Вы можете экспортировать журнал аудита, скачав JSON или CSV-файл с вашего предприятия на .GitHub При экспорте событий журнала аудита можно запросить один или несколько поддерживаемых квалификаторов, чтобы отфильтровать определенные события журнала для экспорта. См . раздел AUTOTITLE.

Журнал аудита перечисляет события, активируемые действиями, влияющими на ваше предприятие за последние 180 дней. События Git хранятся в журнале аудита семь дней —

Можно экспортировать данные событий Git, скачав JSON-файл из журнала аудита предприятия. В отличие от данных журнала аудита, вы не можете запрашивать определенные события Git для фильтрации и экспорта в пользовательском интерфейсе журнала аудита.

Примечание.

При экспорте событий Git события, инициированные через веб-браузер или REST или API GraphQL, не включаются. Например, если пользователь объединяет запрос на вытягивание в веб-браузере, изменения отправляются в базовую ветвь, но событие Git для этой отправки в экспорт не включается.

В качестве альтернативы экспорту событий журнала можно использовать API для получения событий аудита. Дополнительные сведения см. в разделе Использование API журнала аудита для предприятия.

Ограничения экспорта

Существует жёсткое ограничение при экспорте журналов аудита для вашего предприятия. Эти ограничения могут быть либо:

  • 100 МБ сжатый файл, или
  • 10 минут экспорта на обработку, или
  • И то, и другое.

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

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

Экспортированные ключи и значения логарифма

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

КлючПример значения
actionteam.create
actoroctocat
usercodertocat
actor_location.country_codeUS
orgocto-org
repoocto-org/documentation
created_at1429548104000 (Метка времени показывает время, прошедшее после Epoch, в миллисекундах.)
data.emailoctocat@nowhere.com
data.hook_id245
data.events["issues", "issue_comment", "pull_request", "pull_request_review_comment"]
data.events_were["push", "pull_request", "issues"]
data.target_loginoctocat
data.old_userhubot
data.teamocto-org/engineering

Экспорт данных журнала аудита

  1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
  2. В левой части страницы на боковой панели учетной записи предприятия щелкните Settings.
  3. В разделе "Параметры" щелкните журнал аудита.
  4. При необходимости можно экспортировать только отфильтрованные результаты, выполнить поиск по одному или нескольким поддерживаемым квалификаторами или фильтрам журналов.
  5. Выберите выпадающее меню «Экспорт» и выберите формат файла.

Экспорт данных событий Git

Можно также экспортировать данные событий Git по диапазону дат. Данные экспортируются в виде сжатого файла JSON с разделителями новой строки.

  1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.

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

  3. В разделе "Параметры" щелкните журнал аудита.

  4. Выберите выпадающее меню «Экспорт Git Events» и выберите диапазон дат для экспорта событий журнала.

  5. Нажмите «Скачать результаты».

  6. Чтобы извлечь данные JSON, распакуйте файл с помощью клиента или команды архивной программы. Например:

    gunzip export-avocado-corp-1642896556.json.gz