Enruta registros a destinos compatibles.

Puedes usar receptores de registros en Cloud Logging para enrutar entradas de registro desde tu Google Cloud proyecto a destinos compatibles para el almacenamiento a largo plazo, el análisis o la transmisión.

Un receptor realiza una acción de escritura y, por lo tanto, debe estar autorizado para escribir en el destino. Cuando el destino es un bucket de registros en el mismo proyecto que el receptor, este se autoriza automáticamente. Para todos los demás destinos, el receptor debe estar adjunto a una cuenta de servicio a la que se le hayan otorgado los permisos necesarios para escribir datos en el destino.

Cuando se requiere una cuenta de servicio, Cloud Logging la crea y administra automáticamente. Sin embargo, es posible que debas modificar los permisos otorgados a la cuenta de servicio. No es necesario que uses la cuenta de servicio que creó Logging. Puedes crear y administrar una cuenta de servicio que utilicen receptores en varios proyectos. Para obtener más información, consulta Configura receptores de registros con cuentas de servicio administradas por el usuario.

Descripción general

En este documento, se describe cómo crear un receptor y cómo configurar las opciones que puedes ver cuando usas la consola de Google Cloud , Google Cloud CLI o la API.

Los receptores pertenecen a un recurso Google Cloud determinado: un Google Cloud proyecto, una cuenta de facturación, una carpeta o una organización. Cuando el recurso recibe una entrada de registro, cada receptor del recurso procesa la entrada de registro. Cuando una entrada de registro coincide con los filtros del receptor, se enruta al destino del receptor.

Por lo general, los receptores solo enrutan las entradas de registro que se originan en un recurso. Sin embargo, para las carpetas y las organizaciones, puedes crear receptores agregados. Estos receptores enrutan las entradas de registro que se originan en la carpeta o la organización, y en sus recursos secundarios. En este documento, no se abordan los receptores agregados. Para obtener más información, consulta Descripción general de los receptores agregados.

Para crear y administrar receptores, puedes usar la Google Cloud consola, la API de Cloud Logging y la Google Cloud CLI. Te recomendamos que uses la consola de Google Cloud por los siguientes motivos:

  • Puedes configurar destinos de receptor como parte del flujo para crear un receptor.
  • Puedes obtener una vista previa de las entradas de registro que coinciden con los filtros del receptor.
  • Se simplificaron algunos pasos de autorización.

Te recomendamos que revises la configuración del receptor de registros cuando realices cambios en el almacenamiento de registros. Por ejemplo, si borras el destino de un receptor de registros, borra el receptor de registros correspondiente.

Para obtener información sobre cómo ver y administrar tus receptores de registros, consulta la sección Administra receptores de este documento.

Destinos admitidos

El destino de un receptor puede estar en un recurso diferente del receptor. Por ejemplo, puedes usar un receptor de registros para enrutar entradas de registro de un proyecto a un bucket de registros almacenado en otro proyecto.

Se admiten los siguientes destinos:

Google Cloud proyecto

Selecciona este destino cuando quieras que los receptores de registros del proyecto de destino redireccionen tus entradas de registro o cuando hayas creado un receptor agregado de interceptación. Los receptores de registros del proyecto de destino pueden redireccionar las entradas de registro a cualquier destino admitido, excepto a un proyecto.

Los receptores de registros creados por el sistema en el proyecto de destino excluyen las entradas de registro que se enrutan al bucket de registros _Required en el proyecto de origen. Por ejemplo, si enrutas los registros de actividad del administrador a otro proyecto, los receptores de registros _Required y _Default del proyecto de destino excluirán esas entradas de registro. Para almacenar esas entradas de registro, actualiza el receptor de registros _Default o crea un receptor de registros personalizado en el proyecto de destino.

Bucket de registros
Selecciona este destino cuando desees almacenar tus datos de registro en recursos administrados por Cloud Logging. Los datos de registro almacenados en buckets de registros se pueden ver y analizar con servicios como el Explorador de registros.
Tema de Pub/Sub
Selecciona este destino cuando desees exportar tus datos de registro desdeGoogle Cloud y, luego, usar una integración de terceros. Las entradas de registro se formatean como JSON y, luego, se enrutan a un tema de Pub/Sub.

Limitaciones de destino

En esta sección, se describen las limitaciones específicas de cada destino:

  • Cuando configures un destino de receptor, proporciona la ruta de acceso completamente calificada y usa el extremo global del servicio. No se admiten los extremos de servicio regionales (REP), como pubsub.LOCATION.rep.googleapis.com.

  • No se admite el enrutamiento de registros a un tema de Pub/Sub que aplique restricciones de tránsito. El registro no puede garantizar que las solicitudes de publicación se originen en una región permitida, lo que provoca errores de configuración de topic_region_not_allowed y registros descartados.

  • Se aplican las siguientes limitaciones cuando el destino de un receptor de registros es un proyecto de Google Cloud :

    • Hay un límite de un salto.
    • El receptor de registros _Required en el proyecto de destino enruta las entradas de registro al bucket de registros _Required del proyecto cuando las entradas de registro coinciden con el filtro del receptor y se originan en el proyecto de destino.
    • El receptor de registros _Default en el proyecto de destino enruta las entradas de registro que coinciden con su filtro de inclusión y no coinciden con ningún filtro de exclusión. El receptor de registros _Default excluye algunas entradas de registro. Por ejemplo, este receptor no enruta las entradas de registro de actividad del administrador ni de eventos del sistema. Puedes modificar este receptor.
    • Solo los receptores agregados que se encuentran en la jerarquía de recursos de una entrada de registro procesan la entrada.

    Por ejemplo, supongamos que el destino de un receptor de registros en el proyecto A es el proyecto B. En este caso, se aplican las siguientes reglas:

    • Debido al límite de un salto, los receptores de registros del proyecto B no pueden redireccionar las entradas de registro a otro proyecto Google Cloud .
    • El bucket de registros _Required del proyecto B solo almacena entradas de registro que se originan en el proyecto B. Este bucket de registros no almacena ninguna entrada de registro que se origine en ningún otro recurso, incluidas las que se originan en el proyecto A.
    • Si el proyecto A y el proyecto B tienen jerarquías de recursos diferentes, una entrada de registro que un receptor de registros en el proyecto A enruta al proyecto B no se envía a los receptores agregados en la jerarquía de recursos del proyecto B.
    • Si el proyecto A y el proyecto B tienen la misma jerarquía de recursos, las entradas de registro se envían a los receptores agregados de esa jerarquía. Si un receptor agregado no intercepta una entrada de registro, el enrutador de registros envía la entrada a los receptores del proyecto A.

Antes de comenzar

En este documento, se describen las instrucciones para crear y administrar receptores a nivel delGoogle Cloud proyecto. Puedes usar el mismo procedimiento para crear un receptor que enrute las entradas de registro que se originan en una organización, una carpeta o una cuenta de facturación.

Para comenzar, haz lo siguiente:

  1. Habilita la API de Cloud Logging si aún no está habilitada.

    Roles necesarios para habilitar las APIs

    Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

    Habilitar la API

  2. Asegúrate de que tu proyecto de Google Cloud contenga entradas de registro que puedas ver en el Explorador de registros.

  3. Para obtener los permisos que necesitas para crear, modificar o borrar un receptor, pídele a tu administrador que te otorgue el rol de IAM Escritor de configuración de registros (roles/logging.configWriter) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

    Para obtener información sobre cómo otorgar roles de IAM, consulta la Guía de control de acceso de Logging.

  4. Asegúrate de tener un recurso en un destino admitido o de poder crear uno.

    Para enrutar entradas de registro a un destino, este debe existir antes de que crees el receptor. Puedes crear el destino en cualquier proyecto deGoogle Cloud en cualquier organización.

  5. Antes de crear un receptor, revisa las limitaciones que se aplican al destino del receptor. Para obtener más información, consulta la sección Limitaciones de destino en este documento.

  6. Selecciona la interfaz que planeas usar:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

    Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando: 

    gcloud init

    REST

    Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

      Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Crea un receptor

En esta sección, se describe cómo crear un receptor en un proyecto de Google Cloud . Puedes crear hasta 200 receptores por proyecto Google Cloud . Para ver la cantidad y el volumen de las entradas de registro que se enrutan, consulta las métricas de logging.googleapis.com/exports/.

Usas el lenguaje de consulta de Logging para crear una expresión de filtro que coincida con las entradas de registro que deseas incluir. No incluyas información sensible en los filtros de receptor. Los filtros de receptor se tratan como datos de servicio.

Cuando una consulta contiene varias instrucciones, puedes especificar cómo se unen esas instrucciones o confiar en que Cloud Logging agregue de forma implícita la restricción conjuntiva, AND, entre las instrucciones. Por ejemplo, supongamos que un diálogo de consulta o filtro contiene dos instrucciones, resource.type = "gce_instance" y severity >= "ERROR". La búsqueda real es resource.type = "gce_instance" AND severity >= "ERROR". Cloud Logging admite restricciones disyuntivas, OR, y restricciones conjuntivas, AND. Cuando uses instrucciones OR, te recomendamos que agrupes las cláusulas con paréntesis.

Para crear un receptor, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Enrutador de registros:

    Ir a Enrutador de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Selecciona el proyecto Google Cloud en el que se originan las entradas de registro que deseas enrutar.

    Por ejemplo, si deseas enrutar las entradas de registro de acceso a los datos del proyecto llamado Project-A a un bucket de registros en el proyecto llamado Project-B, selecciona Project-A.

  3. Selecciona Crear receptor.

  4. En el panel Detalles del receptor, ingresa los siguientes detalles:

    • Nombre del receptor: Ingresa un identificador para el receptor. Después de crear el receptor, no puedes cambiarle el nombre, pero puedes borrarlo y crear uno nuevo.

    • Descripción del receptor (opcional): Describe el propósito o el caso de uso del receptor.

  5. En el panel Destino del receptor, selecciona el servicio de receptor y el destino con el menú Selecciona el servicio de receptor. Realiza una de las siguientes acciones:

    • Para enrutar las entradas de registro a un servicio que se encuentre en el mismo proyecto deGoogle Cloud , selecciona una de las siguientes opciones:

      • Tema de Pub/Sub: Selecciona o crea el tema para recibir las entradas de registro redireccionadas.

    • Para enrutar las entradas de registro a un proyecto Google Cloud diferente, selecciona proyectoGoogle Cloud y, luego, ingresa el nombre completo del destino:

      logging.googleapis.com/projects/DESTINATION_PROJECT_ID

    • Para enrutar entradas de registro a un servicio que se encuentra en unGoogle Cloud proyecto diferente, haz lo siguiente:

      1. Selecciona Otro recurso.
      2. Ingresa el nombre completamente calificado del destino. Para obtener información sobre la sintaxis, consulta Formatos de rutas de destino.

  6. Especifica las entradas de registro que se incluirán:

    1. Ve al panel Elige registros para incluirlos en el receptor.

    2. En el campo Crear filtro de inclusión, ingresa una expresión de filtro que coincida con las entradas de registro que deseas incluir. Para obtener información sobre la sintaxis, consulta Lenguaje de consulta de Logging.

      Si no configuras un filtro, todas las entradas de registro del recurso seleccionado se enrutan al destino.

      Por ejemplo, para enrutar todas las entradas del registro de acceso a los datos a un bucket de Logging, puedes usar el siguiente filtro:

      log_id("cloudaudit.googleapis.com/data_access") OR log_id("externalaudit.googleapis.com/data_access")

      La longitud de un filtro no puede superar los 20,000 caracteres.

    3. Para verificar que ingresaste el filtro correcto, selecciona Obtener vista previa de los registros. El Explorador de registros se abre en una pestaña nueva con el filtro completado previamente.

  7. (Opcional) Configura un filtro de exclusión para eliminar algunas de las entradas de registro incluidas:

    1. Ve al panel Elige registros para filtrar fuera del receptor.

    2. En el campo Nombre de filtro de exclusión, ingresa un nombre.

    3. En el campo Crea un filtro de exclusión, ingresa una expresión de filtro que coincida con las entradas de registro que deseas excluir. También puedes usar la función sample para seleccionar una parte de las entradas de registro que se excluirán.

    Puedes crear hasta 50 filtros de exclusión por receptor. Ten en cuenta que la longitud de un filtro no puede superar los 20,000 caracteres.

  8. Selecciona Crear receptor.

  9. Otorga permiso a la cuenta de servicio del receptor para escribir entradas de registro en el destino del receptor. Para obtener más información, consulta Cómo establecer permisos de destino.

gcloud

Para crear un receptor, haz lo siguiente:

  1. Ejecuta el siguiente comando gcloud logging sinks create:

    gcloud logging sinks create SINK_NAME SINK_DESTINATION

    Antes de ejecutar el comando, realiza los siguientes reemplazos:

    • SINK_NAME: Es el nombre del receptor de registros. No puedes cambiar el nombre de un receptor después de crearlo.

    • SINK_DESTINATION: Es el servicio o proyecto al que deseas enrutar tus entradas de registro. Establece SINK_DESTINATION en la ruta de acceso adecuada, como se describe en Formatos de rutas de acceso de destino.

      Por ejemplo, si el destino del receptor es un tema de Pub/Sub, SINK_DESTINATION se verá de la siguiente manera:

      pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID

    También puedes proporcionar las siguientes opciones:

    • --log-filter : Usa esta opción para establecer un filtro que coincida con las entradas de registro que deseas incluir en tu receptor. Si no proporcionas un valor para el filtro de inclusión, este filtro coincidirá con todas las entradas de registro.
    • --exclusion: Usa esta opción para establecer un filtro de exclusión para las entradas de registro que no quieres que tu receptor enrute. También puedes usar la función sample para seleccionar una parte de las entradas de registro que se excluirán. Esta opción se puede repetir. Puedes crear hasta 50 filtros de exclusión por receptor.
    • --description: Usa esta opción para describir el propósito o el caso de uso del receptor.

    Por ejemplo, para crear un receptor en un bucket de Logging, tu comando podría verse así:

    gcloud logging sinks create my-sink logging.googleapis.com/projects/myproject123/locations/global/buckets/my-bucket \
 --log-filter='logName="projects/myproject123/logs/matched"' --description="My first sink"

    Para obtener más información sobre cómo crear receptores con Google Cloud CLI, consulta la referencia de gcloud logging sinks.

  2. Si la respuesta del comando contiene una clave JSON etiquetada como "writerIdentity", otorga permiso a la cuenta de servicio del receptor para escribir en el destino del receptor. Para obtener más información, consulta Cómo establecer permisos de destino.

    No es necesario que establezcas permisos de destino cuando la respuesta no contiene una clave JSON etiquetada como "writerIdentity".

REST

  1. Para crear un receptor de registros en tu proyecto de Google Cloud , usa projects.sinks.create en la API de Logging. En el objeto LogSink, proporciona los valores obligatorios correspondientes en el cuerpo de la solicitud del método:

    • name: Es un identificador del receptor. Después de crear el receptor, no puedes cambiarle el nombre, pero puedes borrarlo y crear uno nuevo.

    • destination: Es el servicio y el destino a los que deseas enrutar tus entradas de registro. Para enrutar las entradas de registro a un proyecto diferente o a un destino que se encuentre en otro proyecto, configura el campo destination en la ruta de acceso adecuada, como se describe en Formatos de rutas de acceso de destino.

      Por ejemplo, si el destino del receptor es un tema de Pub/Sub, el destination se verá de la siguiente manera:

      pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID

  2. En el objeto LogSink, proporciona la información opcional adecuada:

    • filter : Establece el campo filter para que coincida con las entradas de registro que deseas incluir en tu receptor. Si no estableces un filtro, todas las entradas de registro de tu proyectoGoogle Cloud se enrutan al destino. Ten en cuenta que la longitud de un filtro no puede superar los 20,000 caracteres.
    • exclusions: Configura este campo para que coincida con las entradas de registro que deseas excluir de tu receptor. También puedes usar la función sample para seleccionar una parte de las entradas de registro que se excluirán. Puedes crear hasta 50 filtros de exclusión por receptor.
    • description: Establece este campo para describir el propósito o el caso de uso del receptor.

  3. Llama a projects.sinks.create para crear el receptor.

  4. Si la respuesta de la API contiene una clave JSON etiquetada como "writerIdentity", otorga permiso a la cuenta de servicio del receptor para escribir en el destino del receptor. Para obtener más información, consulta Cómo establecer permisos de destino.

    No es necesario que establezcas permisos de destino cuando la respuesta de la API no contiene una clave JSON etiquetada como "writerIdentity".

Para obtener más información sobre cómo crear receptores con la API de Logging, consulta la referencia de LogSink.

Si recibes notificaciones de error, consulta Soluciona problemas de enrutamiento y receptores.

Formatos de rutas de destino

Cuando configures un destino de receptor, proporciona la ruta de acceso completamente calificada y usa el extremo global del servicio. No se admiten los extremos de servicio regionales (REP), como pubsub.LOCATION.rep.googleapis.com.

En los siguientes formatos de ruta de acceso, DESTINATION_PROJECT_ID hace referencia al ID o al número del proyecto de destino:

  • Bucket de registros de Cloud Logging:

    logging.googleapis.com/projects/DESTINATION_PROJECT_ID/locations/LOCATION/buckets/BUCKET_NAME

  • Otro Google Cloud proyecto:

    logging.googleapis.com/projects/DESTINATION_PROJECT_ID

  • Tema de Pub/Sub:

    pubsub.googleapis.com/projects/DESTINATION_PROJECT_ID/topics/TOPIC_ID

Cómo establecer permisos de destino

En esta sección, se describe cómo otorgar a Logging los permisos de Identity and Access Management para escribir entradas de registro en el destino de tu receptor. Para obtener la lista completa de roles y permisos de Logging, consulta Control de acceso.

Cloud Logging crea una cuenta de servicio compartida para un recurso cuando se crea un receptor, a menos que ya exista la cuenta de servicio requerida. Es posible que la cuenta de servicio exista porque se usa la misma cuenta de servicio para todos los receptores del recurso subyacente. Un recurso puede ser un Google Cloud proyecto, una organización, una carpeta o una cuenta de facturación.

La identidad del escritor de un receptor es el identificador de la cuenta de servicio asociada a ese receptor. Todos los receptores tienen una identidad de escritor, excepto los que escriben en un bucket de registros en el mismo proyecto Google Cloud en el que se originan las entradas de registro. Para la última configuración, no se requiere una cuenta de servicio y, por lo tanto, el campo identidad del escritor del receptor aparece como None en la consola. La API y los comandos de Google Cloud CLI no informan una identidad de escritura.

Las siguientes instrucciones se aplican a proyectos, carpetas, organizaciones y cuentas de facturación:

Console

  1. Asegúrate de tener acceso de propietario al proyectoGoogle Cloud que contiene el destino. Si no tienes acceso de propietario al destino del receptor, pídele a un propietario del proyecto que agregue la identidad del escritor como principal.

  2. Para obtener la identidad de escritor del receptor (una dirección de correo electrónico) del receptor nuevo, haz lo siguiente:

    1. En la consola de Google Cloud , ve a la página Enrutador de registros:

      Ir a Enrutador de registros

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

    2. En la barra de herramientas, selecciona el proyecto que contiene el receptor.
    3. Selecciona Menú y, luego, Ver detalles del receptor. La identidad de escritor aparece en el panel Detalles del receptor.

  3. Si el valor del campo writerIdentity contiene una dirección de correo electrónico, continúa con el siguiente paso. Cuando el valor es None, no es necesario que configures los permisos de destino para el receptor.

  4. Copia la identidad de escritor del receptor en el portapapeles.

    La dirección de correo electrónico identifica al principal. El prefijo, serviceAccount:, especifica el tipo de cuenta.

  5. Otorga al principal especificado en la identidad de escritor del receptor permiso para escribir datos de registro en el destino:

    1. En la consola de Google Cloud , ve a la página IAM:

      Ir a IAM

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es IAM y administrador.

    2. En la barra de herramientas, asegúrate de que el proyecto seleccionado sea el que almacena el destino o el destino del receptor. Por ejemplo, si el destino es un bucket de registros, asegúrate de que la barra de herramientas muestre el proyecto que almacena el bucket de registros.

    3. Selecciona Otorgar acceso.

    4. Otorga a la principal especificada en la identidad de escritor del receptor un rol de IAM según el destino del receptor de registros:

gcloud

  1. Asegúrate de tener acceso de propietario al proyectoGoogle Cloud que contiene el destino. Si no tienes acceso de propietario al destino del receptor, pídele a un propietario del proyecto que agregue la identidad del escritor como principal.

  2. Obtén la cuenta de servicio del campo writerIdentity en tu receptor:

    gcloud logging sinks describe SINK_NAME

  3. Ubica el receptor cuyos permisos deseas modificar y, si los detalles del receptor contienen una línea con writerIdentity, continúa con el siguiente paso. Cuando los detalles no incluyen un campo writerIdentity, no es necesario que configures los permisos de destino para el receptor.

    La identidad de escritura de la cuenta de servicio se ve similar a la siguiente:

    serviceAccount:service-123456789012@gcp-sa-logging.

  4. Llama al comando gcloud projects add-iam-policy-binding para otorgar permiso a la identidad de escritura del receptor para escribir datos de registro en el destino.

    Antes de usar el siguiente comando, realiza los siguientes reemplazos:

    • PROJECT_ID: Es el identificador del proyecto. Especifica el proyecto que almacena el destino del receptor de registros. Cuando el destino sea un proyecto, especifícalo.
    • PRINCIPAL: Es un identificador de la principal a la que deseas otorgar el rol. Los identificadores principales suelen tener el siguiente formato: PRINCIPAL-TYPE:ID. Por ejemplo, . Para obtener una lista completa de los formatos que puede tener PRINCIPAL, consulta Identificadores de principal.

    • ROLE: Es un rol de IAM. Otorga a la identidad de escritor del receptor un rol de IAM según el destino del receptor de registros:

    Ejecuta el comando gcloud projects add-iam-policy-binding:

    gcloud projects add-iam-policy-binding PROJECT_ID --member=PRINCIPAL --role=ROLE

REST

Te recomendamos que uses la consola de Google Cloud o Google Cloud CLI para otorgar un rol a la cuenta de servicio.

Ejemplos de filtros

A continuación, se incluyen algunos ejemplos de filtros que son particularmente útiles cuando se crean receptores. Para obtener ejemplos adicionales que podrían ser útiles a medida que compilas tus filtros de inclusión y exclusión, consulta Consultas de muestra.

Restablece el filtro de receptor _Default

Si editaste el filtro del receptor _Default, es posible que desees restablecer este receptor a su configuración original. Cuando se crea, el receptor _Default se configura con el siguiente filtro de inclusión y un filtro de exclusión vacío:

  NOT log_id("cloudaudit.googleapis.com/activity") AND NOT \
  log_id("externalaudit.googleapis.com/activity") AND NOT \
  log_id("cloudaudit.googleapis.com/system_event") AND NOT \
  log_id("externalaudit.googleapis.com/system_event") AND NOT \
  log_id("cloudaudit.googleapis.com/access_transparency") AND NOT \
  log_id("externalaudit.googleapis.com/access_transparency")

Excluye los registros de contenedores y Pods de Google Kubernetes Engine

Para excluir las entradas de registro de contenedores y Pods de Google Kubernetes Engine para el sistema namespaces de GKE, usa el siguiente filtro:

resource.type = ("k8s_container" OR "k8s_pod")
resource.labels.namespace_name = (
"cnrm-system" OR
"config-management-system" OR
"gatekeeper-system" OR
"gke-connect" OR
"gke-system" OR
"istio-system" OR
"knative-serving" OR
"monitoring-system" OR
"kube-system")

Para excluir las entradas de registro de nodos de Google Kubernetes Engine para los valores del sistema log_id de GKE, usa el siguiente filtro:

resource.type = "k8s_node"
(log_id("container-runtime") OR
 log_id("docker") OR
 log_id("kube-container-runtime-monitor") OR
 log_id("kube-logrotate") OR
 log_id("kube-node-configuration") OR
 log_id("kube-node-installation") OR
 log_id("kubelet") OR
 log_id("kubelet-monitor") OR
 log_id("node-journal") OR
 log_id("node-problem-detector"))

Compatibilidad

Si bien Cloud Logging te permite excluir entradas de registro y evitar que se almacenen en un bucket de registros, te recomendamos que conserves las entradas de registro que ayudan con la capacidad de asistencia. El uso de estas entradas de registro puede ayudarte a solucionar problemas y a identificar problemas con tus aplicaciones.

Por ejemplo, las entradas de registro del sistema de GKE son útiles para solucionar problemas de tus aplicaciones y clústeres de GKE, ya que se generan para los eventos que ocurren en tu clúster. Estas entradas de registro pueden ayudarte a determinar si el código de la aplicación o el clúster de GKE subyacente están causando un error en la aplicación. Los registros del sistema de GKE también incluyen el registro de auditoría de Kubernetes generado por el componente del servidor de la API de Kubernetes, que incluye los cambios realizados con el comando kubectl y los eventos de Kubernetes.

¿Qué sigue?