Esta página foi traduzida pela API Cloud Translation.

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 e evitar inatividade.

Manutenção planejada

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 eventos de manutenção de diferentes tipos tenham a mesma aparência no console do Google Cloud . A maioria dos tipos de eventos de manutenção planejada ocorre entre 22h e 5h, no horário local de onde o dispositivo de rede está localizado. Por exemplo, se o dispositivo estiver localizado em asia-south1, a manutenção planejada geralmente ocorrerá entre 22h e 5h, 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 planejada, uma migração física, acontece de segunda a sexta-feira, das 9h às 17h, horário do leste dos EUA.

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.

A capacidade total afetada por um evento de manutenção não planejada varia de acordo com a natureza do evento. Pode ser até 100% da capacidade em uma ou mais conexões do Cloud Interconnect.

Manutenção urgente

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

Links únicos e SLA

Um único link em um domínio de disponibilidade de borda não tem um SLA. Para evitar a perda de acesso aos 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

Você recebe notificações sobre eventos de manutenção planejados, não planejados e urgentes.

As notificações de 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 do 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.

Durante eventos não planejados ou urgentes, você pode receber uma notificação de 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 aparecem 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 Essential Contacts para enviar notificações sobre 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 do Cloud Interconnect 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.

Propriedades de notificação de evento

Esta seção se aplica à Interconexão dedicada, Interconexão entre nuvens e à interconexão entre sites.

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

Um e-mail é enviado a todos os proprietários de projeto da conexão do Cloud Interconnect 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 Google Cloud CLI:
```
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 do Cloud Interconnect.

Durante um evento de manutenção de infraestrutura não planejado ou urgente, os usuários recebem as seguintes notificações:

Um e-mail é enviado a todos os proprietários de projeto da conexão do Cloud Interconnect assim que uma manutenção impactante é programada.
Um e-mail é enviado ao endereço listado no campo nocContactEmail do objeto do Cloud Interconnect.
Um e-mail é enviado para todos os contatos técnicos listados para o projeto que hospeda a conexão do Cloud Interconnect.

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.

Ver 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 programada, 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"
]
}

Ver eventos de manutenção na Manutenção unificada

Use a manutenção unificada para conferir eventos de manutenção da infraestrutura do Cloud Interconnect e configure-a para enviar alertas e notificações sobre esses eventos. As notificações não aparecem na manutenção unificada para usuários da Interconexão por parceiro.

Siga as etapas na página Configurar alertas e notificações, mas use um dos seguintes filtros de inclusão quando for solicitado a criar um:

Esse filtro inclui apenas notificações de manutenção planejada:

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

Esse filtro inclui apenas notificações de manutenção urgente:

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

Esse filtro contém apenas notificações de manutenção não planejada:

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 eventos de manutenção com o estado Programado, consulte Ver manutenções de recursos usando a 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óximas etapas

Implementar as práticas recomendadas do Cloud Interconnect
Gerenciar contatos para notificações