Se usó la API de Cloud Translation para traducir esta página.

Eventos de mantenimiento de infraestructura

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

Qué son los eventos de mantenimiento de infraestructura

Los eventos de mantenimiento de infraestructura son momentos en que Google Cloud realiza mantenimiento en equipos de red, incluidos los equipos de Cloud Interconnect. Proporcionamos notificaciones, cuando es posible, para que puedas planificar el evento de mantenimiento de infraestructura y evitar el tiempo de inactividad.

Mantenimiento planificado

Google Cloud realiza muchos tipos diferentes de eventos de mantenimiento. Se simplificaron las diferencias entre los tipos de eventos de mantenimiento, de modo que los eventos de mantenimiento de diferentes tipos se vean iguales en la consola de Google Cloud . La mayoría de los tipos de eventos de mantenimiento planificados ocurren entre las 10 p.m. y las 5 a.m. (hora local) del lugar donde se encuentra el dispositivo de red. Por ejemplo, si el dispositivo se encuentra en asia-south1, el mantenimiento planificado suele realizarse entre las 10 p.m. y las 5 a.m. (hora estándar de la India, UTC+5:30). Los eventos de mantenimiento planificado no tienen un intervalo establecido entre los casos, pero, por lo general, se realizan varias veces al año.

Un tipo de evento de mantenimiento planificado, una migración física, se lleva a cabo de lunes a viernes, de 9 a.m. a 5 p.m. (hora del este).

Mantenimiento imprevisto

También pueden ocurrir eventos de mantenimiento de emergencia o no programados. Los eventos de emergencia son eventos irregulares y no planificados que pueden afectar las conexiones de Cloud Interconnect. Lamentablemente, los eventos de emergencia pueden ocurrir en cualquier momento y sin previo aviso. Google recomienda que crees topologías de red híbrida de alta disponibilidad para mitigar las interrupciones de red causadas por eventos de mantenimiento de emergencia.

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

Mantenimiento urgente

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

Vínculos únicos y ANS

Un vínculo único en un dominio de disponibilidad perimetral no proporciona un ANS. Para evitar la pérdida del acceso a tus servicios durante el mantenimiento, asegúrate de aprovisionar dos vínculos en diferentes dominios de disponibilidad perimetral. Para obtener más información, consulta Crea conexiones de Cloud Interconnect redundantes con capacidad suficiente.

Cómo recibir notificaciones de eventos

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

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

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

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

Las notificaciones no aparecen en la consola de Google Cloud para los usuarios de interconexión de socio.

Asigna contactos para notificaciones de eventos

Cloud Interconnect notifica a los propietarios del proyecto y también usa la API de Essential Contacts para enviar notificaciones sobre los eventos de mantenimiento. Si no asignas un contacto técnico a un proyecto, se envían notificaciones a los contactos de resguardo, que se basan en roles de IAM.

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

Para obtener más información sobre cómo asignar contactos técnicos a un proyecto, consulta Administra contactos para notificaciones.

Propiedades de las notificaciones de eventos

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

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

Se envía un correo electrónico a todos los propietarios del proyecto de conexión de Cloud Interconnect en cuanto se programe un mantenimiento.
Se envía un correo electrónico a la dirección que aparece en el campo nocContactEmail del objeto de Cloud Interconnect. Puedes encontrar y editar este objeto en la consola de Google Cloud en la página de detalles de Cloud Interconnect o con el siguiente comando de Google Cloud CLI:
```
gcloud compute interconnects describe my-interconnect
```
Se envía un correo electrónico a cualquier contacto técnico que aparezca en el proyecto y que aloje la conexión de Cloud Interconnect.

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

Se envía un correo electrónico a todos los propietarios del proyecto de conexión de Cloud Interconnect en cuanto se programe un mantenimiento.
Se envía un correo electrónico a la dirección que aparece en el campo nocContactEmail del objeto de Cloud Interconnect.
Se envía un correo electrónico a cualquier contacto técnico que aparezca en el proyecto y que aloje la conexión de Cloud Interconnect.

Notificaciones de eventos de la interconexión de socio

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

Se envía un correo electrónico a cualquier contacto técnico del proyecto que aloje el adjunto de VLAN.
Se envía un correo electrónico a todos los propietarios del proyecto que aloja el adjunto de VLAN.

Estados de la interrupción

Los correos electrónicos de eventos enviados a los propietarios del proyecto 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 la interrupción:

Actualizado: Es un evento de mantenimiento programado previamente que se actualizó o reprogramó.
Sobregiro: Es un evento de mantenimiento programado previamente que está en curso y tarda más de lo esperado en completarse.
Completado: Es un evento de mantenimiento completado.
Cancelado: Es un evento de mantenimiento programado previamente que se canceló.
Nuevo: Es un evento de mantenimiento nuevo.
Sin cambios: Es un evento de mantenimiento programado previamente que sigue programado según lo previsto.

Cómo ver eventos de mantenimiento

Selecciona una de las siguientes opciones:

gcloud

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

gcloud compute interconnects describe INTERCONNECT_NAME

Reemplaza INTERCONNECT_NAME con el nombre de la conexión 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 de REST

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

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

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto en el que se encuentra Cloud Interconnect
INTERCONNECT_NAME: El nombre de la conexión de Cloud Interconnect

El resultado es similar a este:

{
"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"
]
}

Cómo ver eventos de mantenimiento en Mantenimiento unificado

Puedes usar el 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 el Mantenimiento unificado para los usuarios de interconexión de socio.

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

Este filtro solo incluye las notificaciones de mantenimiento planificado:

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 las 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 planificado:

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

Como alternativa, para ver los eventos de mantenimiento con el estado Programado, consulta Cómo ver el mantenimiento de los recursos con 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"

Próximos pasos

Implementa las prácticas recomendadas de Cloud Interconnect
Administra los contactos para las notificaciones