Eventi di manutenzione dell'infrastruttura

Questa guida descrive gli eventi di manutenzione dell'infrastruttura e il modo in cui possono influire sulle connessioni Cloud Interconnect.

Che cosa sono gli eventi di manutenzione dell'infrastruttura

Gli eventi di manutenzione dell'infrastruttura sono periodi in cui viene eseguita la manutenzione delle apparecchiature di rete, incluse quelle per Cloud Interconnect. Google Cloud Quando 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 Google Cloud console. La maggior parte dei tipi di eventi di manutenzione pianificata si verifica tra le 22:00 e le 05:00 ora locale del luogo in cui si trova il dispositivo di rete. Ad esempio, se il dispositivo si trova in asia-south1, la manutenzione pianificata in genere si verifica tra le 22:00 e le 05:00 ora standard indiana (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 09:00 alle 17:00 ora della costa orientale.

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 ibrida ad alta disponibilità per mitigare 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 di un massimo del 100% della capacità di una o più connessioni Cloud Interconnect.

Manutenzione urgente

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

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

Ricezione delle notifiche degli eventi

Riceverai notifiche per eventi di manutenzione pianificata, non pianificata e urgente.

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

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

Gli eventi di manutenzione potrebbero non verificarsi come previsto. Inviamo notifiche degli eventi aggiornate se un evento di manutenzione viene ripianificato o annullato.

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

Assegnare contatti per le notifiche degli eventi

Cloud Interconnect invia notifiche 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 la notifica corretta sugli 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 di contatti tecnici per un progetto, consulta Gestire i contatti per le notifiche.

Proprietà delle notifiche degli 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:

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

  • Viene inviata un'email all'indirizzo elencato nel campo nocContactEmail dell'oggetto Cloud Interconnect. Puoi trovare e modificare questo oggetto in the Google Cloud console nella pagina dei dettagli di Cloud Interconnect o 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:

Notifiche degli eventi di 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 del progetto che ospita il collegamento VLAN.

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

Stati di interruzione

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

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

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

  • Completato: un evento di manutenzione completato.

  • Annullato: un evento di manutenzione pianificato in precedenza che viene 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 le informazioni sulla connessione, inclusi gli eventi di manutenzione pianificata imminenti, esegui il comando seguente:

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 connessione, inclusi gli eventi di manutenzione imminenti, 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 Unified Maintenance per visualizzare gli eventi di manutenzione dell'infrastruttura Cloud Interconnect e configurarlo per inviare avvisi e notifiche sugli eventi di manutenzione. Le notifiche non vengono visualizzate in Unified Maintenance per gli utenti di Partner Interconnect.

Segui i passaggi nella pagina Configura 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 urgente:

    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 le 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