Controla la transferencia de registros

Los filtros de exclusión te permiten controlar el volumen de registros de Google Kubernetes Engine (GKE) que transfiere Cloud Logging y, a la vez, hacer que el registro detallado esté disponible para la depuración. Puedes usar filtros de exclusión para evitar que Cloud Logging transfiera las entradas de registro coincidentes o que se enruten al destino de un receptor.

Crea filtros de exclusión mediante el lenguaje de consulta de Logging.

Las entradas de registro se excluyen después de que las recibe la API de Logging y, por lo tanto, estas entradas de registro consumen la cuota de la API de entries.write. No puedes reducir la cantidad de llamadas a la API de entries.write excluyendo entradas de registro.

Las entradas de registro excluidas no están disponibles en el explorador de registros ni en Error Reporting.

Para obtener información sobre cómo ver los datos de transferencia, consulta Visualiza el uso detallado en el Explorador de métricas.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
    • Habilitar la API de Google Kubernetes Engine
  • Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa gcloud CLI. Si ya instalaste gcloud CLI, ejecuta gcloud components update para obtener la versión más reciente.

Permisos

Verifica que tengas uno de los siguientes roles de IAM para el proyecto de Google Cloud de origen desde el que enrutas registros.

  • Propietario (roles/owner)
  • Administrador de Logging (roles/logging.admin)
  • Escritor de configuración de registros (roles/logging.configWriter)

Los permisos contenidos en estos roles te permiten crear, borrar o modificar receptores. Para obtener información sobre los roles de IAM, consulta la Guía de control de acceso de Logging.

Agrega un filtro de exclusión

En los siguientes pasos, se describe cómo agregar un filtro de exclusión de Cloud Logging que excluya los registros de la transferencia al bucket Default de Cloud Logging.

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

    Ir a Enrutador de registros

  2. Busca la fila con el receptor _Default, expande la opción Acciones y, luego, haz clic en Editar receptor.

  3. En Elige registros para filtrar fuera del receptor, en Crear un filtro de exclusión, haz clic en Agregar exclusión.

  4. Ingresa un nombre para tu filtro de exclusión.

  5. En la sección Crea un filtro de exclusión, ingresa los criterios del filtro. Por ejemplo, puedes excluir entradas de registro de un clúster o entradas de registro específicas de un contenedor.

    Excluye todas las entradas de registro de un clúster específico:

    resource.labels.cluster_name="CLUSTER_NAME"

    Excluye las entradas de registro con la gravedad de registro DEFAULT, DEBUG, INFO o NOTICE para un contenedor específico en un clúster específico:

    resource.type="k8s_container"
resource.labels.container_name="CONTAINER_NAME"
resource.labels.cluster_name="CLUSTER_NAME"
severity=(DEFAULT OR DEBUG OR INFO OR NOTICE)

  6. Haz clic en Actualizar receptor.

El receptor _Default ahora está configurado para excluir los registros con el filtro que agregaste.

¿Qué sigue?