Questo documento illustra l'utilizzo dell'API Cloud Monitoring per creare, modificare, eliminare, elencare e ottenere criteri di avviso basati su metriche in modo programmatico. Gli esempi mostrano come utilizzare Google Cloud CLI e le librerie client. Questi contenuti non si applicano ai criteri di avviso basati su log. Per informazioni sui criteri di avviso basati su log, vedi Monitorare i log.
Queste attività possono essere eseguite anche utilizzando la console Google Cloud . Per maggiori informazioni, consulta i seguenti documenti:
- Crea criteri di avviso basati su soglie delle metriche utilizzando la console Google Cloud
- Gestisci i criteri di avviso utilizzando la console Google Cloud
Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
Informazioni sui criteri di avviso
Un criterio di avviso è rappresentato da un oggetto AlertPolicy
, che descrive un insieme di condizioni che indicano uno stato potenzialmente non integro nel tuo sistema. I criteri di avviso fanno riferimento
ai canali di notifica, che ti consentono di specificare come vuoi essere informato
dell'attivazione di un criterio di avviso.
Ogni criterio di avviso appartiene a un progetto di definizione dell'ambito di un ambito delle metriche. Ogni
progetto può contenere fino a 500 criteri.
Per le chiamate API, devi fornire un "ID progetto"; utilizza l'ID del progetto di definizione dell'ambito di un ambito delle metriche come valore. In questi esempi,
l'ID del progetto di definizione dell'ambito di un ambito delle metriche è a-gcp-project
.
La risorsa AlertPolicy
supporta cinque operazioni:
- Creazione di nuove norme
- Eliminazione delle policy esistenti
- Recupero di norme specifiche
- Recupero di tutti i criteri
- Modifica delle norme esistenti
I criteri di avviso possono essere espressi in JSON o YAML, il che ti consente di registrare i criteri nei file e di utilizzare i file per eseguire il backup e il ripristino dei criteri. Con Google Cloud CLI, puoi creare policy da file in entrambi i formati. Con l'API REST, puoi creare criteri dai file JSON. Consulta Criteri di esempio per una selezione di criteri di avviso in formato JSON.
I seguenti esempi utilizzano l'interfaccia gcloud
e l'API
per illustrare questi casi d'uso di base. Gli esempi di API sono estratti
da un programma di esempio che utilizza l'API per implementare un sistema di backup e ripristino
per i criteri di avviso. Esempi più completi sono mostrati in Esempio: backup e ripristino.
Prima di iniziare
Prima di scrivere codice per l'API, devi:
- Acquisire familiarità con i concetti generali e la terminologia utilizzati con i criteri di avviso. Per maggiori informazioni, consulta la Panoramica degli avvisi.
- Assicurati che l'API Cloud Monitoring sia abilitata all'uso. Per ulteriori informazioni, consulta la sezione Abilitazione dell'API.
- Se prevedi di utilizzare le librerie client, installale per le lingue che vuoi utilizzare. Per maggiori dettagli, consulta la sezione Librerie client. Il supporto delle API per gli avvisi è disponibile solo per C#, Go, Java, Node.js e Python.
Se prevedi di utilizzare Google Cloud CLI, installala. Tuttavia, se utilizzi Cloud Shell, Google Cloud CLI è già installata.
Qui sono forniti anche esempi che utilizzano l'interfaccia
gcloud
. Tieni presente che tutti gli esempi digcloud
presuppongono che il progetto attuale sia già stato impostato come target (gcloud config set project [PROJECT_ID]
), pertanto le invocazioni omettono il flag--project
esplicito. L'ID del progetto corrente negli esempi èa-gcp-project
. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
-
Per ottenere le autorizzazioni necessarie per creare e modificare i criteri di avviso utilizzando l'API Cloud Monitoring, chiedi all'amministratore di concederti il ruolo IAM Monitoring AlertPolicy Editor (
roles/monitoring.alertPolicyEditor
) nel progetto. 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.
Per informazioni dettagliate sui ruoli IAM per Monitoring, consulta Controllare l'accesso con Identity and Access Management.
Progetta la tua applicazione in modo da eseguire chiamate API Cloud Monitoring single-thread che modificano lo stato di un criterio di avviso in un progettoGoogle Cloud . Ad esempio, chiamate API a thread singolo che creano, aggiornano o eliminano un criterio di avviso.
Crea un criterio di avviso
Per creare un criterio di avviso in un progetto, utilizza il metodo alertPolicies.create
. Per informazioni su come richiamare questo metodo, sui relativi parametri e sui dati di risposta, consulta la pagina di riferimento alertPolicies.create
.
Puoi creare criteri da file JSON o YAML.
L'interfaccia a riga di comando di Google Cloud accetta questi file come argomenti e puoi leggere i file JSON in modo programmatico, convertirli in oggetti AlertPolicy
e creare policy a partire da questi utilizzando il metodo alertPolicies.create
. Se hai un file di configurazione Prometheus JSON o YAML con una regola di avviso, l'interfaccia alla gcloud CLI può eseguirne la migrazione a una policy di avviso di Cloud Monitoring con una condizione PromQL. Per maggiori informazioni, consulta la pagina
Eseguire la migrazione di regole di avviso e destinatari da Prometheus.
Gli esempi seguenti illustrano la creazione di criteri di avviso, ma non descrivono come creare un file JSON o YAML che descriva un criterio di avviso. Gli esempi, invece, presuppongono l'esistenza di un file in formato JSON e mostrano come effettuare la chiamata API. Per esempi di file JSON, consulta Criteri di esempio. Per informazioni generali sul monitoraggio dei rapporti tra le metriche, consulta Rapporti tra le metriche.
gcloud
Per creare un criterio di avviso in un progetto, utilizza il comando gcloud alpha monitoring
policies create
. L'esempio seguente crea un criterio di avviso in
a-gcp-project
dal file rising-cpu-usage.json
:
gcloud alpha monitoring policies create --policy-from-file="rising-cpu-usage.json"
In caso di esito positivo, questo comando restituisce il nome del nuovo criterio, ad esempio:
Created alert policy [projects/a-gcp-project/alertPolicies/12669073143329903307].
Il file rising-cpu-usage.json
contiene il JSON per un criterio con
il nome visualizzato "Tasso di variazione elevato della CPU". Per informazioni dettagliate su questo criterio, consulta
Criterio sul tasso di variazione.
Per saperne di più, consulta il riferimento gcloud alpha monitoring policies create
.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
L'oggetto AlertPolicy
creato avrà campi aggiuntivi.
Il criterio stesso avrà i campi name
, creationRecord
e
mutationRecord
. Inoltre, a ogni condizione delle norme viene assegnato anche un name
.
Questi campi non possono essere modificati esternamente, quindi non è necessario impostarli
quando crei un criterio. Nessuno degli esempi JSON utilizzati per la creazione
dei criteri li include, ma se i criteri creati a partire da questi vengono recuperati dopo
la creazione, i campi saranno presenti.
Elenca e ottieni criteri di avviso
Per recuperare un elenco dei criteri in un progetto, utilizza il metodo
alertPolicies.list
.
Utilizza questo metodo per recuperare i criteri e applicare un'azione a ciascuno di
essi, ad esempio il backup. Questo metodo supporta anche le opzioni
filter
e orderBy
per limitare e ordinare i risultati;
vedi Ordinamento e filtro.
Se stai cercando una norma specifica e ne conosci il nome,
puoi utilizzare il metodo alertPolicies.get
per recuperare solo quella norma. Il nome di un criterio è il valore del campo name
, non displayName
, nell'oggetto AlertPolicy
. Il nome di
una norma ha il formato projects/[PROJECT_ID]/alertPolicies/[POLICY_ID]
,
ad esempio:
projects/a-gcp-project/alertPolicies/12669073143329903307
gcloud
Per elencare tutte le policy di avviso in un progetto, utilizza il comando gcloud alpha monitoring
policies list
:
gcloud alpha monitoring policies list
In caso di esito positivo, il comando list
fornisce un elenco di tutti i criteri nel progetto specificato, formattato come YAML. Ad esempio, il
criterio con il nome visualizzato "Tasso di variazione della CPU elevato"
nel progetto a-gcp-project
è elencato in questo modo,
tra gli altri criteri elencati:
---
combiner: OR
conditions:
- conditionThreshold:
aggregations:
- alignmentPeriod: 900s
perSeriesAligner: ALIGN_PERCENT_CHANGE
comparison: COMPARISON_GT
duration: 180s
filter: metric.type="compute.googleapis.com/instance/cpu/utilization" AND resource.type="gce_instance"
thresholdValue: 0.5
trigger:
count: 1
displayName: CPU usage is increasing at a high rate
name: projects/a-gcp-project/alertPolicies/12669073143329903307/conditions/12669073143329903008
creationRecord:
mutateTime: '2018-03-26T18:52:39.363601689Z'
mutatedBy: [USER@DOMAIN]
displayName: High CPU rate of change
enabled: true
mutationRecord:
mutateTime: '2018-03-26T18:52:39.363601689Z'
mutatedBy: [USER@DOMAIN]
name: projects/a-gcp-project/alertPolicies/12669073143329903307
---
Per elencare una singola criterio di avviso, utilizza invece gcloud alpha monitoring policies
describe
e specifica il nome della policy. Ad esempio, questo
comando restituisce solo l'elenco riportato sopra:
gcloud alpha monitoring policies describe projects/a-gcp-project/alertPolicies/12669073143329903307
Per saperne di più, consulta i riferimenti gcloud alpha monitoring policies list
e describe
. Il comando describe
corrisponde al metodo
alertPolicies.get
nell'API.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Eliminare un criterio di avviso
Per eliminare una policy da un progetto, utilizza il metodo
alertPolicies.delete
e fornisci il nome della
criterio di avviso da eliminare.
gcloud
Per eliminare un criterio di avviso, utilizza gcloud alpha monitoring policies
delete
e specifica il nome del criterio da eliminare. Ad esempio, il
comando seguente elimina il
criterio con il nome visualizzato "Tasso di variazione della CPU elevato":
gcloud alpha monitoring policies delete projects/a-gcp-project/alertPolicies/12669073143329903307
Per saperne di più, consulta il riferimento gcloud alpha monitoring policies delete
.
Modificare un criterio di avviso
Per modificare una criterio di avviso, utilizza il metodo
alertPolicies.patch
(nell'API REST).
Altre implementazioni dell'API e la chiamata dell'interfaccia gcloud
chiamano update
anziché patch
.
Un'operazione di aggiornamento può sostituire completamente la policy esistente o modificare
un sottoinsieme di campi. Un'operazione di aggiornamento accetta un nuovo oggetto AlertPolicy
e
una maschera dei campi facoltativa.
Se viene specificata una maschera di campo, qualsiasi campo elencato nella maschera di campo viene aggiornato con il valore nella policy fornita. Se la norma fornita non include un campo menzionato nella maschera del campo, questo campo viene cancellato e impostato sul valore predefinito. Qualsiasi campo non elencato nella maschera mantiene il valore precedente.
Se non viene specificata alcuna maschera di campo, le norme esistenti vengono sostituite da quelle fornite, ma il nome (projects/[PROJECT_ID]/alertPolicies/[POLICY_ID]
) viene riutilizzato. Tutte le condizioni nel nuovo criterio che hanno valori name
che includono
un CONDITION_ID
manterranno questi nomi. In caso contrario, vengono creati nuovi nomi di condizioni e norme.
Quando utilizzi la riga di comando gcloud
per aggiornare le norme, i flag della riga di comando
anziché una maschera di campo vengono utilizzati per specificare i campi da aggiornare.
Per i dettagli, consulta la gcloud alpha monitoring policies update
.
Puoi utilizzare le etichette per associare una criterio di avviso a un'applicazione App Hub. Per ulteriori informazioni, consulta Come associare un criterio di avviso a un'applicazione App Hub.
Attivare o disattivare un criterio di avviso
Per attivare o disattivare un criterio, modifica il valore del campo booleano
enabled
nell'oggetto AlertPolicy
. Tieni presente che dopo l'attivazione
di un criterio, questo può comunque essere attivato dai dati raccolti mentre era disattivato.
gcloud
Per disattivare un criterio di avviso, utilizza il comando gcloud alpha monitoring policies update
e fornisci il flag --no-enabled
. Il seguente comando disattiva il criterio di avviso "Tasso di variazione elevato della CPU" nel progetto a-gcp-project
:
gcloud alpha monitoring policies update projects/a-gcp-project/alertPolicies/12669073143329903307 --no-enabled
Per attivare la policy, utilizza lo stesso comando e fornisci il flag --enabled
.
Per saperne di più, consulta il riferimento gcloud alpha monitoring policies update
. Il comando update
corrisponde al metodo alertPolicies.patch
nell'API REST.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Aggiornare i canali di notifica in un criterio di avviso
Puoi anche aggiornare i canali di notifica a cui fa riferimento un criterio di avviso. I criteri di avviso fanno riferimento ai canali di notifica per nome. I canali devono esistere prima di poter essere utilizzati in un criterio di avviso.
Puoi creare e gestire i canali di notifica in modo programmatico utilizzando le risorse NotificationChannel
e NotificationChannelDescriptors
.
Questi esempi in questa sezione presuppongono che questi canali esistano già e gli utilizzi di queste API compaiono anche negli esempi programmatici.
Per ulteriori informazioni sugli oggetti dei canali di notifica, vedi Creare e gestire i canali di notifica tramite API.
gcloud
Per modificare i canali di notifica in un criterio di avviso, utilizza il comando
gcloud alpha monitoring policies update
. Esistono diversi
flag relativi ai canali di notifica, che ti consentono di rimuovere, sostituire e aggiungere nuovi canali di notifica.
Ad esempio, la policy con il nome visualizzato "Tasso di variazione elevato della CPU" nel progetto a-gcp-project è stata creata senza canali di notifica.
Per aggiungere un canale di notifica a questo criterio, utilizza il comando gcloud alpha monitoring
policies update
e specifica il canale da aggiungere con il flag --add-notification-channels
:
gcloud alpha monitoring policies update projects/a-gcp-project/alertPolicies/12669073143329903307 \
--add-notification-channels="projects/a-gcp-project/notificationChannels/1355376463305411567"
Per saperne di più, consulta il riferimento gcloud alpha monitoring policies update
. Il comando update
corrisponde al metodo alertPolicies.patch
nell'API REST.
Il canale di notifica aggiunto qui deve già esistere. Per saperne di più, consulta la sezione Creare un canale di notifica.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Modificare la documentazione in una criterio di avviso
Un criterio può includere la documentazione inclusa negli incidenti e nelle notifiche associati al criterio. Utilizza questo campo per includere informazioni per aiutare i rispondenti a comprendere e gestire il problema indicato dai criteri di avviso. La documentazione è inclusa nelle notifiche via email e nei tipi di notifiche che lo consentono; altri tipi di canali potrebbero ometterla.
gcloud
Per aggiungere la documentazione a una norma o sostituire quella esistente, utilizza il comandogcloud alpha monitoring policies update
e fornisci il flag
--documentation-format="text/markdown"
(l'unico formato supportato)
e il flag --documentation
(per inserire il valore dalla riga di comando)
o il flag --documentation-from-file
(per leggere il valore da un file).
Ad esempio, la policy con il nome visualizzato "High CPU rate of change" nel progetto a-gcp-project è stata creata senza documentazione.
Il comando seguente imposta il campo documentation
nel criterio specificato sui contenuti del file cpu-usage-doc.md
:
gcloud alpha monitoring policies update projects/a-gcp-project/alertPolicies/12669073143329903307 \
--documentation-format="text/markdown" \
--documentation-from-file="cpu-usage-doc.md"
Per saperne di più, consulta il riferimento gcloud alpha monitoring policies update
. Il comando update
corrisponde al metodo alertPolicies.patch
nell'API REST.
Aggiungere un criterio di avviso a una dashboard
Per visualizzare un riepilogo di una criterio di avviso a una sola condizione nella dashboard personalizzata,
aggiungi un widget AlertChart
alla dashboard.
Utilizzi il
metodo dashboards.create
per una nuova dashboard e il
metodo dashboards.patch
per una dashboard esistente.
Se specifichi un criterio di avviso con più condizioni, il widget AlertChart
non visualizzerà i dati.
Per informazioni dettagliate sull'utilizzo di questi metodi API, consulta Creare e gestire dashboard tramite l'API.
Esempio: backup e ripristino
Tutti gli esempi di API mostrati provengono da un'applicazione più grande che può eseguire il backup delle norme di avviso in un progetto in un file e può ripristinare le norme, possibilmente in un altro progetto. Se i progetti utilizzati per il backup e il ripristino sono diversi, l'applicazione esporta e importa effettivamente le norme da un progetto all'altro.
Questa sezione mostra il codice per il backup e il ripristino nel contesto anziché come insieme di piccoli estratti isolati.
Eseguire il backup delle policy
L'operazione di backup è semplice. L'insieme di criteri di avviso e l'insieme di canali di notifica in ogni progetto vengono raccolti e salvati in un archivio esterno in formato JSON.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ripristino delle policy di cui è stato eseguito il backup
La procedura di ripristino è più complessa del backup originale. Puoi eseguire il ripristino nel progetto di cui hai eseguito il backup originariamente. Puoi anche eseguire il ripristino in un progetto diverso, fornendo di fatto l'importazione delle norme di avviso.
Se il ripristino viene eseguito nello stesso progetto, i canali o le norme esistenti vengono aggiornati se esistono ancora. In caso contrario, vengono ricreati. I campi di sola lettura, come i record di creazione e mutazione, nei criteri di cui è stato eseguito il backup vengono cancellati dal processo di ripristino prima che vengano ricreati criteri e notifiche.
Puoi utilizzare una norma salvata in un progetto per creare una norma nuova o simile in un altro progetto. Tuttavia, devi prima apportare le seguenti modifiche a una copia della policy salvata:
- Rimuovi i seguenti campi da tutti i canali di notifica:
name
verificationStatus
- Crea canali di notifica prima di fare riferimento ai canali nelle norme di avviso (hai bisogno dei nuovi identificatori di canale).
- Rimuovi i seguenti campi da tutti i criteri di avviso che stai ricreando:
name
condition.name
creationRecord
mutationRecord
Se la norma viene ricreata in un nuovo progetto, i nomi di tutte le condizioni nelle norme di cui è stato eseguito il backup vengono cancellati insieme ai record di creazione e mutazione.
Inoltre, quando un canale di notifica viene ricreato in un progetto diverso, riceve un nome diverso, quindi la procedura di ripristino deve mappare i nomi dei canali nelle norme di avviso di cui è stato eseguito il backup con i nuovi nomi e sostituire i vecchi nomi con quelli nuovi.
Oltre ai nomi dei canali di notifica, il valore del campo
verificationStatus
non può essere impostato quando il canale viene creato o
aggiornato, quindi viene utilizzato un valore sentinella, unspecified
. Dopo che i canali sono stati ripristinati in un nuovo progetto, devono essere verificati in modo esplicito.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Avvisi e Google Cloud CLI
Nell'interfaccia a riga di comando di Google Cloud, il gruppo di comandi per la gestione dei criteri di avviso e
dei canali di notifica è monitoring
, che è in versione alpha.
Il gruppo monitoring
è disponibile nel componente alpha
.
ovvero, tutti questi comandi inizieranno con:
gcloud alpha monitoring
Per verificare se è installato il componente alpha
, esegui questo comando:
gcloud components list
Se non hai installato il componente alpha
, esegui questo comando per
installarlo:
gcloud components install alpha
Se hai il componente alpha
, controlla il gruppo monitoring
eseguendo questo comando:
gcloud alpha monitoring --help
Se il gruppo monitoring
non è incluso, Google Cloud CLI ti chiederà di
aggiungerlo:
You do not currently have this command group installed.
[...]
Do you want to continue (Y/n)? y