Registro y supervisión del balanceador de cargas de red de transferencia externo global

En este documento, se muestra cómo configurar y usar Cloud Logging y Cloud Monitoring para balanceadores de cargas de red de transferencia externos globales.

Logging

Los registros proporcionan información útil para solucionar problemas y supervisar tu balanceador de cargas de red de transferencia externo global. Los registros se agregan por conexión y se exportan casi en tiempo real. Los registros se generan para los flujos de TCP, UDP, ESP, GRE, ICMP y ICMPv6 de cada instancia con balanceo de cargas para el tráfico de entrada y salida. Para obtener más información sobre los campos proporcionados en la entrada de registro, consulta Campos de registro.

No se aplican cargos adicionales por usar registros. Según cómo importes registros, se aplican los precios estándar para Cloud Logging, BigQuery o Pub/Sub. La habilitación de los registros no afecta el rendimiento del balanceador de cargas.

El registro proporciona los siguientes beneficios:

• Supervisión del tráfico del balanceador de cargas de red de transferencia externo global. El registro por conexión te brinda estadísticas sobre cómo se enruta cada conexión a los backends activos.

• Solución de problemas de red Puedes usar los registros del balanceador de cargas de red de transferencia externo global para solucionar problemas.

Formato de registro de muestra para flujos de un cliente externo a VM

Los registros del balanceador de cargas de red de transferencia externo global para las conexiones del cliente a la instancia de backend tienen el siguiente formato:

• connection.clientIp: 203.0.113.7
• connection.serverIp: 136.124.69.214 (AG0) o 136.124.83.205 (AG1)
• bytesSent: 1256
• bytesReceived: 4521

Muestreo y recopilación de registros

Cloud de Confiance Crea muestras de los paquetes que entran y salen de las VMs de backend del balanceador de cargas. Esos paquetes de muestra se procesan para generar registros.

No todos los paquetes se muestrean. Cloud de Confiance Muestrea un subconjunto variable de paquetes según la cantidad de tráfico en el host físico. La tasa de muestreo más baja posible es una de 1,024 paquetes. Cloud de Confiancecontrola la tasa de muestreo de forma dinámica. No puedes ajustar la tasa de muestreo.

El muestreo de paquetes interactúa con reglas de firewall de las siguientes maneras:

• Los paquetes se muestrean antes de que se apliquen las reglas de firewall de salida.
• Los paquetes se muestrean después de que se apliquen las reglas de firewall de entrada.

Después del muestreo de paquetes, Cloud de Confiance procesa los paquetes de muestra según el siguiente procedimiento:

1. Agregación: Los paquetes de muestra se agregan durante un intervalo de cinco segundos para producir una sola entrada de flujo.

2. Muestreo de registros configurable (secundario): Este es un segundo proceso de muestreo, en el que se muestrean los flujos. Puedes controlar la fracción de las entradas de flujo que se emiten como entradas de registro según el parámetro logConfig.sampleRate. Cuando logConfig.sampleRate es 1.0 (100%), significa que se procesan todos los paquetes de muestra.

3. Escritura en Logging: Las entradas de registro se escriben en Cloud Logging.

Campos opcionales

Los registros contienen campos obligatorios y opcionales. En la sección Campos de registro, se enumeran los campos opcionales y los obligatorios. Siempre se incluyen todos los campos obligatorios. Puedes personalizar qué campos de metadatos opcionales.

• Si seleccionas Include all optional, todos los campos opcionales en el formato del registro se incluyen en los registros de flujo. Cuando se agregan campos opcionales nuevos al formato del registro, los registros de flujo incluyen automáticamente los campos nuevos.

• Si seleccionas Excluir todas las opciones opcionales, se omitirán todos los campos opcionales.

• Si seleccionas Personalizado, puedes especificar los campos opcionales que deseas incluir con el campo superior, como serverInstance, o con sus nombres completos, como serverInstance.vm.

Cuando se agregan campos opcionales nuevos al formato del registro, los registros no incluirán estos campos, a menos que sean un campo nuevo dentro de un campo superior que hayas especificado.

Si especificas un campo opcional personalizado con campos superiores, cuando los campos opcionales nuevos se agreguen al formato del registro de ese campo superior, los registros incluirán automáticamente los campos nuevos. Por ejemplo, si eliges incluir optionalFieldA, se incluirá de forma automática un campo nuevo agregado a los registros con el nombre optionalFieldA.subField1.

Para obtener instrucciones para personalizar campos opcionales, consulta Habilita el registro en un nuevo servicio de backend.

Requisitos de dirección IP de origen del paquete de respuesta

El registro muestrea los paquetes de respuesta de las VMs de backend solo si la dirección IP de origen de esos paquetes coincide con la dirección IP de la regla de reenvío del balanceador de cargas. Para las conexiones TCP, los paquetes de respuesta siempre deben tener fuentes que coincidan con el destino del paquete de solicitud. Sin embargo, para otros protocolos, es posible que los paquetes de respuesta usen una dirección IP de origen diferente. A fin de obtener más información, consulta Direcciones IP para solicitudes y paquetes de retorno.

El proceso de muestreo de paquetes que usa el registro del balanceador de cargas de red de transferencia externo global omite cualquier paquete de respuesta de las VMs de backend si esos paquetes tienen fuentes que no coinciden con una dirección IP de una regla de reenvío para un balanceador de cargas de red de transferencia externo global.

Habilita el registro en un servicio de backend nuevo

    gcloud compute backend-services create BACKEND_SERVICE \
        --global \
        --load-balancing-scheme=EXTERNAL_PASSTHROUGH \
        --enable-logging \
        --logging-sample-rate=SAMPLE_RATE \
        --logging-optional=LOGGING_OPTIONAL \
        --logging-optional-fields=OPTIONAL_FIELDS
    

    POST https://compute.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/global/backendServices
    

    {
    "name": "BACKEND_SERVICE",
    "loadBalancingScheme": "EXTERNAL_PASSTHROUGH",
    "logConfig": {
       "enable": true,
       "sampleRate": SAMPLE_RATE
      }
    }
    

    {
    "name": "BACKEND_SERVICE",
    "loadBalancingScheme": "EXTERNAL_PASSTHROUGH",
    "logConfig": {
       "enable": true,
       "sampleRate": SAMPLE_RATE,
       "optionalMode": "INCLUDE_ALL_OPTIONAL"
      }
    }
    

    {
    "name": "BACKEND_SERVICE",
    "loadBalancingScheme": "EXTERNAL_PASSTHROUGH",
    "logConfig": {
       "enable": true,
       "sampleRate": SAMPLE_RATE,
       "optionalMode": "CUSTOM",
       "optionalFields": ["field1","field2",...]
      }
    }
    

Habilita el registro en un servicio de backend existente

    gcloud compute backend-services update BACKEND_SERVICE \
        --global \
        --enable-logging \
        --logging-sample-rate=SAMPLE_RATE \
        --logging-optional=LOGGING_OPTIONAL \
        --logging-optional-fields=OPTIONAL_FIELDS
    

      PATCH https://compute.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/global/backendServices/`BACKEND_SERVICE`
     

     "logConfig": {
       "enable": true,
       "sampleRate": SAMPLE_RATE,
       "optionalMode": "EXCLUDE_ALL_OPTIONAL"
      }
     

    {
    "name": "BACKEND_SERVICE",
    "loadBalancingScheme": "EXTERNAL_PASSTHROUGH",
    "logConfig": {
       "enable": true,
       "sampleRate": SAMPLE_RATE,
       "optionalMode": "INCLUDE_ALL_OPTIONAL"
      }
    }
    

    {
    "name": "BACKEND_SERVICE",
    "loadBalancingScheme": "EXTERNAL_PASSTHROUGH",
    "logConfig": {
       "enable": true,
       "sampleRate": SAMPLE_RATE,
       "optionalMode": "CUSTOM",
       "optionalFields": ["field1","field2",...]
      }
    }
    

Inhabilita el registro en un servicio de backend existente

    gcloud compute backend-services update BACKEND_SERVICE \
        --global \
        --no-enable-logging

    PATCH https://compute.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/global/backendServices/`BACKEND_SERVICE`

    {
    "logConfig": {
      "enable": false
     }
    }

Ver registros

Cuando los registros se transfieren a Cloud Logging y no se excluyen a través de un receptor de enrutadores de registros, puedes leer los registros mediante la API de Cloud Logging y Google Cloud CLI.

Para ver todos los registros del balanceador de cargas de red de transferencia externo global, haz lo siguiente:

Visualiza los registros de un servicio de backend específico

Para ver los registros del balanceador de cargas de red de transferencia externo global de un servicio de backend específico, haz lo siguiente:

Visualiza los registros de un grupo de instancias de backend

Para ver los registros del balanceador de cargas de red de transferencia externo global de un grupo de instancias de backend específico, haz lo siguiente:

Campos de registro

Los registros contienen campos obligatorios (los campos predeterminados de cada registro) y campos opcionales que agregan información adicional. Los campos opcionales 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. En la siguiente tabla de formato de registros, se describen estos campos múltiples.

El recurso supervisado es loadbalancing.googleapis.com/ExternalNetworkLoadBalancerRule.

Formato del campo IpConnection

Formato del campo InstanceDetails

Formato del campo GeographicDetails

Formato del campo GkeDetails

Formato del campo ClusterDetails

Formato del campo PodDetails

Formato del campo ServiceDetails

Formato del campo NetworkTierDetails

Supervisión

Los balanceadores de cargas de red de transferencia externos globales exportan métricas clave a Cloud Monitoring.

Se pueden usar las métricas de Monitoring para los siguientes fines:

• Evaluar la configuración, el uso y el rendimiento de un balanceador de cargas
• Solucionar problemas
• Mejorar el uso de recursos y la experiencia del usuario

Además de los paneles predefinidos en Monitoring, puedes crear paneles personalizados, configurar alertas y consultar las métricas a través de la API de Monitoring.

Ve los paneles de Monitoring

Define los paneles personalizados de Monitoring

Puedes crear paneles personalizados de Monitoring a través de métricas del balanceador de cargas de red de transferencia externo global.

Consulta Tipos de recursos y métricas para obtener una lista de las métricas recopiladas. Si deseas ver las listas de atributos que puedes usar para filtrar resultados, consulta Filtros.

Define alertas de Monitoring

Puedes definir alertas de Monitoring a través de varias métricas del balanceador de cargas de red de transferencia externo global:

Frecuencia y retención de informes de métricas

Las métricas de los balanceadores de cargas de red de transferencia externos globales se exportan a Monitoring en lotes con un nivel de detalle de un minuto. Los datos de Monitoring se conservan durante seis semanas. Las métricas se basan en el tráfico muestreado (la tasa de muestreo es dinámica y no se puede ajustar). En el panel, se proporciona un análisis de datos en intervalos predeterminados de una hora (1H), seis horas (6H), un día (1D), una semana (1W) y seis semanas (6W). Puedes solicitar un análisis de forma manual en cualquier intervalo de seis semanas a sesenta segundos.

Tipos de recursos y métricas

En esta sección, se describen las métricas y los tipos de recursos para los balanceadores de cargas de red de transferencia externos globales.

Métricas

Las siguientes métricas para balanceadores de cargas de red de transferencia externos globales se informan en Monitoring. Puedes usar estos nombres de métricas cuando realices solicitudes a la API.

Tipos de recursos

Los balanceadores de cargas de red de transferencia externos globales usan los siguientes tipos de recursos:

• tcp_lb_rule
• udp_lb_rule
• loadbalancing.googleapis.com/ExternalNetworkLoadBalancerRule

Un balanceador de cargas de red de transferencia externo global puede admitir tráfico de TCP, UDP, ESP, GRE, ICMP e ICMPv6.

Puedes especificar el tipo de recurso como tcp_lb_rule o udp_lb_rule para limitar los datos supervisados a los protocolos TCP o UDP. Puedes especificar el tipo de recurso como loadbalancing.googleapis.com/ExternalNetworkLoadBalancerRule para supervisar todos los protocolos compatibles, incluidos TCP, ICMP, ESP, GRE, ICMv6 y UDP.

Filtros

Las métricas se agregan para cada balanceador de cargas de red de transferencia externo global. Puedes filtrar métricas agregadas por las siguientes dimensiones.

Etiquetas de recursos para tcp_lb_rule o udp_lb_rule

Puedes restringir tu búsqueda por recurso. También puedes agrupar los resultados según estos valores.

resource.label.<var>LABEL_KEY</var>:

Etiquetas de recursos de loadbalancing.googleapis.com/ExternalNetworkLoadBalancerRule

Puedes restringir tu búsqueda por recurso. También puedes agrupar los resultados según estos valores.

resource.label.<var>LABEL_KEY</var>:

Etiquetas de métrica

Puedes restringir tu búsqueda por etiqueta de métrica. También puedes agrupar los resultados según estos valores.

metric.label.<var>LABEL_KEY</var>:

Solicitudes a la API de Monitoring

Puedes crear búsquedas arbitrarias a través de los balanceadores de cargas de red de transferencia externos globales con la solicitud v3 projects.timeSeries.list de la API de Monitoring. La estructura exacta de las diversas definiciones respeta la semántica genérica de los filtros de supervisión.

Ejemplos de solicitudes a la API

• Obtén todos los bytes enviados desde todos los balanceadores de cargas de red de transferencia externos globales del proyecto, entre las 12:00 y las 12:02 p.m. UTC del 1 de julio de 2019, con agregados de 1 m.

  Parámetros de timeSeries.list:

  • name: projects/PROJECT_ID
  • Filter: resource.type = "tcp_lb_rule" AND metric.name="loadbalancing.googleapis.com/l3/external/egress_bytes_count"
  • interval.start_time: 2019-07-01T12:00:00Z
  • interval.end_time: 2019-07-01T12:02:00Z
  • aggregation.alignmentPeriod: 60s
  • aggregation.crossSeriesReducer: REDUCE_SUM
  • aggregation.perSeriesAligner: ALIGN_SUM

• Obtén una medición de la mediana del RTT en todos los balanceadores de cargas de red de transferencia externos globales del proyecto, entre las 12:19 y las 12:20 p.m. UTC del 1 de julio de 2019, desglosada por país del cliente.

  Parámetros de timeSeries.list:

  • name: projects/PROJECT_ID
  • Filter: resource.type = "tcp_lb_rule" AND metric.name="loadbalancing.googleapis.com/l3/external/rtt_latencies"
  • interval.start_time: 2019-07-01T12:19:00Z
  • interval.end_time: 2019-07-01T12:20:00Z
  • aggregation.alignmentPeriod: 60s
  • aggregation.crossSeriesReducer: REDUCE_SUM
  • aggregation.groupByFields: metric.label.client_country
  • aggregation.perSeriesAligner: ALIGN_PERCENTILE_50

• Obtén el total de bytes de un balanceador de cargas de red de transferencia externo global específico entre las 12:19 y 12:20 p.m. UTC del 1 de julio de 2019, que se desglosa por la zona del extremo y el continente del cliente.

  Parámetros de timeSeries.list:

  • name: projects/PROJECT_ID
  • Filter: resource.type = "tcp_lb_rule" AND resource.label.load_balancer_name = "netlb-bs-1" AND metric.name="loadbalancing.googleapis.com/l3/external/ingress_bytes_count"
  • interval.start_time: 2019-07-01T12:19:00Z
  • interval.end_time: 2019-07-01T12:20:00Z
  • aggregation.alignmentPeriod: 60s
  • aggregation.crossSeriesReducer: REDUCE_SUM
  • aggregation.groupByFields: metric.label.client_continent
  • aggregation.groupByFields: resource.label.endpoint_zone
  • aggregation.perSeriesAligner: ALIGN_SUM

¿Qué sigue?

• Descripción general del balanceador de cargas de red de transferencia externo global
• Métricas, series temporales y recursos de Monitoring
• Descripción general de las reglas de reenvío