Questa pagina è stata tradotta dall'API Cloud Translation.

Trovare informazioni sulla risoluzione dei problemi di Ops Agent

Questo documento descrive le fonti di informazioni diagnostiche che puoi utilizzare per identificare i problemi di installazione o esecuzione di Ops Agent.

Verifica lo stato dell'agente utilizzando gcpdiag

Puoi usare gcpdiag per segnalare lo stato di Ops Agent su un singolo VM o l'intero parco risorse all'interno del progetto, a conferma che l'agente installato e invia attivamente log e metriche. gcpdiag può creare report di stato in diversi formati, tra cui CSV o JSON.

Di seguito viene mostrato un report sullo stato dell'agente a livello di parco risorse in formato CSV:

🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.

gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-1,failed,Ops Agent not installed on the VM,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-2,skipped,VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-3,skipped,VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-4,ok,"Ops Agent installed on the VM, and is successfully sending logs and metrics.",https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-5,ok,"Ops Agent installed on the VM, and is successfully sending logs and metrics.",https://gcpdiag.dev/rules/gce/ERR/2024_004

Lo strumento Google Cloud è stato creato dall'assistenza Google Cloud per aiutarti diagnosticare autonomamente i problemi comuni nel progetto Google Cloud, inclusi quelli relativi al Ops Agent. gcpdiag è uno strumento open source, non un servizio Google Cloud ufficiale ma è costantemente sviluppato e gestito dal team di assistenza di Google Cloud. Dai il tuo contributo o segnala problemi su GitHub.

Prima di iniziare

gcpdiag è integrato con Cloud Shell, quindi puoi eseguirlo senza è richiesta l'installazione. Per eseguire gcpdiag, devi prima soddisfare i seguenti requisiti prerequisiti:

Autorizzazione: utilizza gcpdiag credenziali predefinite dell'applicazione (ADC) in Cloud Shell.
Assicurati che le credenziali utilizzate con gcpdiag abbiano almeno i seguenti ruoli del progetto Google Cloud, in cui è in esecuzione Ops Agent:
- Visualizzatore (roles/viewer)
- Consumer utilizzo dei servizi (roles/serviceusage.serviceUsageConsumer)
API: per utilizzare gcpdiag in un progetto, devono essere abilitate le seguenti API:
- API Cloud Resource Manager: cloudresourcemanager.googleapis.com
- API Identity and Access Management: iam.googleapis.com
- API Cloud Logging: logging.googleapis.com
- Service Usage: serviceusage.googleapis.com
Per abilitare queste API, esegui questo comando in Cloud Shell oppure con un'altra riga di comando:
```
 gcloud --project=PROJECT_ID services enable \
   cloudresourcemanager.googleapis.com \
   iam.googleapis.com \
   logging.googleapis.com \
   serviceusage.googleapis.com
```
VM Manager: abilita VM Manager a livello gratuito per la tua istanza. Se hai installato Ops Agent durante la creazione di una VM o se un criterio di agente gestisce di Ops Agent sulle tue istanze VM, hai già soddisfatto i requisiti. per VM Manager.

Esegui gcpdiag

Il comando gcpdiag da utilizzare con Ops Agent abbia la seguente sintassi di base:

gcpdiag lint --project=PROJECT_ID [--name=INSTANCE_NAME] --show-skipped --include=gce/err/2024_004 [--output=[CSV|JSON]]

PROJECT_ID è l'ID del tuo progetto Google Cloud.
INSTANCE_NAME è il nome della tua VM Compute Engine. Utilizza l'opzione --name per eseguire query su una VM specifica. ometti l'opzione per eseguire query sull'intero parco risorse.
Utilizza l'opzione --output per salvare il report in un file in formato CSV o JSON. ometti l'opzione se non vuoi un file di output.

Il valore dell'opzione --include specifica una o più regole gcpdiag. gce/ERR/2024-004 è la regola per Ops Agent. Per ulteriori informazioni sulla sintassi del comando gcpdiag, consulta gcpdiag - Diagnostica per Google Cloud Platform.

Ad esempio, per generare un report a livello di parco risorse per il progetto "mio-progetto", esegui questo comando:

gcpdiag lint --project=my-project --show-skipped --include=gce/ERR/2024_004

L'output è simile al seguente:

🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
  - my-project/instance-1                                                 [FAIL] Ops Agent not installed on the VM
  - my-project/instance-2                                                 [FAIL] Ops Agent not installed on the VM
  - my-project/instance-3                                                 [SKIP] Unable to confirm Ops Agent installation
  VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.
  - my-project/instance-4                                            [FAIL] Ops Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
  Is Ops Agent sending logs? (Yes)  Is Ops Agent sending metrics? (No)
  - my-project/instance-5                                                 [FAIL] Ops Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
  Is Ops Agent sending logs? (No)   Is Ops Agent sending metrics? (No)
  - my-project/instance-6                                                 [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.
  - my-project/instance-7                                                 [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.

Generare un report per l'istanza "my-instance" nel progetto "mio-progetto", esegui questo comando:

gcpdiag lint  --project=my-project --name=my-instance --show-skipped --include=gce/err/2024_004

L'output è simile al seguente:

🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
  - my-project/my-instance   [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.

Se il comando gcpdiag non riesce e restituisce un output simile al seguente: verificare di aver soddisfatto tutti i prerequisiti per eseguire lo strumento.

WARNING:googleapiclient.http:Encountered 403 Forbidden with reason "PERMISSION_DENIED"
[ERROR]:can't access project my-project: Cloud Resource Manager API has not been used in project my-project before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project=my-project then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry..
[DEBUG]: An Http Error occurred whiles accessing projects.get

HttpError 403 when requesting https://cloudresourcemanager.googleapis.com/v3/projects/my-project?alt=json returned Cloud Resource Manager API has not been used in project my-project before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project=my-project then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry. Details: ...
[ERROR]:exiting program...
error getting project details

Interpreta l'output di gcpdiag

Questa sezione fornisce informazioni che ti aiutano a comprendere e utilizzare i report generate da gcpdiag.

Il comando gcpdiag genera report contenenti quanto segue: informazioni:

Un indicatore della regola gcpdiag con cui è stato richiamato il comando. Per Ops Agent, le informazioni sono le seguenti:
🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics
Un identificatore del risultato per una VM specifica con il formato PROJECT_ID/INSTANCE_ID. Per un report a livello di parco risorse, l'output contiene una voce per ogni VM. Per un report su VM singola, l'output contiene una singola voce.
Lo stato del controllo. Lo stato ha uno dei seguenti valori:
- OK
- FAIL
- SKIP
Una descrizione del valore dello stato.

Le seguenti sezioni forniscono ulteriori informazioni sui valori dello stato. e il loro significato.

Stato: `OK`

Lo stato OK indica che Ops Agent è in esecuzione su e l'invio di log e metriche dalla VM. Il report include seguente descrizione dello stato:
Ops Agent installed on the VM, and is successfully sending logs and metrics.

Stato: `FAIL`

Lo stato FAIL indica che Ops Agent non è installato, o non invia log e metriche dalla VM. La descrizione dello stato indica quale problema è stato rilevato:

Se Ops Agent non è installato, viene visualizzato il seguente stato. descrizione:
Ops Agent not installed on the VM
Se Ops Agent non invia sia i log sia le metriche dalla VM, viene visualizzata una descrizione dello stato simile alla seguente:
Agent is installed, but it's failing to send both logs and metrics to Google Cloud. Is Ops Agent sending logs? (Yes) Is Ops Agent sending metrics? (No)

Se Ops Agent non è installato, installalo. Se l'installazione non va a buon fine, potrebbe essere uno dei seguenti:

Alla VM non è associato un account di servizio. Per risolvere il problema, collega un account di servizio alla VM, quindi prova installazione di Ops Agent di nuovo.
La VM ha uno degli agenti legacy (l'agente Monitoring o l'agente Logging). è già installata. Per risolvere il problema, disinstalla gli agenti legacy, e poi prova installare Ops Agent di nuovo.

Se Ops Agent non invia i log o le metriche dalla VM, Utilizza i controlli di integrità dell'agente per gli errori all'ora di inizio per determinare e correggere il problema.

Stato: `SKIP`

Lo stato SKIP indica che gcpdiag non è riuscito a determinare se Ops Agent è installato sulla VM. Il report include quanto segue: descrizione dello stato:
Unable to confirm Ops Agent installation VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.

Per testare lo stato dell'agente, gcpdiag deve Gestore VM in esecuzione sulla tua VM. Per risolvere questo problema, installa il VM Manager gratuito della tua istanza. Dopo l'installazione, attendi 15 minuti e poi riprova eseguendo nuovamente il comando gcpdiag.

Controlli di integrità dell'agente

La versione 2.25.1 ha introdotto i controlli di integrità all'ora di inizio per Ops Agent. All'avvio, Ops Agent esegue una serie di controlli per verificare le condizioni che impediscono l'esecuzione corretta dell'agente. Se l'agente rileva una delle condizioni, registra un messaggio che descrive il problema. Ops Agent verifica quanto segue:

Problemi di connettività
Disponibilità di porte utilizzate dall'agente per generare report sulle metriche relative a se stesso
Problemi di autorizzazione
Disponibilità delle API utilizzate dall'agente per scrivere log o metriche
Un problema della routine di controllo di integrità stessa.

Per informazioni sull'individuazione degli errori all'ora di inizio, consulta Trova gli errori all'ora di inizio.

La versione 2.37.0 ha introdotto i controlli dell'integrità di runtime per Ops Agent. Questi errori vengono segnalati a Cloud Logging ed Error Reporting. Per informazioni sull'individuazione degli errori di runtime, Individua gli errori di runtime.

La versione 2.46.0 ha introdotto la Codice di LogPingOpsAgent. Questo codice non rappresenta un errore. Per ulteriori informazioni, vedi Verifica che la raccolta dei log sia andata a buon fine.

Nella tabella seguente sono elencati tutti i codici del controllo di integrità in ordine alfabetico. descrive il significato di ogni codice. Codici che terminano con la stringa Err indicano errori; altri codici sono informativi.

Codice per il controllo di integrità	Categoria	Significato	Suggerimento
`DLApiConnErr`	Connettività	Richiesta al sottodominio dei download, `dl.google.com`, non riuscita.	Controlla la connessione a internet e le regole del firewall. Per ulteriori informazioni, vedi Problemi di connettività di rete.
`FbMetricsPortErr`	Disponibilità porte	La porta 20202, necessaria per le metriche personali di Ops Agent, non è disponibile.	Verifica che la porta 20202 sia aperta. Per ulteriori informazioni, vedi La porta obbligatoria non è disponibile.
`HcFailureErr`	Generico	Si è verificato un errore interno della routine di controllo di integrità di Ops Agent.	Invia una richiesta di assistenza dalla console Google Cloud. Per ulteriori informazioni, vedi Richiesta di assistenza.
`LogApiConnErr`	Connettività	Richiesta all'API Logging non riuscita.	Controlla la connessione a internet e le regole del firewall. Per ulteriori informazioni, vedi Problemi di connettività di rete.
`LogApiDisabledErr`	API	L'API Logging è disabilitata nell'attuale progetto Google Cloud.	Abilita l'API Logging.
`LogApiPermissionErr`	Autorizzazione	Nell'account di servizio manca il ruolo Writer log (`roles/logging.logWriter`).	Concedi Ruolo Writer log all'account di servizio. Per ulteriori informazioni, vedi L'agente non dispone delle autorizzazioni API.
`LogApiScopeErr`	Autorizzazione	Nella VM manca https://www.googleapis.com/auth/logging.write l'ambito di accesso.	Aggiungi l'ambito https://www.googleapis.com/auth/logging.write alla VM. Per ulteriori informazioni, vedi Verifica gli ambiti di accesso.
`LogApiUnauthenticatedErr`	API	La VM attuale non ha potuto eseguire l'autenticazione nell'API Logging.	Verifica che i file delle credenziali, gli ambiti di accesso alle VM e le autorizzazioni siano impostati correttamente. Per ulteriori informazioni, vedi Autorizza Ops Agent.
`LogPingOpsAgent`		Un messaggio payload informativo scritto ogni 10 minuti per Log di `ops-agent-health`. Puoi utilizzare il log risultante per verificare che l'agente invii i log. Questo messaggio non è un errore.	Questo messaggio dovrebbe essere visualizzato ogni 10 minuti. Se il messaggio non appare per 20 minuti o più, è possibile che l'agente abbia ha riscontrato un problema. Per informazioni sulla risoluzione dei problemi, vedi Risolvi i problemi di Ops Agent.
`LogParseErr`	Runtime	Ops Agent non è riuscito ad analizzare uno o più log.	Controlla la configurazione di eventuali processori di logging che hai creato. Per ulteriori informazioni, consulta Errori di analisi dei log.
`LogPipeLineErr`	Runtime	La pipeline di logging di Ops Agent non è riuscita.	Verificare che l'agente abbia accesso ai file del buffer; verifica la presenza di un pieno e verifica che la configurazione di Ops Agent sia corretta. Per ulteriori informazioni, vedi Errori della pipeline.
`MetaApiConnErr`	Connettività	Richiesta al server G C E Metadata per l'esecuzione di query sugli ambiti di accesso alle VM, Etichette delle risorse ed token OAuth non riusciti.	Controlla la connessione a internet e le regole del firewall. Per ulteriori informazioni, vedi Problemi di connettività di rete.
`MonApiConnErr`	Connettività	Richiesta all'API Monitoring non riuscita.	Controlla la connessione a internet e le regole del firewall. Per ulteriori informazioni, vedi Problemi di connettività di rete.
`MonApiDisabledErr`	API	L'API Monitoring è disabilitata nell'attuale progetto Google Cloud.	Abilitare l'API Monitoring.
`MonApiPermissionErr`	Autorizzazione	Nell'account di servizio manca il ruolo Writer metriche Monitoring (`roles/monitoring.metricWriter`).	Concedi Ruolo Writer metriche Monitoring all'account di servizio. Per ulteriori informazioni, vedi L'agente non dispone delle autorizzazioni API.
`MonApiScopeErr`	Autorizzazione	Nella VM manca https://www.googleapis.com/auth/monitoring.write l'ambito di accesso.	Aggiungi l'ambito https://www.googleapis.com/auth/monitoring.write alla VM. Per ulteriori informazioni, vedi Verifica gli ambiti di accesso.
`MonApiUnauthenticatedErr`	API	La VM attuale non è riuscita ad autenticarsi con l'API Monitoring.	Verifica che i file delle credenziali, gli ambiti di accesso alle VM e le autorizzazioni siano impostati correttamente. Per ulteriori informazioni, vedi Autorizza Ops Agent.
`OtelMetricsPortErr`	Disponibilità porte	La porta 20201, necessaria per le metriche automatiche di Ops Agent, non è disponibile.	Verifica che la porta 20201 sia aperta. Per ulteriori informazioni, vedi Una porta obbligatoria non è disponibile.
`PacApiConnErr`	Connettività	Questo codice per il controllo di integrità non è affidabile. Questo codice è disabilitato in Ops Agent versione 2.46.1.	Esegui l'aggiornamento alla versione Ops Agent 2.46.1 o successiva.

Individuare gli errori relativi all'ora di inizio

A partire dalla versione 2.35.0, controllo di integrità vengono scritte nel log ops-agent-health dall'API Cloud Logging (le versioni 2.33.0, 2.34.0 utilizzano ops-agent-health-checks). Le stesse informazioni vengono scritte anche in un file health-checks.log, come segue:

Linux: /var/log/google-cloud-ops-agent/health-checks.log
Windows: C:\ProgramData\Google\Cloud Operations\Ops Agent\log\health-checks.log

Puoi anche visualizzare i messaggi relativi al controllo di integrità eseguendo una query sul del servizio Ops Agent come segue:

Su Linux, esegui questo comando:
```
   sudo systemctl status google-cloud-ops-agent"*"
   
```
Cerca messaggi come "[Ports Check] Risultato: PASS". Altri risultati includono "ERROR" e "NON SUPERATO".
Su Windows, utilizza il Visualizzatore eventi di Windows. Cerca "Informazioni", "Errore" o "Errore" messaggi associati al servizio google-cloud-ops-agent.

Dopo aver risolto gli eventuali problemi, devi riavvia l'agente. I controlli di integrità vengono eseguiti all'avvio dell'agente, quindi per eseguire devi riavviare l'agente.

Individuare gli errori di runtime

I controlli di integrità del runtime vengono segnalati sia a Cloud Logging che ed Error Reporting. Se l'agente non si è avviato, ma è riuscito a segnalare errori prima di non riuscire, potresti anche vedere segnalati errori relativi all'ora di inizio.

Per visualizzare gli errori di runtime da Ops Agent in Logging, procedi nel seguente modo: seguenti:

Nella console Google Cloud, vai alla pagina Esplora log:
Vai a Esplora log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Inserisci la seguente query e fai clic su Esegui query:
```
log_id("ops-agent-health")
```

Per visualizzare gli errori di runtime di Ops Agent in Error Reporting, procedi nel seguente modo:

Nella console Google Cloud, vai alla pagina Error Reporting:
Vai a Error Reporting.

Puoi trovare questa pagina anche utilizzando la barra di ricerca.
Per visualizzare gli errori di Ops Agent, filtra gli errori per Ops Agent.

Verifica la corretta raccolta dei log

La versione 2.46.0 di Ops Agent ha introdotto controllo di integrità LogPingOpsAgent informativo. Questo controllo scrive un messaggio informativo inviato al ops-agent-health ogni 10 minuti. Puoi utilizzare la presenza di questi messaggi per verificare che Ops Agent sia di scrivere i log in uno dei seguenti modi:

Cerca i messaggi ping nei log di una VM specifica utilizzando Esplora log.
Verificare il valore della metrica log_entry_count per una VM specifica utilizzando Esplora metriche.
Crea un criterio di avviso per inviare una notifica se una VM specifica non aggiorna . log_entry_count.

Se una di queste opzioni indica che i messaggi di log non vengono importati, puoi:

Verifica la presenza di codici di errore che indicano errori di avvio o errori di runtime.
Determina se Ops Agent è sia operativa.
Esegui lo script di diagnostica dell'agente.

Per controllare lo stato di Ops Agent su una VM specifica, è necessario l'ID istanza della VM. Per trovare l'ID istanza:

Nella console Google Cloud, vai alla pagina Istanze VM:
Vai a Istanze VM

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Compute Engine.
Fai clic sul nome di un'istanza VM.
Nella scheda Dettagli, individua la sezione Informazioni di base. L'ID istanza viene visualizzato come stringa numerica. Usa questa stringa per INSTANCE_ID nelle sezioni successive.

Cercare i messaggi utilizzando Esplora log

Per utilizzare Esplora log per cercare i messaggi ping nei log di una VM, procedi nel seguente modo:

Nella console Google Cloud, vai alla pagina Esplora log:
Vai a Esplora log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Per cercare messaggi ping da Ops Agent su una specifica istanza VM, inserisci la query seguente e sostituisci INSTANCE_ID con per una VM di Compute Engine, quindi fai clic su Esegui query:
```
resource.type="gce_instance"
resource.labels.instance_id="INSTANCE_ID"
log_id("ops-agent-health")
jsonPayload.code="LogPingOpsAgent"
    
```

Visualizza la metrica `log_entry_count`

Per utilizzare Metrics Explorer per verificare il valore della metrica log_entry_count per una VM, segui questi passaggi:

Nella console Google Cloud, vai alla Pagina Esplora metriche:
Vai a Esplora metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Nel campo Seleziona una metrica, segui questi passaggi:
1. Inserisci log entries.
2. In Tipo di risorsa, seleziona Istanza VM.
3. Per Categoria di metrica, seleziona Metriche basate su log.
4. Per Metrica, seleziona Voci di log.
5. Seleziona Applica.
Nel campo Filtro , aggiungi i seguenti filtri:
- Filtra in base all'ID istanza di una VM specifica:
  1. Seleziona l'etichetta della risorsa instance_id.
  2. Seleziona il criterio di confronto = (uguale a).
  3. Inserisci il INSTANCE_ID di una VM.
- Filtra per il log ops-agent-health:
  1. Seleziona l'etichetta della risorsa log.
  2. Seleziona il criterio di confronto = (uguale a).
  3. Seleziona il valore ops-agent-heath.

Crea un criterio di avviso per la metrica `log_entry_count`

Per creare un criterio di avviso che monitori il valore dell'attributo log_entry_count metrica per i ping di log da una VM specifica, procedi nel seguente modo:

Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Se non hai creato i canali di notifica e vuoi notificato, quindi fai clic Modifica canali di notifica e aggiungi i tuoi canali di notifica. Torna alla pagina Avvisi dopo aver aggiunto i canali.
Nella pagina Avvisi, seleziona Crea criterio.
Nel campo Seleziona una metrica, segui questi passaggi:
1. Inserisci log entries.
2. In Tipo di risorsa, seleziona Istanza VM.
3. Per Categoria di metrica, seleziona Metriche basate su log.
4. Per Metrica, seleziona Voci di log.
5. Seleziona Applica.
Nel campo Filtro , aggiungi i seguenti filtri:
- Filtra in base all'ID istanza di una VM specifica:
  1. Seleziona l'etichetta della risorsa instance_id.
  2. Seleziona il criterio di confronto = (uguale a).
  3. Inserisci il INSTANCE_ID di una VM.
- Filtra per il log ops-agent-health:
  1. Seleziona l'etichetta della risorsa log.
  2. Seleziona il criterio di confronto = (uguale a).
  3. Seleziona il valore ops-agent-heath.
Nella sezione Trasforma dati, seleziona quanto segue:
- Per il campo Finestra continua, seleziona 10 min. Per rilevare voci di log mancanti per un periodo più lungo, inserisci un valore più alto.
- Nel campo Funzione finestra temporale continua, seleziona delta.
Fai clic su Avanti.

Le impostazioni nella pagina Configura trigger di avviso determinano quando l'avviso viene attivato. Completa questa pagina con le impostazioni nel seguente.

Configura trigger di avviso pagina Campo	Valore
`Condition type`	`Threshold`
`Alert trigger`	`Any time series violates`
`Threshold position`	`Below threshold`
`Threshold value`	`1`
`Advanced Options: Retest window`	`No retest`

Fai clic su Avanti.
(Facoltativo) Per aggiungere notifiche al criterio di avviso, fai clic su Canali di notifica. Nella finestra di dialogo, seleziona una o più opzioni. canali di notifica dal menu e fai clic su OK.
(Facoltativo) Aggiorna la Durata della chiusura automatica degli incidenti. Questo campo determina quando Monitoring chiude gli incidenti assenza di dati statistici.
(Facoltativo) Fai clic su Documentazione, quindi aggiungi eventuali informazioni che desideri includere in un messaggio di notifica.
Fai clic su Nome avviso e inserisci un nome per il criterio di avviso.
Fai clic su Crea criterio.

Per ulteriori informazioni, vedi Criteri di avviso.

Strumento di diagnostica degli agenti per le VM

Lo strumento di diagnostica dell'agente raccoglie informazioni critiche di debug locale da le VM per tutti i seguenti agenti: Ops Agent, legacy Agente Logging e agente Monitoring legacy. La le informazioni di debug includono, ad esempio, informazioni sul progetto, sulle VM e sull'agente configurazione, log degli agenti, stato del servizio dell'agente, informazioni che solitamente richiede lavoro manuale. Lo strumento controlla anche l'ambiente VM locale assicurarsi che soddisfi determinati requisiti per il corretto funzionamento degli agenti, ad esempio ad esempio la connettività di rete e le autorizzazioni richieste.

Esegui l'agente quando invii una richiesta di assistenza a un cliente su una VM strumento di diagnostica e allega alla richiesta le informazioni raccolte. Queste informazioni riducono il tempo necessario per risolvere i problemi del tuo una richiesta di assistenza. Prima di allegare le informazioni alla richiesta di assistenza, oscurare informazioni sensibili come le password.

Lo strumento di diagnostica dell'agente deve essere eseguito dall'interno della VM, quindi prima di accedere alla VM tramite SSH. Il comando seguente recupera strumento di diagnostica dell'agente e lo esegue:

Linux

curl -sSO https://dl.google.com/cloudagents/diagnose-agents.sh
sudo bash diagnose-agents.sh

Windows

(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/diagnose-agents.ps1", "${env:UserProfile}\diagnose-agents.ps1")
Invoke-Expression "${env:UserProfile}\diagnose-agents.ps1"

Segui l'output dell'esecuzione dello script per individuare i file che includono lo script raccolte di informazioni. In genere puoi trovarli nel /var/tmp/google-agents su Linux e nella directory $env:LOCALAPPDATA/Temp su Windows, a meno che tu non abbia personalizzato la directory di output durante l'esecuzione dello script.

Per informazioni dettagliate, esamina lo script diagnose-agents.sh su Linux o Script diagnose-agents.ps1 su Windows.

Strumento di diagnostica dell'agente per i criteri di installazione automatica

Se si tenta di installare Ops Agent utilizzando un criterio di sistema operativo di Ops Agent non riesce, puoi utilizzare lo script di diagnostica descritto in questa sezione per il debug del machine learning. Ad esempio, potresti notare uno dei seguenti casi:

L'installazione di Ops Agent non riesce quando utilizzi Casella di controllo Installa Ops Agent per il monitoraggio e il logging per installare Ops Agent durante la creazione della VM.
Lo stato dell'agente nella dashboard delle istanze VM di Cloud Monitoring o la scheda Observability nella pagina dei dettagli di una VM di Compute Engine rimane nello stato In attesa per più di 10 minuti. Lo stato In attesa prolungato potrebbe indicare uno dei seguenti motivi:
- Problema nell'applicazione del criterio.
- Un problema con l'installazione effettiva di Ops Agent.
- Un problema di connettività tra la VM e Cloud Monitoring.
Per alcuni di questi problemi, lo strumento diagnostica dell'agente script e controlli di integrità potrebbe essere utile.

Per eseguire lo script di diagnostica dei criteri, esegui questi comandi:

curl -sSO https://dl.google.com/cloudagents/diagnose-ui-policies.sh
bash diagnose-ui-policies.sh VM_NAME VM_ZONE

Questo script mostra informazioni sulle VM interessate e sulle relative VM criteri di installazione.

Esegui l'agente quando invii una richiesta di assistenza a un cliente su una VM strumenti di diagnostica e allega alla richiesta le informazioni raccolte. Queste informazioni riducono il tempo necessario per risolvere i problemi del tuo una richiesta di assistenza. Prima di allegare le informazioni alla richiesta di assistenza, oscurare informazioni sensibili come le password.

Autolog degli agenti

Se l'agente non riesce a importare i log in Cloud Logging, potrebbe essere necessario I log dell'agente verranno esaminati localmente sulla VM per risolvere i problemi. Puoi utilizza anche la rotazione dei log per gestire i self log dell'agente.

Linux

Per esaminare gli autolog scritti in Journald, esegui questo comando:

journalctl -u google-cloud-ops-agent*

Per esaminare i self log scritti sul disco dal modulo di logging, esegui il seguente comando:

vim -M /var/log/google-cloud-ops-agent/subagents/logging-module.log

Windows

Per esaminare gli autolog scritti in Windows Event Logs, esegui questo comando :

Get-WinEvent -FilterHashtable @{ Logname='Application'; ProviderName='google-cloud-ops-agent*' } | Format-Table -AutoSize -Wrap

Per esaminare i self log scritti sul disco dal modulo di logging, esegui il seguente comando:

notepad "C:\ProgramData\Google\Cloud Operations\Ops Agent\log\logging-module.log"

ispezionare i log da Windows Service Control Manager per Ops Agent esegui questo comando:

Get-WinEvent -FilterHashtable @{ Logname='System'; ProviderName='Service Control Manager' } | Where-Object -Property Message -Match 'Google Cloud Ops Agent' | Format-Table -AutoSize -Wrap

Visualizza l'utilizzo e la diagnostica delle metriche in Cloud Monitoring

La pagina Gestione delle metriche di Cloud Monitoring fornisce informazioni che può aiutarti a controllare l'importo speso per le metriche addebitabili senza influire sull'osservabilità. La pagina Gestione delle metriche riporta le seguenti informazioni:

Volumi di importazione per la fatturazione basata sia su byte che su campioni, nelle varie metriche domini e per singole metriche.
Dati su etichette e cardinalità delle metriche.
Utilizzo di metriche nei criteri di avviso e nelle dashboard personalizzate.
Percentuale di errori di scrittura delle metriche.

Per visualizzare la pagina Gestione delle metriche, segui questi passaggi:

Nella console Google Cloud, vai alla Pagina Gestione delle metriche:
Vai a Gestione delle metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Nella barra degli strumenti, seleziona la finestra temporale. Per impostazione predefinita, La pagina Gestione delle metriche mostra informazioni sulle metriche raccolte. nel giorno precedente.

Per saperne di più sulla pagina Gestione delle metriche, consulta Visualizza e gestisci l'utilizzo delle metriche.