Eventos de manutenção de infraestrutura

Neste guia, descrevemos os eventos de manutenção da infraestrutura e como eles podem afetar as conexões do Cloud Interconnect.

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

Eventos de manutenção de infraestrutura são momentos em que o Google Cloud realiza manutenções em equipamentos de rede, incluindo equipamentos do Cloud Interconnect. Quando possível, enviamos notificações para que você possa se planejar para o evento de manutenção da infraestrutura e evitar inatividade.

Manutenção planejada

O Google Cloud executa vários tipos de eventos de manutenção. As diferenças entre os tipos de eventos de manutenção foram simplificadas para que eventos de manutenção de tipos diferentes tenham a mesma aparência no console do Google Cloud. A maioria dos tipos de eventos de manutenção planejados ocorre entre 22h e 5h, horário local, no local onde o dispositivo de rede está localizado. Por exemplo, se o dispositivo estiver localizado em asia-south1, a manutenção planejada geralmente ocorre entre 22h e 5h no horário padrão da Índia (UTC+5:30). Os eventos de manutenção planejada não têm um intervalo definido entre as ocorrências, mas geralmente acontecem várias vezes ao ano.

Um tipo de evento de manutenção planejado, uma migração física, ocorre de segunda a sexta-feira, das 9h às 17h no horário da Costa Leste.

Manutenção não planejada

Também podem ocorrer eventos de manutenção emergenciais ou não programados. Eventos de emergência são irregulares, não planejados e podem afetar as conexões do Cloud Interconnect. Infelizmente, eventos de emergência podem acontecer a qualquer momento, sem aviso. O Google recomenda que você crie topologias de rede híbrida de alta disponibilidade para reduzir as interrupções de rede causadas por eventos de manutenção de emergência.

Um único link em um domínio de disponibilidade de borda não tem nenhum SLA. Para evitar a perda de acesso aos seus serviços durante a manutenção, provisione dois links em domínios de disponibilidade de borda diferentes. Para mais informações, consulte Criar conexões redundantes do Cloud Interconnect com capacidade suficiente.

Como receber notificações de eventos

A maioria das notificações trata de interrupções planejadas e possíveis, para que você possa realizar ações preventivas, como redirecionar o tráfego. As notificações para eventos de manutenção planejados são enviadas pelo menos 14 dias antes do evento para o e-mail listado no campo nocContactEmail do objeto Cloud Interconnect e são exibidas no método da API interconnects.get. Para mais informações, consulte Como atribuir contatos para notificações de eventos.

No caso improvável de um evento de emergência, você pode receber uma notificação sobre uma interrupção, mas não ter tempo suficiente para redirecionar o tráfego. Para reduzir as chances de interrupções no tráfego devido a interrupções de emergência, consulte Práticas recomendadas.

Os eventos de manutenção podem não acontecer como planejado. Enviaremos notificações atualizadas se um evento de manutenção for remarcado ou cancelado.

As notificações não são exibidas no console do Google Cloud para usuários da Interconexão por parceiro.

Como atribuir contatos para notificações de eventos

O Cloud Interconnect notifica os proprietários do projeto e também usa a API Essentials Contacts para enviar notificações sobre os próximos eventos de manutenção. Se você não atribuir um contato técnico a um projeto, as notificações serão enviadas para contatos substitutos, que são baseados em papéis do IAM.

Para garantir que você receba a notificação adequada sobre eventos de manutenção, especifique pelo menos um contato técnico para qualquer projeto que hospede uma conexão da Interconexão dedicada ou um anexo da VLAN.

Para mais informações sobre como atribuir contatos técnicos para um projeto, consulte Como gerenciar contatos para notificações.

Notificações de eventos da Interconexão dedicada

Antes de um evento de manutenção de infraestrutura programado, os usuários da Interconexão dedicada recebem as seguintes notificações:

  • Um e-mail é enviado a todos os proprietários de projeto da conexão da Interconexão dedicada assim que uma manutenção impactante é programada.

  • Um e-mail é enviado ao endereço listado no campo nocContactEmail do objeto do Cloud Interconnect. É possível encontrar e editar esse objeto no console do Google Cloud, na página de detalhes do Cloud Interconnect ou usando o seguinte comando da CLI do Google Cloud:

    gcloud compute interconnects describe my-interconnect

  • Um e-mail é enviado para todos os contatos técnicos listados para o projeto que hospeda a conexão da Interconexão dedicada.

  • Uma notificação é exibida na guia Atividade do console do Google Cloud e na área Notificações.

Notificações de eventos da Interconexão por parceiro

Antes de um evento de manutenção de infraestrutura programado, os usuários da Interconexão por parceiro recebem as seguintes notificações:

  • Um e-mail é enviado para todos os contatos técnicos do projeto que hospeda o anexo da VLAN.

  • Um e-mail é enviado a todos os proprietários do projeto que hospeda o anexo da VLAN.

Status de interrupção do serviço

Os e-mails de eventos enviados aos proprietários de projetos e aos contatos do nocContactEmail incluem uma seção intitulada "Status de interrupção do serviço". Confira os seguintes estados de status de interrupção possíveis:

  • Atualizado: um evento de manutenção programado anteriormente é atualizado ou reprogramado.

  • Excesso: um evento de manutenção programado anteriormente que está em andamento e levando 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 programado anteriormente é cancelado.

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

  • Nenhuma alteração: um evento de manutenção programado anteriormente ainda está programado conforme planejado.

Consultar os próximos eventos de manutenção

Selecione uma das seguintes opções:

gcloud

Para exibir informações sobre a conexão, incluindo os próximos eventos de manutenção, execute o seguinte comando:

gcloud compute interconnects describe INTERCONNECT_NAME

Substitua INTERCONNECT_NAME pelo nome do Cloud Interconnect.

A resposta será semelhante a esta: procure por 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 conexão, incluindo os próximos eventos de manutenção, use interconnects.get:

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

Substitua:

  • PROJECT_ID: o ID do projeto em que o Cloud Interconnect está

  • INTERCONNECT_NAME: o nome do Cloud Interconnect

O resultado será assim:

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

Próximas etapas