Monitorare l'integrità composita

Questa pagina mostra come monitorare l'integrità dei servizi pubblicati che utilizzano l'integrità composita. Puoi:

  • Monitorare gli stati di integrità attuali: controlla lo stato di integrità in tempo reale di un servizio pubblicato o di un singolo servizio di backend.
  • Visualizzare i log per le transizioni dello stato di integrità: utilizza Cloud Logging per visualizzare le voci di log che registrano le modifiche degli stati di integrità per le risorse monitorate.

Monitori i servizi pubblicati tramite i controlli di integrità compositi associati e i singoli servizi di backend tramite le origini di integrità associate. I consumatori di servizi possono visualizzare i log per i NEG Private Service Connect che si connettono ai servizi pubblicati che utilizzano l'integrità composita.

L'integrità composita utilizza i seguenti stati per rappresentare l'integrità dei servizi pubblicati e dei servizi di backend.

Stato di integrità Risorsa monitorata Descrizione
HEALTHY Origine integrità Il servizio di backend associato è integro come definito dalla relativa policy di aggregazione dell'integrità.
Controllo di integrità composito Il servizio pubblicato è integro perché ognuna delle origini di integrità associate è integra.
NEG Private Service Connect Il servizio pubblicato associato è integro come definito dal controllo di integrità composito del produttore.
UNHEALTHY Origine integrità Il servizio di backend non soddisfa i criteri definiti dalla relativa policy di aggregazione dell'integrità.
Controllo di integrità composito Il servizio pubblicato non è integro perché una o più delle origini di integrità associate non sono integre.
NEG Private Service Connect Il servizio pubblicato associato non è integro come definito dal controllo di integrità composito del produttore. Questo stato può attivare il failover tra regioni.
UNKNOWN Origine integrità Lo stato di integrità non è ancora disponibile. Si tratta di uno stato temporaneo che si verifica quando le risorse vengono create o configurate di recente.
Controllo di integrità composito Nessuna origine di integrità associata non è integra, ma una o più origini di integrità sono sconosciute.
NEG Private Service Connect Lo stato di integrità del servizio pubblicato associato non è ancora disponibile.

Prima di iniziare

Devi configurare l'integrità composita prima di poterla utilizzare per monitorare l'integrità dei servizi pubblicati.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per monitorare l'integrità composita, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

  • Controlla lo stato di integrità delle origini di integrità o dei controlli di integrità compositi: Visualizzatore Compute (roles/compute.viewer)
  • Visualizza la registrazione dell'integrità composita: Visualizzatore log (roles/logging.viewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Controllare lo stato di integrità di una singola origine di integrità

Questa sezione mostra come recuperare le seguenti informazioni su un'origine di integrità:

  • Lo stato di integrità complessivo
  • Il numero di endpoint integri rispetto al numero totale di endpoint in ogni gruppo di istanze o NEG associato al servizio di backend dell'origine di integrità

Se l'origine di integrità è associata al servizio di backend di un bilanciatore del carico di rete passthrough interno con più regole di forwarding, lo stato di integrità viene calcolato in modo indipendente per ciascuna delle regole di forwarding del bilanciatore del carico. In questo caso, i dettagli dello stato di integrità includono un campo forwardingRule per identificare la regola di forwarding in fase di valutazione.

Console

  1. Nella Google Cloud console, vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Origini integrità.

  3. Fai clic sul nome dell'origine di integrità che vuoi visualizzare.

  4. Per visualizzare ulteriori dettagli, nella sezione Stato di integrità, fai clic sulla freccia expander accanto a l servizio di backend che vuoi visualizzare. Se vengono visualizzate le regole di forwarding, fai clic sulla freccia di espansione accanto a una regola di forwarding per visualizzare lo stato dei backend associati.

gcloud

Utilizza il comando gcloud compute health-sources get-health.

gcloud compute health-sources get-health HEALTH_SOURCE \
    --region=REGION

Sostituisci quanto segue:

  • HEALTH_SOURCE: il nome dell'origine di integrità
  • REGION: la regione dell'origine di integrità

API

Invia una richiesta al regionHealthSources.getHealth metodo.

Metodo HTTP e URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE/getHealth

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • REGION: la regione dell'origine di integrità
  • HEALTH_SOURCE: il nome dell'origine di integrità

Controllare lo stato di integrità di un controllo di integrità composito

Questa sezione mostra come controllare lo stato di integrità di un controllo di integrità composito, incluse le seguenti informazioni:

  • Lo stato di integrità complessivo del servizio pubblicato regionale monitorato

  • Il singolo stato di integrità di ogni origine di integrità associata al controllo di integrità composito

Console

  1. Nella Google Cloud console, vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic sul nome del controllo di integrità composito che vuoi visualizzare.

  3. Per visualizzare ulteriori dettagli, nella sezione Stato di integrità, fai clic sulla freccia di espansione accanto a il controllo di integrità composito che vuoi visualizzare.

gcloud

Utilizza il comando gcloud compute composite-health-checks get-health.

gcloud compute composite-health-checks get-health COMPOSITE_CHECK_NAME \
    --region=REGION

Sostituisci quanto segue:

  • COMPOSITE_CHECK_NAME: il nome del controllo di integrità composito
  • REGION: la regione del controllo di integrità composito

API

Invia una richiesta al regionCompositeHealthChecks.getHealth metodo.

Metodo HTTP e URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_CHECK_NAME/getHealth

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • REGION: la regione del controllo di integrità composito
  • COMPOSITE_CHECK_NAME: il nome del controllo di integrità composito

Visualizzare i log di integrità composita

Puoi utilizzare Cloud Logging per monitorare le modifiche degli stati di integrità. Questi log vengono generati ogni volta che lo stato di integrità cambia (ad esempio, da HEALTHY a UNHEALTHY).

La registrazione è abilitata per impostazione predefinita per le origini di integrità, i controlli di integrità compositi e i NEG Private Service Connect che si connettono ai servizi pubblicati configurati per utilizzare l'integrità composita.

Per saperne di più su come eseguire query e analizzare i dati di log, consulta Analizzare i log utilizzando Esplora log e Analisi dell'osservabilità.

Console

Per visualizzare i log di integrità composita:

  1. Nella Google Cloud console, vai alla pagina Esplora log.

    Vai a Esplora log

  2. Se non vedi il campo dell'editor di query nel riquadro Query, fai clic sul pulsante di attivazione/disattivazione Mostra query.

  3. Nel campo dell'editor di query:

    • Per visualizzare i log per le risorse del produttore (origini di integrità e controlli di integrità compositi), inserisci la seguente query:

      logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fcompositehealth"

    • Per visualizzare i log per le risorse del consumatore (NEG Private Service Connect connessi ai servizi pubblicati che utilizzano i controlli di integrità compositi), inserisci la seguente query:

      logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fservicehealthchecks"

    Sostituisci PROJECT_ID con l'ID progetto.

  4. Fai clic su Esegui query.