Exportaciones totales

Puedes crear un receptor de exportación agregada que puede exportar entradas de registro desde todos los proyectos, carpetas y cuentas de facturación de una organización. Por ejemplo, puedes usar esta función para exportar entradas de registro de auditoría de proyectos de una organización a una ubicación central.

Concepto

Sin la función de exportación agregada, un receptor de exportación está limitado a exportar entradas de registro desde el recurso exacto en el que se creó: un proyecto, una organización, una carpeta o una cuenta de facturación.

Con la función de exportación agregada, si creas un receptor en una organización o una carpeta y, si estableces el parámetro includeChildren del receptor en True, ese receptor puede exportar entradas de registro de la organización o carpeta, así como (de forma recurrente) desde cualquier carpeta, cuenta de facturación o proyecto contenido. Puedes usar el filtro del receptor para elegir entradas de registro de proyectos específicos, tipos de recursos específicos o registros denominados específicos.

A fin de obtener información sobre receptores de exportación y cómo crearlos, consulta Exporta registros en la API y usa la herramienta de línea de comandos para crear receptores.

Crea el destino de exportación

El destino de exportación para los receptores de registros debe crearse antes del receptor, a través del SDK de Cloud, Cloud Console o las API de Cloud.

A continuación, se detallan los destinos de exportación compatibles para los receptores de exportación:

El destino de exportación puede crearse en cualquier proyecto de GCP, cualquier organización si la cuenta de servicio del receptor de registros tiene permisos para escribir al destino de exportación.

Crea un receptor de exportación agregada

A fin de crear un receptor de exportación agregada en organizaciones, carpetas o cuentas de facturación, puedes usar Google Cloud Endpoints o la herramienta de línea de comandos de gcloud.

API de Logging

A fin de crear un receptor de registros, usa organizations.sinks.create, folders.sinks.create o billingAccounts.sinks.create en la API de Stackdriver Logging. Prepara los argumentos para el método de la siguiente manera:

  1. Establece el parámetro parent a fin de que sea la cuenta de facturación, organización o carpeta en la que se crea el receptor. A continuación, se muestra una lista de los posibles superiores:

    organizations/[ORGANIZATION_ID]
    folders/[FOLDER_ID]
    billingAccounts/[BILLING_ACCOUNT_ID]
    

    Notas:

    • Debes tener la función de IAM Escritor de configuración de registros para el superior a fin de crear el receptor. A fin de obtener más información sobre las funciones de IAM de Stackdriver Logging, consulta la Guía de control de acceso.
  2. Haz lo siguiente en el objeto LogSink en el cuerpo de la solicitud del método:

    • Establece includeChildren como Verdadero.

    • Establece la propiedad filter; ten en cuenta que las entradas de registros de todos tus proyectos se compararán con el filtro.

      Para obtener algunos ejemplos útiles de filtros, consulta Usa filtros con exportaciones agregadas en esta página.

    • Establece los campos LogSink restantes como lo harías para cualquier otro receptor. A fin de obtener más información, consulta Crea receptores.

  3. Llama a organizations.sinks.create o folders.sinks.create para crear el receptor.

  4. Recupera el nombre de la cuenta de servicio usado para crear el receptor de la respuesta de la API.

  5. Otórgale a la cuenta de servicio permiso para escribir a tu destino de exportación.

    Si no tienes permiso para hacer ese cambio al destino de exportación, envía el nombre de la cuenta de servicio a alguien que pueda hacer ese cambio por ti.

    A fin de obtener más información sobre cómo otorgar permisos a cuentas de servicio para recursos, consulta Otorga funciones a cuentas de servicio.

SDK de Cloud

Para crear un receptor de registros, usa el comando logging sinks create.

  1. Proporciona el nombre del receptor, el destino de exportación, el filtro de registros y el ID de la organización, carpeta o cuenta de facturación.

    Por ejemplo, configura una exportación agregada a nivel de carpeta de la siguiente manera:

    gcloud logging sinks create [SINK_NAME]  \
    storage.googleapis.com/my-folder-bucket --include-children \
    --folder=[FOLDER_ID] --log-filter="logName:activity"
    

    Notas:

    • Si quieres crear un receptor a nivel de la organización, reemplaza --folder=[FOLDER_ID] por --organization=[ORG_ID]. Para una cuenta de facturación, reemplázalo por --billing-account=[BILLING_ACCOUNT_ID].

    • Para que el receptor incluya todos los proyectos dentro de la organización, la marca --include-children debe estar establecida, aun cuando la marca --organization pasa a create. Cuando se establece como falsa (la opción predeterminada), un receptor solo exportará registros del recurso de host.

    • Debes tener la función de IAM Escritor de configuración de registros para el superior a fin de crear el receptor. A fin de obtener más información sobre las funciones de IAM de Stackdriver Logging, consulta la Guía de control de acceso.

    • Para obtener algunos ejemplos útiles de filtros, consulta Usa filtros con exportaciones agregadas en esta página.

  2. Recupera el nombre de la cuenta de servicio usado para crear el receptor del resultado del comando.

  3. Otórgale a la cuenta de servicio permiso para escribir a tu destino de exportación.

    Si no tienes permiso para hacer ese cambio al destino de exportación, envía el nombre de la cuenta de servicio a alguien que pueda hacer ese cambio por ti.

    A fin de obtener más información sobre cómo otorgar permisos a cuentas de servicio para recursos, consulta Otorga funciones a cuentas de servicio.

Usa filtros con exportaciones agregadas

Como cualquier receptor, tu receptor de exportación agregada posee un filtro que selecciona entradas de registro individuales. A continuación, se muestran ejemplos de comparaciones de filtros que son útiles cuando se usa la función de exportación agregada. Para obtener más detalles sobre los filtros, consulta Filtros avanzados de registros. Algunos ejemplos usan la siguiente notación:

  • : es el operador de la substring. No sustituyas el operador =.
  • ... representa cualquier comparación de filtro adicional.

Elige registros de auditoría

Para exportar registros de auditoría, elige una de las siguientes comparaciones de ejemplo. La primera alternativa elige los registros de auditoría de Actividad del administrador y de Acceso de datos:

logName:"/logs/cloudaudit.googleapis.com" AND ...
logName:"/logs/cloudaudit.googleapis.com%2Factivity" AND ...
logName:"/logs/cloudaudit.googleapis.com%2Fdata_access" AND ...

Si quieres obtener más información sobre los registros de auditoría, consulta Cloud Audit Logging.

Elige proyectos

Para exportar registros de organizaciones, proyectos o carpetas específicas, usa una de las siguientes comparaciones de ejemplo:

logName:"projects/[PROJECT_ID]/logs/" AND ...
logName:("projects/[PROJ_A]/logs/" OR "projects/[PROJ_B]/logs/") AND ...
logName:"folders/[FOLDER_ID]/logs/" AND ...
logName:"organizations/[ORGANIZATION_ID]/logs/" AND ...

Elige recursos

Para exportar registros de organizaciones, proyectos o carpetas específicas, usa múltiples comparaciones con el fin de especificar el recurso de manera exacta:

logName:"projects/[PROJECT_ID]/logs" AND
  resource.type=[RESOURCE_TYPE] AND
  resource.labels.instance_id=[INSTANCE_ID]

Para obtener una lista de todos los tipos de recursos, consulta la Lista de recursos supervisados.

Muestreo de entradas de registro

Para exportar una muestra aleatoria de entradas de registro, agrega la función incorporada sample. Por ejemplo, a fin de exportar solo el 10% de las entradas de registro que coinciden con tu filtro actual, usa esta adición:

sample(insertId, 0.10) AND ...

Si quieres obtener más información, consulta Función de ejemplo.

Si quieres obtener más información sobre los filtros de Stackdriver Logging, consulta Filtros avanzados de registros.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Logging
Si necesitas ayuda, visita nuestra página de asistencia.