Eventos de manutenção de infraestruturas

Este guia descreve os eventos de manutenção da infraestrutura e como podem afetar as ligações do Cloud Interconnect.

O que são eventos de manutenção da infraestrutura

Os eventos de manutenção da infraestrutura são momentos em que a Google Google Cloud realiza manutenção no equipamento de rede, incluindo equipamento para o Cloud Interconnect. Sempre que possível, enviamos uma notificação para que possa planear o evento de manutenção da infraestrutura e evitar o tempo de inatividade.

Manutenção planeada

Google Cloud realiza muitos tipos diferentes de eventos de manutenção. As diferenças entre os tipos de eventos de manutenção são simplificadas, para que os eventos de manutenção de diferentes tipos tenham o mesmo aspeto na Google Cloud consola. A maioria dos tipos de eventos de manutenção planeados ocorre entre as 22:00 e as 05:00, hora local, do local onde o dispositivo de rede se encontra. Por exemplo, se o dispositivo estiver localizado em asia-south1, a manutenção planeada ocorre normalmente entre as 22:00 e as 05:00 da hora padrão da Índia (UTC+5:30). Os eventos de manutenção planeados não têm um intervalo definido entre ocorrências, mas geralmente ocorrem várias vezes por ano.

Um tipo de evento de manutenção planeado, uma migração física, ocorre de segunda a sexta-feira, das 09:00 às 17:00, hora do leste.

Manutenção não planeada

Também podem ocorrer eventos de manutenção de emergência ou não agendados. Os eventos de emergência são eventos irregulares e não planeados que podem afetar as ligações do Cloud Interconnect. Infelizmente, os eventos de emergência podem ocorrer em qualquer altura, sem aviso. A Google recomenda que crie topologias de rede híbridas de alta disponibilidade para mitigar as falhas de rede causadas por eventos de manutenção de emergência.

A capacidade total afetada por um evento de manutenção não planeado varia consoante a natureza do evento. Pode ser até 100% da sua capacidade numa ou mais das suas ligações do Cloud Interconnect.

Manutenção urgente

Os eventos de manutenção urgentes são semelhantes aos eventos de manutenção planeados, mas são agendados com menos de 14 dias de antecedência. Além disso, afetam até 100% da capacidade total em cada uma das suas ligações do Cloud Interconnect afetadas.

Uma única associação num domínio de disponibilidade de limite não tem um SLA. Para evitar a perda de acesso aos seus serviços durante a manutenção, certifique-se de que aprovisiona dois links em domínios de disponibilidade de limite diferentes. Para mais informações, consulte o artigo Crie ligações redundantes do Cloud Interconnect com capacidade suficiente.

Receção de notificações de eventos

Recebe notificações de eventos de manutenção planeados, não planeados e urgentes.

As notificações de eventos de manutenção planeados são enviadas, pelo menos, 14 dias antes do evento para o email indicado no campo nocContactEmail do objeto Cloud Interconnect e são apresentadas no método da API interconnects.get. Para mais informações, consulte o artigo Atribuir contactos para notificações de eventos.

Durante eventos não planeados ou urgentes, pode receber uma notificação de interrupção, mas não ter tempo suficiente para redirecionar o tráfego. Para reduzir as hipóteses de interrupções no tráfego devido a interrupções de emergência, consulte as práticas recomendadas.

Os eventos de manutenção podem não ocorrer conforme planeado. Enviamos notificações de eventos atualizadas se um evento de manutenção for reagendado ou cancelado.

As notificações não aparecem na Google Cloud consola para os utilizadores da interligação de parceiros.

Atribuir contactos para notificações de eventos

O Cloud Interconnect notifica os proprietários do projeto e também usa a API Contactos essenciais para enviar notificações sobre eventos de manutenção. Se não atribuir um contacto técnico a um projeto, as notificações são enviadas para contactos alternativos, que se baseiam em funções de IAM.

Para garantir que recebe a notificação adequada sobre eventos de manutenção, especifique, pelo menos, um contacto técnico para qualquer projeto que aloje uma ligação do Cloud Interconnect ou uma associação de VLAN.

Para mais informações sobre a atribuição de contactos técnicos a um projeto, consulte o artigo Gerir contactos para notificações.

Propriedades de notificação de eventos

Esta secção aplica-se à interligação dedicada, à interligação entre nuvens e à interligação entre sites.

Antes de um evento de manutenção da infraestrutura planeado, os utilizadores recebem as seguintes notificações:

  • É enviado um email a todos os proprietários do projeto com ligação do Cloud Interconnect assim que for agendada uma manutenção com impacto.

  • É enviado um email para o endereço indicado no campo nocContactEmail do objeto Cloud Interconnect. Pode encontrar e editar este objeto na consola na página de detalhes do Cloud Interconnect ou usando o seguinte comando da CLI gcloud do Google Cloud: Google Cloud 

    gcloud compute interconnects describe my-interconnect

  • É enviado um email para todos os contactos técnicos indicados para o projeto que aloja a ligação do Cloud Interconnect.

Durante um evento de manutenção da infraestrutura não planeado ou urgente, os utilizadores recebem as seguintes notificações:

  • É enviado um email a todos os proprietários do projeto com ligação do Cloud Interconnect assim que for agendada uma manutenção com impacto.

  • É enviado um email para o endereço indicado no campo nocContactEmail do objeto Cloud Interconnect.

  • É enviado um email para todos os contactos técnicos indicados para o projeto que aloja a ligação do Cloud Interconnect.

Notificações de eventos da Interligação de parceiros

Antes de um evento de manutenção da infraestrutura agendado, os utilizadores do Partner Interconnect recebem as seguintes notificações:

  • É enviado um email a todos os contactos técnicos do projeto que aloja o anexo da VLAN.

  • É enviado um email a todos os proprietários do projeto que aloja a associação de VLAN.

Estados de indisponibilidade

Os emails de eventos enviados aos proprietários de projetos e aos contactos nocContactEmail incluem uma secção intitulada "Estado da indisponibilidade". A seguir, são descritos os estados possíveis do estado de indisponibilidade:

  • Atualizado: um evento de manutenção agendado anteriormente que é atualizado ou reagendado.

  • Ultrapassagem: um evento de manutenção agendado anteriormente que está em curso e a demorar mais tempo do que o esperado para ser concluído.

  • Concluído: um evento de manutenção concluído.

  • Cancelado: um evento de manutenção agendado anteriormente que foi cancelado.

  • Novo: um novo evento de manutenção.

  • Sem alterações: um evento de manutenção agendado anteriormente que ainda está agendado conforme planeado.

Veja eventos de manutenção

Selecione uma das seguintes opções:

gcloud

Para apresentar informações sobre a sua ligação, incluindo eventos de manutenção planeados futuros, execute o seguinte comando:

gcloud compute interconnects describe INTERCONNECT_NAME

Substitua INTERCONNECT_NAME pelo nome do Cloud Interconnect.

O resultado é semelhante ao seguinte; procure 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 listar informações sobre a sua ligação, incluindo eventos de manutenção futuros, use interconnects.get:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto no qual o Cloud Interconnect está localizado

  • INTERCONNECT_NAME: o nome do Cloud Interconnect

O resultado é semelhante ao seguinte:

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

Veja eventos de manutenção na Unified Maintenance

Pode usar a manutenção unificada para ver eventos de manutenção da infraestrutura do Cloud Interconnect e pode configurar a manutenção unificada para enviar alertas e notificações sobre eventos de manutenção. As notificações não aparecem na manutenção unificada para utilizadores do Partner Interconnect.

Siga os passos na página Configure alertas e notificações, mas use um dos seguintes filtros de inclusão quando lhe for pedido que crie um:

  • Este filtro inclui apenas notificações de manutenção planeada:

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

  • Este filtro inclui apenas notificações de manutenção urgentes:

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

  • Este filtro contém apenas notificações de manutenção não planeada:

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

Em alternativa, para ver eventos de manutenção com o estado Agendado, consulte o artigo Veja manutenções de recursos através da 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"

Passos seguintes