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 regulares em equipamentos de rede, incluindo equipamentos do Cloud Interconnect. Em geral, eles são programados com antecedência e, quando possível, notificações são enviadas para que você possa se planejar para eles e evitar inatividade. Os eventos de manutenção de infraestrutura não têm um intervalo definido entre as ocorrências, mas geralmente acontecem várias vezes ao ano.

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 serviços durante a manutenção, provisione dois links em diferentes domínios de disponibilidade de borda. 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. No entanto, 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. 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