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 de sua empresa.GitHub Ao exportar eventos do log de auditoria, você pode consultar por um ou mais desses qualificadores compatíveis para filtrar eventos de log específicos para exportar. 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.
Como alternativa à exportação de eventos de log, você pode usar a API para recuperar eventos de log de auditoria. Para obter mais informações, consulte Como usar a API do log de auditoria para sua empresa.
Limites de exportação
Há um limite rígido ao exportar os logs de auditoria para sua empresa. Esses limites são:
- Arquivo compactado de 100 MB ou
- Tempo de processamento de exportação de 10 minutos ou
- ambos.
Para evitar esses limites, recomendamos filtrar o log de auditoria para um conjunto de dados menor antes de exportar. Para obter mais informações, consulte Como fazer pesquisas no log de auditoria para sua empresa.
Se você pretende examinar um grande conjunto de dados de logs de auditoria, recomendamos transmitir seus logs para um sistema de gerenciamento de dados externo. Para obter mais informações, consulte Como transmitir o log de auditoria para sua empresa.
Valores e chaves de log exportados
Depois de exportar o log, você verá as seguintes chaves e valores no arquivo resultante.
| Chave | Valor de exemplo |
|---|---|
action | team.create |
actor | octocat |
user | codertocat |
actor_location.country_code | EUA |
org | octo-org |
repo | octo-org/documentation |
created_at | 1429548104000 (o registro de data e hora mostra o tempo desde a era Epoch em milissegundos.) |
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 |
Como exportar os dados de log de auditoria
- Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
- Na parte superior da página, clique em Settings.
- Em "Configurações", clique em Audit log.
- Opcionalmente, para exportar apenas os resultados filtrados, pesquise por um ou mais qualificadores ou filtros de log compatíveis.
- 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.
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na parte superior da página, clique em Settings.
-
Em "Configurações", clique em Audit log.
-
Selecione o menu suspenso Exportar eventos do Git e escolha um intervalo de datas para exportar os eventos de log.
-
Clique em Baixar resultados.
-
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