Esta página se ha traducido con Cloud Translation API.

Eventos de mantenimiento de la infraestructura

En esta guía se describen los eventos de mantenimiento de la infraestructura y cómo pueden afectar a las conexiones de Cloud Interconnect.

Qué son los eventos de mantenimiento de la infraestructura

Los eventos de mantenimiento de la infraestructura son momentos en los que Google Cloud realiza mantenimiento en el equipo de red, incluido el equipo de Cloud Interconnect. Cuando es posible, enviamos una notificación para que puedas planificar el evento de mantenimiento de la infraestructura y evitar el tiempo de inactividad.

Mantenimiento planificado

Google Cloud realiza muchos tipos diferentes de eventos de mantenimiento. Las diferencias entre los tipos de eventos de mantenimiento se han simplificado para que los eventos de mantenimiento de diferentes tipos tengan el mismo aspecto en la consola Google Cloud . La mayoría de los tipos de eventos de mantenimiento programado se producen entre las 22:00 y las 5:00 (hora local) de la ubicación del dispositivo de red. Por ejemplo, si el dispositivo se encuentra en asia-south1, el mantenimiento programado suele realizarse entre las 22:00 y las 5:00 (hora estándar de la India, UTC+5:30). Los eventos de mantenimiento programado no tienen un intervalo fijo entre las ocurrencias, pero suelen producirse varias veces al año.

Un tipo de evento de mantenimiento programado, la migración física, se lleva a cabo de lunes a viernes, de 9:00 a 17:00 (hora del este).

Mantenimiento no planificado

También pueden producirse tareas de mantenimiento de emergencia o no programadas. Los eventos de emergencia son eventos irregulares e imprevistos que pueden afectar a las conexiones de Cloud Interconnect. Lamentablemente, las emergencias pueden producirse en cualquier momento y sin previo aviso. Google recomienda crear topologías de red híbridas de alta disponibilidad para mitigar las interrupciones de la red causadas por eventos de mantenimiento de emergencia.

La capacidad total afectada por un evento de mantenimiento no planificado varía en función de la naturaleza del evento. Podría ser hasta el 100% de tu capacidad en una o varias de tus conexiones de Cloud Interconnect.

Mantenimiento urgente

Los eventos de mantenimiento urgentes son similares a los eventos de mantenimiento programados, pero se programan con menos de 14 días de antelación. Además, afectan hasta al 100 % de la capacidad total de cada una de tus conexiones de Cloud Interconnect afectadas.

Enlaces únicos y SLA

Un solo enlace en un dominio de disponibilidad de un extremo no tiene ningún SLA. Para evitar la pérdida de acceso a tus servicios durante el mantenimiento, asegúrate de aprovisionar dos enlaces en diferentes dominios de disponibilidad de borde. Para obtener más información, consulta el artículo Crear conexiones redundantes de Cloud Interconnect con capacidad suficiente.

Recibir notificaciones de eventos

Recibirás notificaciones de eventos de mantenimiento programados, no programados y urgentes.

Las notificaciones de los eventos de mantenimiento programado se envían al menos 14 días antes del evento a la dirección de correo que figura en el campo nocContactEmail del objeto Cloud Interconnect y se muestran en el método de la API interconnects.get. Para obtener más información, consulta el artículo Asignar contactos para las notificaciones de eventos.

Durante eventos imprevistos o urgentes, es posible que recibas una notificación de interrupción, pero que no tengas tiempo suficiente para redirigir el tráfico. Para reducir las probabilidades de que se produzcan interrupciones en el tráfico debido a interrupciones de emergencia, consulta las prácticas recomendadas.

Es posible que los eventos de mantenimiento no se produzcan según lo previsto. Enviamos notificaciones actualizadas sobre eventos si se reprograma o cancela un evento de mantenimiento.

Las notificaciones no aparecen en la consola de los usuarios de Partner Interconnect. Google Cloud

Asignar contactos para las notificaciones de eventos

Cloud Interconnect envía notificaciones a los propietarios del proyecto y también usa la API Essential Contacts para enviar notificaciones sobre eventos de mantenimiento. Si no asignas un contacto técnico a un proyecto, las notificaciones se enviarán a los contactos alternativos, que se basan en los roles de gestión de identidades y accesos.

Para asegurarte de que recibes las notificaciones adecuadas sobre los eventos de mantenimiento, especifica al menos un contacto técnico para cada proyecto que aloje una conexión de Cloud Interconnect o una vinculación de VLAN.

Para obtener más información sobre cómo asignar contactos técnicos a un proyecto, consulta el artículo Gestionar contactos de notificaciones.

Propiedades de notificación de eventos

Esta sección se aplica a Interconexión dedicada, Cross-Cloud Interconnect y Cross-Site Interconnect.

Antes de un evento de mantenimiento de la infraestructura programado, los usuarios reciben las siguientes notificaciones:

Se envía un correo a todos los propietarios del proyecto de conexión de Cloud Interconnect en cuanto se programa un mantenimiento que pueda afectar.
Se envía un correo a la dirección indicada en el campo nocContactEmail del objeto Cloud Interconnect. Puedes encontrar y editar este objeto en la Google Cloud consola, en la página de detalles de Cloud Interconnect, o bien con el siguiente comando de la CLI de Google Cloud:
```
gcloud compute interconnects describe my-interconnect
```
Se envía un correo a los contactos técnicos que figuren en el proyecto que aloja la conexión de Cloud Interconnect.

Durante un evento de mantenimiento de infraestructura imprevisto o urgente, los usuarios reciben las siguientes notificaciones:

Se envía un correo a todos los propietarios del proyecto de conexión de Cloud Interconnect en cuanto se programa un mantenimiento que pueda afectar.
Se envía un correo a la dirección indicada en el campo nocContactEmail del objeto Cloud Interconnect.
Se envía un correo a los contactos técnicos que figuren en el proyecto que aloja la conexión de Cloud Interconnect.

Notificaciones de eventos de Partner Interconnect

Antes de un evento de mantenimiento de la infraestructura programado, los usuarios de Interconnect de socio reciben las siguientes notificaciones:

Se envía un correo a los contactos técnicos del proyecto que aloja la vinculación de VLAN.
Se envía un correo a todos los propietarios del proyecto que aloja la vinculación de VLAN.

Estados de interrupción

Los correos de eventos que se envían a los propietarios de proyectos y a los contactos de nocContactEmail incluyen una sección titulada "Estado de la interrupción". A continuación, se describen los posibles estados de interrupción:

Actualizado: un evento de mantenimiento programado que se ha actualizado o reprogramado.
Tiempo extra: un evento de mantenimiento programado que está en curso y que está tardando más de lo previsto en completarse.
Completado: un evento de mantenimiento completado.
Cancelado: un evento de mantenimiento programado que se ha cancelado.
Nuevo: un nuevo evento de mantenimiento.
Sin cambios: un evento de mantenimiento programado previamente que sigue programado como se había previsto.

Ver eventos de mantenimiento

Selecciona una de las opciones siguientes:

gcloud

Para mostrar información sobre tu conexión, incluidos los eventos de mantenimiento programados, ejecuta el siguiente comando:

gcloud compute interconnects describe INTERCONNECT_NAME

Sustituye INTERCONNECT_NAME por el nombre de Cloud Interconnect.

El resultado es similar al siguiente. Busca expectedOutages:

adminEnabled: true
availableFeatures:
- IF_MACSEC
circuitInfos:
- customerDemarcId: demarc-0
  googleCircuitId: circuit-0
  googleDemarcId: local-demarc-0
creationTimestamp: '2021-12-15T17:02:48.829-08:00'
customerName: Cymbal Group
description: Interconnect connection
expectedOutages:
- description: ''
  endTime: '1705520100000'
  issueType: IT_OUTAGE
  name: pcr-764913
  source: NSRC_GOOGLE
  startTime: '1705501500000'
  state: CANCELLED
- description: ''
  endTime: '1707304200000'
  issueType: IT_OUTAGE
  name: pcr-777490
  source: NSRC_GOOGLE
  startTime: '1707285600000'
  state: COMPLETED
googleIpAddress: 192.0.2.0/24
googleReferenceId: '6006458259035'
id: '249691500371717847'
interconnectType: IT_PRIVATE
kind: compute#interconnect
labelFingerprint: 42WmSpB8rSM=
linkType: LINK_TYPE_ETHERNET_10G_LR
location: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnectLocations/sjc-zone1-6
macsec:
  failOpen: false
  preSharedKeys:
  - name: key-1
    startTime: '2023-08-08T21:09:21.385Z'
macsecEnabled: false
name: cymbal-group-interconnect
nocContactEmail: cloudysanfrancisco@gmail.com
operationalStatus: OS_ACTIVE
peerIpAddress: 192.0.2.0/24
provisionedLinkCount: 1
requestedLinkCount: 1
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME
state: ACTIVE

API REST

Para consultar información sobre tu conexión, incluidos los eventos de mantenimiento próximos, usa interconnects.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME

Haz los cambios siguientes:

PROJECT_ID: el ID del proyecto en el que se encuentra Cloud Interconnect
INTERCONNECT_NAME: el nombre de Cloud Interconnect

El resultado debería ser similar al siguiente:

{
"kind": "compute#interconnect",
"description": "Interconnect connection",
"selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME",
"id": "249691500371717847",
"creationTimestamp": "2021-12-15T17:02:48.829-08:00",
"name": "INTERCONNECT_NAME",
"location": "https://www.googleapis.com/compute/v1/projects/INTERCONNECT_NAME/global/interconnectLocations/sjc-zone1-6",
"linkType": "LINK_TYPE_ETHERNET_10G_LR",
"requestedLinkCount": 1,
"interconnectType": "IT_PRIVATE",
"adminEnabled": true,
"nocContactEmail": "",
"customerName": "Cymbal Group",
"operationalStatus": "OS_ACTIVE",
"provisionedLinkCount": 1,
"peerIpAddress": "192.0.2.0/24",
"googleIpAddress": "192.0.2.0/24",
"googleReferenceId": "6006458259035",
"expectedOutages": [
  {
    "name": "pcr-764913",
    "description": "",
    "source": "NSRC_GOOGLE",
    "state": "CANCELLED",
    "issueType": "IT_OUTAGE",
    "startTime": "1705501500000",
    "endTime": "1705520100000"
  },
  {
    "name": "pcr-777490",
    "description": "",
    "source": "NSRC_GOOGLE",
    "state": "COMPLETED",
    "issueType": "IT_OUTAGE",
    "startTime": "1707285600000",
    "endTime": "1707304200000"
  }
],
"circuitInfos": [
  {
    "googleCircuitId": "circuit-0",
    "googleDemarcId": "local-demarc-0",
    "customerDemarcId": "demarc-0"
  }
],
"labelFingerprint": "42WmSpB8rSM=",
"state": "ACTIVE",
"macsec": {
  "preSharedKeys": [
    {
      "name": "key-1",
      "startTime": "2023-08-08T21:09:21.385Z"
    }
  ],
  "failOpen": false
},
"macsecEnabled": false,
"availableFeatures": [
  "IF_MACSEC"
]
}

Ver eventos de mantenimiento en Unified Maintenance

Puedes usar Mantenimiento unificado para ver los eventos de mantenimiento de la infraestructura de Cloud Interconnect y configurarlo para que envíe alertas y notificaciones sobre los eventos de mantenimiento. Las notificaciones no aparecen en Mantenimiento unificado para los usuarios de Partner Interconnect.

Sigue los pasos que se indican en la página Configurar alertas y notificaciones, pero usa uno de los siguientes filtros de inclusión cuando se te pida que crees uno:

Este filtro solo incluye notificaciones de mantenimiento programado:

log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Planned Outage.*"

Este filtro solo incluye notificaciones de mantenimiento urgentes:

log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Urgent Maintenance.*"

Este filtro solo contiene notificaciones de mantenimiento no programado:

log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Unplanned Outage.*"

También puede consultar los eventos de mantenimiento con el estado Programado en el artículo Ver el mantenimiento de recursos mediante la API.

$ curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/resourceMaintenances?filter=resource.type%3D%22compute.googleapis.com/Interconnect%22%20AND%20state%3D%22SCHEDULED%22"

Pasos siguientes

Implementar las prácticas recomendadas de Cloud Interconnect
Gestionar contactos para las notificaciones