Acerca de los registros de flujo de VPC

En esta página, se describe el formato de los registros de flujo de VPC, incluido qué campos de bases y de metadatos están disponibles. También se explica cómo puedes usar el filtrado de registros para que solo se generen los registros que coincidan con ciertos criterios.

Formato del registro

Los registros contienen campos base, que son los campos principales de cada registro, y campos de metadatos que agregan información adicional. Los campos de metadatos se pueden omitir para ahorrar costos de almacenamiento.

Algunos campos de registro se encuentran en formato de varios campos y poseen más de un dato en un campo específico. Por ejemplo, el campo connection tiene el formato IpConnection, que contiene el puerto y la dirección IP de origen y destino, además del protocolo, en un solo campo. Estos campos de varios campos se describen a continuación en la tabla de formato de registros.

Los valores de los campos de metadatos no se basan en la ruta del plano de datos; son aproximaciones y es posible que algunos falten o sean incorrectos. A diferencia de los campos de metadatos, los valores de los campos de base se toman directamente de los encabezados de paquetes.

Formato del campo IpConnection

Formato del campo GatewayDetails

Formato del campo GkeDetails

Formato del campo ClusterDetails

Formato del campo PodDetails

Formato del campo WorkloadDetails

Formato del campo ServiceDetails

Ejemplo:

Si hay dos servicios, el campo Service tiene el siguiente aspecto:

service: [
 0: {
  service_name: "my-lb-service"
  service_namespace: "default"
 }
 1: {
  service_name: "my-lb-service2"
  service_namespace: "default"
 }
]

Si hay más de dos servicios, el campo Service tiene el siguiente aspecto:

service: [
 0: {
  service_name: "MANY_SERVICES"
 }
]

Formato del campo GoogleServiceDetails

Formato del campo InstanceDetails

Formato del campo InstanceGroupDetails

Formato del campo GeographicDetails

Formato del campo VpcDetails

Formato del campo InternetRoutingDetails

Formato de campo AsPath

Formato del campo AsDetails

Formato del campo LoadBalancingDetails

Formato del campo NetworkServiceDetails

Formato del campo PrivateServiceConnectDetails

Formato del campo PrivateServiceConnectEndpointDetails

Formato del campo PrivateServiceConnectAttachmentDetails

Anotaciones de metadatos

Los registros contienen campos base y campos de metadatos. En la sección Formato del registro, se enumeran los campos que son de tipo metadatos y los que son de tipo base. Todos los campos base siempre se incluyen. Puedes personalizar qué campos de metadatos conservas.

• Si seleccionas todos los metadatos, todos los campos de metadatos en el formato de registro Registros de flujo de VPC se incluyen en los registros de flujo. Cuando se agregan campos de metadatos nuevos al formato del registro, los registros de flujo incluyen automáticamente los campos nuevos.

• Si no seleccionas metadatos, se omitirán todos los campos de metadatos.

• Si seleccionas metadatos personalizados, puedes especificar los campos de metadatos que deseas incluir en el campo superior, como src_vpc, o en sus nombres completos, como src_vpc.project_id.

  Cuando se agregan campos de metadatos nuevos al formato del registro, se excluyen de los registros de flujo, a menos que se encuentren dentro de un campo superior que hayas especificado para que se incluya.

  • Si especificas metadatos personalizados con campos superiores, cuando los campos de metadatos nuevos se agreguen al formato del registro de ese campo superior, los registros de flujo incluirán automáticamente los campos nuevos.

  • Si especificas metadatos personalizados con el nombre completo del campo, los campos de metadatos nuevos que se agreguen al campo superior se excluirán de los registros de flujo.

Si quieres obtener información para personalizar los campos de metadatos, consulta Habilita los registros de flujo de VPC o Actualiza la configuración de los registros de flujo de VPC.

Anotaciones de metadatos de GKE

Los flujos que tienen un extremo en un clúster de GKE pueden anotarse con anotaciones de metadatos de GKE, que pueden incluir detalles del clúster, el Pod y el Service del extremo.

Anotaciones del Service de GKE

El tráfico enviado a un ClusterIP, NodePort o LoadBalancer puede recibir anotaciones del servicio. Si se envía a un NodePort o un LoadBalancer, el flujo recibe la anotación del Service en ambos saltos de la conexión.

El tráfico enviado directamente al puerto de Service de un Pod se anota con una anotación del Service en el extremo de destino.

El tráfico enviado al puerto de Service de un Pod en el que el Pod está creando una copia de seguridad de más de un Service en el mismo puerto se anota con varios Service en el extremo de destino. Se limita a dos Service. Si hay más que eso, el extremo se anotará con un marcador MANY_SERVICES especial.

Anotaciones de Pod en el tráfico de Internet

De forma predeterminada, el tráfico entre Internet y un Pod no recibe anotaciones de Pod. Los registros de flujo de VPC no pueden agregar anotaciones de Pod porque, para el envío de paquetes a Internet, el agente de enmascaramiento traduce la dirección IP del Pod a la dirección IP del nodo antes de que los registros de flujo de VPC vean el paquete.

Debido al enmascaramiento, las anotaciones de Pod solo son visibles si los destinos se encuentran dentro de los destinos predeterminados sin enmascarar o en una lista nonMasqueradeCIDRs personalizada. Si incluyes destinos de Internet en una lista nonMasqueradeCIDRs personalizada, debes proporcionar una forma de que las direcciones IP internas del Pod se traduzcan antes de que se entreguen a Internet. Para los clústeres privados y no privados, puedes usar Cloud NAT. Consulta Interacción de GKE para obtener más detalles.

Anotaciones entre proyectos

Si los registros de flujo de VPC están habilitados a nivel de la organización, los flujos a través de la VPC compartida, el intercambio de tráfico entre redes de VPC y Network Connectivity Center se anotan con anotaciones entre proyectos. Las anotaciones entre proyectos están habilitadas de forma predeterminada. También puedes inhabilitar estas anotaciones.

• Si las anotaciones entre proyectos están habilitadas, los registros de los flujos entre recursos de diferentes proyectos incluyen información sobre ambos lados del flujo.
• Si las anotaciones entre proyectos están inhabilitadas, los registros de registro solo incluyen información sobre el informante del flujo.

Si los registros del flujo de VPC están habilitados a nivel del proyecto, los flujos entre recursos de diferentes proyectos no se anotan con anotaciones entre proyectos.

Filtrado de registros

Cuando habilitas los registros de flujo de VPC, puedes configurar un filtro basado en los campos base y de metadatos que solo conservan los registros que coinciden con el filtro. Todos los demás registros se descartan antes de escribirse en Logging.

Puedes filtrar cualquier subconjunto de campos que aparezca en Formato del registro, excepto para los siguientes campos:

• rtt_msec
• bytes_sent
• packets_sent
• start_time
• end_time

Los filtros de registros de flujo de VPC usan CEL, un lenguaje de expresión incorporado para las expresiones lógicas basadas en atributos. Las expresiones de filtro para los registros de flujo de VPC tienen un límite de 2,048 caracteres. Para obtener más información, consulta Operadores lógicos CEL admitidos.

Para obtener más información acerca del CEL, consulta la introducción a CEL y la definición de lenguaje. La función de filtro de generación admite un subconjunto limitado de sintaxis CEL.

Para crear una configuración de registros de flujo de VPC que use el filtrado de registros, consulta Habilita los registros de flujo de VPC. Para configurar el filtrado de registros en una configuración existente de registros de flujo de VPC, consulta Actualiza la configuración de los registros de flujo de VPC.

Operadores lógicos CEL admitidos

Ejemplos de filtros de registros

Si habilitaste los registros de flujo de VPC para una subred con la API de Compute Engine, usa el comando gcloud compute networks subnets update para configurar el filtrado (ejemplos del 1 al 3).

Para otra configuración de los registros de flujo de VPC, usa el comando gcloud network-management vpc-flow-logs-configs update (ejemplos del 4 al 6). Las expresiones de filtro de los ejemplos del 1 al 3 se pueden usar con el comando gcloud network-management vpc-flow-logs-configs update.

Ejemplo 1. Limita la recopilación de registros a una VM específica llamada my-vm. En este caso, solo se graban los registros en los que el campo src_instance informado por la fuente del tráfico es my-vm o el campo dst_instance, como lo indica el destino del tráfico es my-vm.

gcloud compute networks subnets update my-subnet \
    --logging-filter-expr="(src_instance.vm_name == 'my-vm' && reporter=='SRC') || (dest_instance.vm_name == 'my-vm' && reporter=='DEST')"

Ejemplo 2. Limita la recopilación de registros a los paquetes cuyas direcciones IP de origen estén en la subred 10.0.0.0/8.

gcloud compute networks subnets update my-subnet \
    --logging-filter-expr="inIpRange(connection.src_ip, '10.0.0.0/8')"

Ejemplo 3. Limita la recopilación de registros al tráfico externo a una red de VPC.

gcloud compute networks subnets update my-subnet \
    --logging-filter-expr '!(has(src_vpc.vpc_name) && has(dest_vpc.vpc_name))'

Ejemplo 4. Limita la recopilación de registros a un adjunto de VLAN o un túnel de Cloud VPN de destino específicos, my-gateway.

gcloud network-management vpc-flow-logs-configs update my-config \
    --location=global \
    --filter-expr="dest_gateway.name == 'my-gateway'"

Ejemplo 5. Limita la recopilación de registros a los adjuntos de VLAN.

gcloud network-management vpc-flow-logs-configs update my-config \
    --location=global \
    --filter-expr="dest_gateway.type == 'INTERCONNECT_ATTACHMENT'"

Ejemplo 6. Limita la recopilación de registros a una red de VPC de origen específica, my-network.

gcloud beta network-management vpc-flow-logs-configs update my-config \
    --location=global \
    --filter-expr="src_vpc.vpc_name == 'my-network'"

¿Qué sigue?

• Configura los registros de flujo de VPC
• Accede a los registros de flujo