Skip to main content

Como exportar a atividade do log de auditoria da sua empresa

Você pode exportar dados de eventos Git e de auditoria para um arquivo para análise offline.

Quem pode usar esse recurso?

Enterprise owners

Sobre as exportações de dados de eventos do Git e do log de auditoria

Você pode exportar o log de auditoria baixando um arquivo JSON ou CSV da sua empresa no GitHub Enterprise Cloud. Ao exportar eventos do log de auditoria, você pode consultar o log por um ou mais desses qualificadores compatíveis para filtrar eventos de log específicos para exportação. Confira "Como fazer pesquisas no log de auditoria para sua empresa".

O log de auditoria lista os eventos acionados por atividades que afetaram sua empresa nos últimos 180 dias. O log de auditoria mantém os eventos do Git por sete dias.

Você pode exportar dados de eventos do Git baixando um arquivo JSON do log de auditoria da sua empresa. Ao contrário dos dados do log de auditoria, você não pode consultar eventos específicos do Git para filtragem e exportação na interface do usuário do log de auditoria.

Observação: quando você exporta eventos Git, eventos que foram iniciados por meio do navegador da Web ou as APIs REST ou GraphQL não são incluídos. Por exemplo, quando um usuário mescla uma solicitação de pull no navegador da Web, as alterações são enviadas por push para o branch base, mas o evento Git para esse push não está incluído na exportação.

Depois de exportar o log, você verá as seguintes chaves e valores no arquivo resultante.

ChaveValor de exemplo
actionteam.create
actoroctocat
usercodertocat
actor_location.country_codeEUA
orgocto-org
repoocto-org/documentation
created_at1429548104000 (o registro de data e hora mostra o tempo desde a era Epoch em milissegundos.)
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

Como alternativa à exportação de eventos de log, você pode usar a API para recuperar eventos de log de auditoria ou configurar o GitHub Enterprise Cloud para transmitir os dados de auditoria à medida que os eventos são registrados. Para obter mais informações, confira "Como usar a API do log de auditoria para sua empresa" e "Como transmitir o log de auditoria para sua empresa."

Como exportar os dados de log de auditoria

  1. No canto superior direito do GitHub, selecione sua foto de perfil.
  2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
  3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Configurações.
  4. Em " Configurações", clique em Log de auditoria.
  5. Opcionalmente, para exportar apenas os resultados filtrados, pesquise por um ou mais qualificadores ou filtros de log compatíveis.
  6. Selecione o menu suspenso Exportar e clique em um formato de arquivo.

Como exportar os dados de eventos do Git

Você também pode exportar os dados de eventos do Git por intervalo de datas. Os dados são exportados como um arquivo JSON compactado e delimitado por novas linhas.

  1. No canto superior direito do GitHub, selecione sua foto de perfil.

  2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.

  3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Configurações.

  4. Em " Configurações", clique em Log de auditoria.

  5. Selecione o menu suspenso Exportar eventos do Git e escolha um intervalo de datas para os eventos de log que serão exportados.

  6. Clique em Baixar Resultados.

  7. Para extrair os dados JSON, descompacte o arquivo usando um comando ou um cliente de utilitário de arquivos. Por exemplo:

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