Eventi di manutenzione dell'infrastruttura

Questa guida descrive gli eventi di manutenzione dell'infrastruttura e il loro impatto sulle connessioni Cloud Interconnect.

Che cosa sono gli eventi di manutenzione dell'infrastruttura

Gli eventi di manutenzione dell'infrastruttura sono periodi in cui Google Cloud esegue la manutenzione delle apparecchiature di rete, comprese quelle per Cloud Interconnect. Se possibile, inviamo una notifica in modo che tu possa pianificare l'evento di manutenzione dell'infrastruttura ed evitare tempi di inattività.

Manutenzione pianificata

Google Cloud esegue molti tipi diversi di eventi di manutenzione. Le differenze tra i tipi di eventi di manutenzione sono semplificate, in modo che gli eventi di manutenzione di tipi diversi abbiano lo stesso aspetto nella console Google Cloud . La maggior parte dei tipi di eventi di manutenzione pianificata si verifica tra le 22:00 e le 5:00 ora locale in cui si trova il dispositivo di rete. Ad esempio, se il dispositivo si trova in asia-south1, la manutenzione pianificata in genere viene eseguita tra le 22:00 e le 05:00 ora standard dell'India (UTC+5:30). Gli eventi di manutenzione pianificata non avvengono a intervalli regolari, ma in genere si verificano più volte all'anno.

Un tipo di evento di manutenzione pianificata, una migrazione fisica, si verifica dal lunedì al venerdì, dalle 9:00 alle 17:00 ora della costa orientale degli Stati Uniti.

Manutenzione non pianificata

Potrebbero verificarsi anche eventi di manutenzione di emergenza o non pianificati. Gli eventi di emergenza sono eventi irregolari e non pianificati che possono influire sulle connessioni Cloud Interconnect. Purtroppo, gli eventi di emergenza possono verificarsi in qualsiasi momento, senza preavviso. Google consiglia di creare topologie di rete ibride ad alta disponibilità per ridurre le interruzioni di rete causate da eventi di manutenzione di emergenza.

La capacità totale interessata da un evento di manutenzione non pianificata varia in base alla natura dell'evento. Potrebbe trattarsi fino al 100% della capacità di una o più connessioni Cloud Interconnect.

Manutenzione urgente

Gli eventi di manutenzione urgenti sono simili agli eventi di manutenzione pianificati, ma vengono pianificati con meno di 14 giorni di anticipo. Inoltre, influiscono fino al 100% della capacità totale di ciascuna delle tue connessioni Cloud Interconnect interessate.

Un singolo link in un dominio di disponibilità perimetrale non prevede alcun SLA. Per evitare la perdita di accesso ai tuoi servizi durante la manutenzione, assicurati di provisionare due link in domini di disponibilità perimetrale diversi. Per saperne di più, consulta Creare connessioni Cloud Interconnect ridondanti con capacità sufficiente.

Ricezione di notifiche relative agli eventi

Ricevi notifiche per eventi di manutenzione pianificati, non pianificati e urgenti.

Le notifiche per gli eventi di manutenzione pianificati vengono inviate almeno 14 giorni prima dell'evento all'indirizzo email indicato nel campo nocContactEmail dell'oggetto Cloud Interconnect e vengono visualizzate nel metodo API interconnects.get. Per saperne di più, vedi Assegnazione dei contatti per le notifiche degli eventi.

Durante eventi non pianificati o urgenti, potresti ricevere una notifica per un'interruzione, ma non avere tempo sufficiente per reindirizzare il traffico. Per ridurre le probabilità di interruzioni del traffico dovute a interruzioni di emergenza, consulta Best practice.

Gli eventi di manutenzione potrebbero non verificarsi come previsto. Inviamo notifiche aggiornate per gli eventi se un evento di manutenzione viene riprogrammato o annullato.

Le notifiche non vengono visualizzate nella console Google Cloud per gli utenti di Partner Interconnect.

Assegnazione di contatti per le notifiche di eventi

Cloud Interconnect invia una notifica ai proprietari del progetto e utilizza anche l'API Essential Contacts per inviare notifiche sugli eventi di manutenzione. Se non assegni un contatto tecnico a un progetto, le notifiche vengono inviate ai contatti di riserva, che si basano sui ruoli IAM.

Per assicurarti di ricevere una notifica corretta degli eventi di manutenzione, specifica almeno un contatto tecnico per qualsiasi progetto che ospita una connessione Cloud Interconnect o un collegamento VLAN.

Per saperne di più sull'assegnazione dei contatti tecnici per un progetto, vedi Gestione dei contatti per le notifiche.

Proprietà delle notifiche di eventi

Questa sezione si applica a Dedicated Interconnect, Cross-Cloud Interconnect e Cross-Site Interconnect.

Prima di un evento di manutenzione dell'infrastruttura pianificato, gli utenti ricevono le seguenti notifiche:

  • Un'email viene inviata a tutti i proprietari del progetto di connessione Cloud Interconnect non appena viene pianificata una manutenzione che ha un impatto.

  • Viene inviato un messaggio all'indirizzo elencato nel campo nocContactEmail dell'oggetto Cloud Interconnect. Puoi trovare e modificare questo oggetto nella console Google Cloud nella pagina dei dettagli di Cloud Interconnect oppure utilizzando il seguente comando Google Cloud CLI:

    gcloud compute interconnects describe my-interconnect

  • Viene inviata un'email a tutti i contatti tecnici elencati per il progetto che ospita la connessione Cloud Interconnect.

Durante un evento di manutenzione dell'infrastruttura non pianificato o urgente, gli utenti ricevono le seguenti notifiche:

  • Un'email viene inviata a tutti i proprietari del progetto di connessione Cloud Interconnect non appena viene pianificata una manutenzione che ha un impatto.

  • Viene inviato un messaggio all'indirizzo elencato nel campo nocContactEmail dell'oggetto Cloud Interconnect.

  • Viene inviata un'email a tutti i contatti tecnici elencati per il progetto che ospita la connessione Cloud Interconnect.

Notifiche di eventi Partner Interconnect

Prima di un evento di manutenzione dell'infrastruttura pianificato, gli utenti di Partner Interconnect ricevono le seguenti notifiche:

  • Viene inviata un'email a tutti i contatti tecnici per il progetto che ospita il collegamento VLAN.

  • Un'email viene inviata a tutti i proprietari del progetto che ospita il collegamento VLAN.

Stati delle interruzioni

Le email relative agli eventi inviate ai proprietari del progetto e ai contatti nocContactEmail includono una sezione intitolata "Stato interruzione". Di seguito vengono descritti i possibili stati di interruzione:

  • Aggiornato: un evento di manutenzione pianificato in precedenza che è stato aggiornato o ripianificato.

  • Superamento: un evento di manutenzione pianificato in precedenza che è in corso e che richiede più tempo del previsto per essere completato.

  • Completato: un evento di manutenzione completato.

  • Annullato: un evento di manutenzione precedentemente pianificato che è stato annullato.

  • Nuovo: un nuovo evento di manutenzione.

  • Nessuna modifica: un evento di manutenzione pianificato in precedenza che è ancora pianificato come previsto.

Visualizzare gli eventi di manutenzione

Seleziona una delle seguenti opzioni:

gcloud

Per visualizzare informazioni sulla tua connessione, inclusi gli eventi di manutenzione pianificati imminenti, esegui questo comando:

gcloud compute interconnects describe INTERCONNECT_NAME

Sostituisci INTERCONNECT_NAME con il nome di Cloud Interconnect.

L'output è simile al seguente. Cerca 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

Per elencare le informazioni sulla tua connessione, inclusi i prossimi eventi di manutenzione, utilizza interconnects.get:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto in cui si trova Cloud Interconnect

  • INTERCONNECT_NAME: il nome di Cloud Interconnect

L'output è simile al seguente:

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

Visualizzare gli eventi di manutenzione in Unified Maintenance

Puoi utilizzare la manutenzione unificata per visualizzare gli eventi di manutenzione dell'infrastruttura Cloud Interconnect e puoi configurarla per inviare avvisi e notifiche sugli eventi di manutenzione. Le notifiche non vengono visualizzate in Manutenzione unificata per gli utenti di Partner Interconnect.

Segui i passaggi nella pagina Configurare avvisi e notifiche, ma utilizza uno dei seguenti filtri di inclusione quando ti viene chiesto di crearne uno:

  • Questo filtro include solo le notifiche di manutenzione pianificata:

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

  • Questo filtro include solo le notifiche di manutenzione urgenti:

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

  • Questo filtro contiene solo notifiche di manutenzione non pianificata:

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

In alternativa, per visualizzare gli eventi di manutenzione con lo stato Pianificato, consulta Visualizzare le manutenzioni delle risorse utilizzando l'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"

Passaggi successivi