Acerca de las exportaciones del registro de auditoría y los datos de eventos de Git
Para exportar el registro de auditoría, descargue un archivo JSON o CSV de su empresa en GitHub. Al exportar eventos de registro de auditoría, puede consultar uno o varios de estos calificadores compatibles para filtrar los eventos de registro específicos que desee exportar. Consulta Búsqueda en el registro de auditoría de la empresa.
El registro de auditoría enumera eventos activados por las actividades que afectan a tu empresa dentro de los últimos 180 días. La bitácora de auditoría retiene eventos de Git por siete días.
Para exportar los datos de eventos de Git, descargue un archivo JSON desde el registro de auditoría de la empresa. A diferencia de los datos de registro de auditoría, no puede consultar eventos de Git específicos para filtrar y exportar en la interfaz de usuario del registro de auditoría.
Nota:
Al exportar eventos de Git, no se incluyen los eventos que se iniciaron a través del explorador web o las API de REST o GraphQL. Por ejemplo, cuando un usuario combina una solicitud de incorporación de cambios en el explorador web, los cambios se insertan en la rama base, pero el evento de Git de esa inserción no se incluye en la exportación.
Como alternativa a la exportación de eventos de registro, puede usar la API para recuperar eventos de registro de auditoría. Para obtener más información, vea Uso de la API de registro de auditoría para la empresa.
Límites de exportación
Hay un límite estricto al exportar los registros de auditoría de su empresa. Estos límites son:
- Archivo comprimido de 100 MB o
- Tiempo de procesamiento de exportación de 10 minutos o
- ambos.
Para evitar estos límites, se recomienda filtrar el registro de auditoría a un conjunto de datos más pequeño antes de exportarlo. Para obtener más información, vea Búsqueda en el registro de auditoría de la empresa.
Si piensa revisar un gran conjunto de datos de registros de auditoría, se recomienda transmitir los registros a un sistema de administración de datos externo. Para obtener más información, vea Streaming del registro de auditoría de su empresa.
Claves y valores de registro exportados
Después de exportar el registro, verá los siguientes valores y claves en el archivo resultante.
| Clave | Valor de ejemplo |
|---|---|
action | team.create |
actor | octocat |
user | codertocat |
actor_location.country_code | US |
org | octo-org |
repo | octo-org/documentation |
created_at | 1429548104000 (Los registros horarios muestran la hora desde Epoch con milisegundos). |
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 |
Exportación de datos de registro de auditoría
- Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
- En la parte superior de la página, haz clic en Settings.
- En "Configuración", haz clic en Registro de auditoría.
- Para exportar solo los resultados filtrados, también puede buscar usando uno o varios calificadores o filtros de registro admitidos.
- Seleccione el menú desplegable Exportar y haga clic en un formato de archivo.
Exportación de datos de eventos de Git
También puede exportar los datos de eventos de Git por intervalo de fechas. Los datos se exportan como un archivo JSON comprimido delimitado por líneas nuevas.
-
Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
-
En la parte superior de la página, haz clic en Settings.
-
En "Configuración", haz clic en Registro de auditoría.
-
Seleccione el menú desplegable Exportar eventos de Git y elija un intervalo de fechas para el que exportar eventos de registro.
-
Haga clic en Descargar resultados.
-
Para extraer los datos JSON, descomprima el archivo mediante un comando o cliente de la utilidad de archivo. Por ejemplo:
gunzip export-avocado-corp-1642896556.json.gz