Strumento: get_alert_policy
Utilizza questo strumento come principale per ottenere informazioni su una specifica criterio di avviso. I criteri di avviso definiscono le condizioni in base alle quali vuoi ricevere una notifica in caso di problemi con i tuoi servizi. Ciò è utile per comprendere i dettagli di una configurazione di avviso specifica.
Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_alert_policy.
| Curl Request |
|---|
curl --location 'https://monitoring.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_alert_policy", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Schema di input
Il protocollo per la richiesta GetAlertPolicy.
GetAlertPolicyRequest
| Rappresentazione JSON |
|---|
{ "name": string } |
| Campi | |
|---|---|
name |
Obbligatorio. La criterio di avviso da recuperare. Il formato è: |
Schema di output
Una descrizione delle condizioni in cui un aspetto del sistema è considerato "non integro" e dei modi per comunicare questo stato a persone o servizi. Per una panoramica dei criteri di avviso, consulta la pagina Introduzione agli avvisi.
AlertPolicy
| Rappresentazione JSON |
|---|
{ "name": string, "displayName": string, "documentation": { object ( |
| Campi | |
|---|---|
name |
Identificatore. Obbligatorio se la policy esiste. Il nome della risorsa per questo criterio. Il formato è:
|
displayName |
Un nome breve o una frase utilizzati per identificare il criterio in dashboard, notifiche e incidenti. Per evitare confusione, non utilizzare lo stesso nome visualizzato per più criteri nello stesso progetto. Il nome è limitato a 512 caratteri Unicode. La convenzione per display_name di una PrometheusQueryLanguageCondition è "{nome gruppo di regole}/{nome avviso}", dove {nome gruppo di regole} e {nome avviso} devono essere presi dal file di configurazione Prometheus corrispondente. Questa convenzione non viene applicata. In ogni caso, display_name non è una chiave univoca di AlertPolicy. |
documentation |
Documentazione inclusa nelle notifiche e negli incidenti relativi a questa norma. La best practice prevede che la documentazione includa informazioni per aiutare i risponditori a comprendere, mitigare, riassegnare e correggere i problemi sottostanti rilevati dalla criterio di avviso. I canali di notifica con capacità limitata potrebbero non mostrare questa documentazione. |
userLabels |
Dati chiave/valore forniti dall'utente da utilizzare per organizzare e identificare gli oggetti Il campo può contenere fino a 64 voci. Ogni chiave e valore è limitato a 63 caratteri Unicode o 128 byte, a seconda di quale sia il limite inferiore. Le etichette e i valori possono contenere solo lettere minuscole, numeri, trattini bassi e trattini. Le chiavi devono iniziare con una lettera. Tieni presente che Prometheus {alert name} è un nome di etichetta Prometheus valido, mentre Prometheus {rule group} è una stringa UTF-8 senza limitazioni. Ciò significa che non possono essere archiviati così come sono nelle etichette utente, perché potrebbero contenere caratteri non consentiti nei valori delle etichette utente. Un oggetto contenente un elenco di coppie |
conditions[] |
Un elenco di condizioni per la policy. Le condizioni vengono combinate con AND o OR in base al campo |
combiner |
Come combinare i risultati di più condizioni per determinare se deve essere aperto un incidente. Se è presente |
enabled |
Indica se il criterio è attivato. In scrittura, l'interpretazione predefinita se non impostata è che il criterio è abilitato. In lettura, i client non devono fare alcuna ipotesi sullo stato se non è stato compilato. Il campo deve essere sempre compilato nelle operazioni List e Get, a meno che non sia stata specificata una proiezione del campo che lo rimuove. |
validity |
Descrizione in sola lettura del motivo per cui la criterio di avviso non è valida. Questo campo viene impostato solo quando la criterio di avviso non è valida. Una criterio di avviso non valida non genererà incidenti. |
notificationChannels[] |
Identifica i canali di notifica a cui devono essere inviate le notifiche quando vengono aperti o chiusi incidenti o quando si verificano nuove violazioni in un incidente già aperto. Ogni elemento di questo array corrisponde al campo |
creationRecord |
Un record di sola lettura della creazione della criterio di avviso. Se fornito in una chiamata per la creazione o l'aggiornamento, questo campo verrà ignorato. |
mutationRecord |
Un record di sola lettura della modifica più recente apportata al criterio di avviso. Se fornito in una chiamata per la creazione o l'aggiornamento, questo campo verrà ignorato. |
alertStrategy |
Controllo della modalità di notifica dei canali di notifica di questo criterio di avviso. |
severity |
Facoltativo. La gravità di una criterio di avviso indica l'importanza degli incidenti generati da tale policy. Il livello di gravità verrà visualizzato nella pagina dei dettagli dell'incidente e nelle notifiche. |
Documentazione
| Rappresentazione JSON |
|---|
{
"content": string,
"mimeType": string,
"subject": string,
"links": [
{
object ( |
| Campi | |
|---|---|
content |
Il corpo della documentazione, interpretato in base a |
mimeType |
Il formato del campo |
subject |
Facoltativo. L'oggetto della notifica. La riga dell'oggetto non può superare i 10.240 byte. Nelle notifiche generate da questa norma, i contenuti della riga dell'oggetto dopo l'espansione delle variabili verranno troncati a 255 byte o meno al più tardi al limite del carattere UTF-8. Il limite di 255 byte è consigliato in questo thread. Si tratta sia del limite imposto da alcuni prodotti di biglietteria di terze parti sia di una pratica comune definire i campi di testo nei database come VARCHAR(255). I contenuti dell'oggetto possono essere creati utilizzando variabili. Se questo campo è mancante o vuoto, verrà generata una riga dell'oggetto predefinita. |
links[] |
Facoltativo. Link a contenuti come playbook, repository e altre risorse. Questo campo può contenere fino a tre voci. |
Link
| Rappresentazione JSON |
|---|
{ "displayName": string, "url": string } |
| Campi | |
|---|---|
displayName |
Un nome visualizzato breve per il link. Il nome visualizzato non deve essere vuoto o superare i 63 caratteri. Esempio: "playbook". |
url |
L'URL di una pagina web. Un URL può essere creato come modello utilizzando variabili nel percorso o nei parametri di ricerca. La lunghezza totale di un URL non deve superare i 2083 caratteri prima e dopo l'espansione delle variabili. Esempio: "https://my_domain.com/playbook?name=${resource.name}" |
UserLabelsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
Condizione
| Rappresentazione JSON |
|---|
{ "name": string, "displayName": string, // Union field |
| Campi | |
|---|---|
name |
Obbligatorio se la condizione esiste. Il nome della risorsa univoco per questa condizione. Il formato è:
Quando chiami il metodo Quando chiami il metodo La best practice consiste nel conservare |
displayName |
Un nome breve o una frase utilizzati per identificare la condizione in dashboard, notifiche e incidenti. Per evitare confusione, non utilizzare lo stesso nome visualizzato per più condizioni nella stessa norma. |
Campo unione condition. Verrà specificato solo uno dei seguenti tipi di condizione. condition può essere solo uno dei seguenti tipi: |
|
conditionThreshold |
Una condizione che confronta una serie temporale con una soglia. |
conditionAbsent |
Una condizione che verifica che una serie temporale continui a ricevere nuovi punti dati. |
conditionMatchedLog |
Una condizione che verifica la presenza di messaggi di log che corrispondono a determinati vincoli. Se impostata, non possono essere presenti altre condizioni. |
conditionMonitoringQueryLanguage |
Una condizione che utilizza Monitoring Query Language per definire gli avvisi. |
conditionPrometheusQueryLanguage |
Una condizione che utilizza il linguaggio di query Prometheus per definire gli avvisi. |
conditionSql |
Una condizione che valuta periodicamente il risultato di una query SQL. |
MetricThreshold
| Rappresentazione JSON |
|---|
{ "filter": string, "aggregations": [ { object ( |
| Campi | |
|---|---|
filter |
Obbligatorio. Un filtro che identifica le serie temporali da confrontare con la soglia. Il filtro è simile a quello specificato nella richiesta |
aggregations[] |
Specifica l'allineamento dei punti dati nelle singole serie temporali, nonché la modalità di combinazione delle serie temporali recuperate (ad esempio quando si aggregano più stream su ogni risorsa in un unico stream per ogni risorsa o quando si aggregano stream in tutti i membri di un gruppo di risorse). Più aggregazioni vengono applicate nell'ordine specificato. Questo campo è simile a quello della richiesta |
denominatorFilter |
Un filtro che identifica una serie temporale da utilizzare come denominatore di un rapporto che verrà confrontato con la soglia. Se viene specificato un Il filtro deve specificare il tipo di metrica e, facoltativamente, può contenere limitazioni per il tipo di risorsa, le etichette delle risorse e le etichette delle metriche. Questo campo non può superare i 2048 caratteri Unicode di lunghezza. |
denominatorAggregations[] |
Specifica l'allineamento dei punti dati nelle singole serie temporali selezionate da Quando si calcolano i rapporti, i campi |
forecastOptions |
Quando questo campo è presente, la condizione |
comparison |
Il confronto da applicare tra le serie temporali (indicate da Al momento sono supportati solo |
thresholdValue |
Un valore con cui confrontare la serie temporale. |
duration |
Obbligatorio. Il periodo di tempo in cui una serie temporale deve violare la soglia per essere considerata non riuscita. Al momento sono supportati solo i valori che sono multipli di un minuto, ad esempio 0, 60, 120 o 300 secondi. Se viene fornito un valore non valido, verrà restituito un errore. Quando scegli una durata, è utile tenere presente la frequenza dei dati delle serie temporali sottostanti (che potrebbe essere influenzata anche da eventuali allineamenti specificati nel campo Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
trigger |
Il numero/la percentuale di serie temporali per cui il confronto deve essere valido affinché la condizione venga attivata. Se non specificata, la condizione viene attivata se il confronto è true per una qualsiasi delle serie temporali identificate da |
evaluationMissingData |
Un controllo delle condizioni che determina come vengono valutate le condizioni di soglia delle metriche quando i dati smettono di arrivare. Per utilizzare questo controllo, il valore del campo |
Aggregazione
| Rappresentazione JSON |
|---|
{ "alignmentPeriod": string, "perSeriesAligner": enum ( |
| Campi | |
|---|---|
alignmentPeriod |
Il valore deve essere di almeno 60 secondi. Se viene specificato un allineatore per serie diverso da Il valore massimo di Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
perSeriesAligner |
Un Non tutte le operazioni di allineamento possono essere applicate a tutte le serie temporali. Le scelte valide dipendono da Per eseguire la riduzione tra serie temporali, i dati delle serie temporali devono essere allineati. Se |
crossSeriesReducer |
L'operazione di riduzione da utilizzare per combinare le serie temporali in un'unica serie temporale, in cui il valore di ogni punto dati della serie risultante è una funzione di tutti i valori già allineati nelle serie temporali di input. Non tutte le operazioni di riduzione possono essere applicate a tutte le serie temporali. Le scelte valide dipendono da Per eseguire la riduzione delle serie temporali incrociate, i dati delle serie temporali devono prima essere allineati (vedi |
groupByFields[] |
Il set di campi da conservare quando viene specificato |
Durata
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni |
nanos |
Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo |
ForecastOptions
| Rappresentazione JSON |
|---|
{ "forecastHorizon": string } |
| Campi | |
|---|---|
forecastHorizon |
Obbligatorio. Il periodo di tempo futuro per prevedere se una serie temporale violerà la soglia. Se il valore previsto viola la soglia e la violazione viene osservata in tutte le previsioni effettuate per il Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
Trigger
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione type. Un tipo di attivatore. type può essere solo uno dei seguenti tipi: |
|
count |
Il numero assoluto di serie temporali che devono non superare il predicato affinché la condizione venga attivata. |
percent |
La percentuale di serie temporali che non devono soddisfare il predicato affinché la condizione venga attivata. |
MetricAbsence
| Rappresentazione JSON |
|---|
{ "filter": string, "aggregations": [ { object ( |
| Campi | |
|---|---|
filter |
Obbligatorio. Un filtro che identifica le serie temporali da confrontare con la soglia. Il filtro è simile a quello specificato nella richiesta |
aggregations[] |
Specifica l'allineamento dei punti dati nelle singole serie temporali, nonché la modalità di combinazione delle serie temporali recuperate (ad esempio quando si aggregano più stream su ogni risorsa in un unico stream per ogni risorsa o quando si aggregano stream in tutti i membri di un gruppo di risorse). Più aggregazioni vengono applicate nell'ordine specificato. Questo campo è simile a quello della richiesta |
duration |
Obbligatorio. Il periodo di tempo durante il quale una serie temporale deve non segnalare nuovi dati per essere considerata in errore. Il valore minimo di questo campo è 120 secondi. Sono supportati valori più grandi che sono multipli di un minuto, ad esempio 240 o 300 secondi. Se viene fornito un valore non valido, verrà restituito un errore. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
trigger |
Il numero/la percentuale di serie temporali per cui il confronto deve essere valido affinché la condizione venga attivata. Se non specificata, la condizione verrà attivata se il confronto è vero per una qualsiasi delle serie temporali identificate da |
LogMatch
| Rappresentazione JSON |
|---|
{ "filter": string, "labelExtractors": { string: string, ... } } |
| Campi | |
|---|---|
filter |
Obbligatorio. Un filtro basato sui log. Per informazioni su come deve essere costruito questo filtro, consulta Query avanzate dei log. |
labelExtractors |
Facoltativo. Una mappa da una chiave di etichetta a un'espressione di estrazione, che viene utilizzata per estrarre il valore di questa chiave di etichetta. Ogni voce di questa mappa è una specifica per l'estrazione dei dati dalle voci di log che corrispondono a Per la sintassi e gli esempi, consulta la documentazione sulle metrica basata su log Un oggetto contenente un elenco di coppie |
LabelExtractorsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
MonitoringQueryLanguageCondition
| Rappresentazione JSON |
|---|
{ "query": string, "duration": string, "trigger": { object ( |
| Campi | |
|---|---|
query |
Query Monitoring Query Language che restituisce un flusso booleano. |
duration |
Facoltativo. Il periodo di tempo in cui una serie temporale deve violare la soglia per essere considerata non riuscita. Al momento sono supportati solo i valori che sono multipli di un minuto, ad esempio 0, 60, 120 o 300 secondi. Se viene fornito un valore non valido, verrà restituito un errore. Quando scegli una durata, è utile tenere presente la frequenza dei dati delle serie temporali sottostanti (che potrebbe essere influenzata anche da eventuali allineamenti specificati nel campo Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
trigger |
Il numero/la percentuale di serie temporali per cui il confronto deve essere valido affinché la condizione venga attivata. Se non specificata, la condizione viene attivata se il confronto è true per una qualsiasi delle serie temporali identificate da |
evaluationMissingData |
Un controllo delle condizioni che determina come vengono valutate le condizioni di soglia delle metriche quando i dati smettono di arrivare. |
PrometheusQueryLanguageCondition
| Rappresentazione JSON |
|---|
{ "query": string, "duration": string, "evaluationInterval": string, "labels": { string: string, ... }, "ruleGroup": string, "alertRule": string, "disableMetricValidation": boolean } |
| Campi | |
|---|---|
query |
Obbligatorio. L'espressione PromQL da valutare. A ogni ciclo di valutazione, questa espressione viene valutata all'ora corrente e tutte le serie temporali risultanti diventano avvisi in attesa/attivi. Questo campo non deve essere vuoto. |
duration |
Facoltativo. Gli avvisi vengono considerati attivati dopo che la loro espressione PromQL è stata valutata come "true" per il periodo di tempo specificato. Gli avvisi la cui espressione PromQL non è stata valutata come "true" per un periodo di tempo sufficiente sono considerati in attesa. Deve essere una durata non negativa o non essere presente. Questo campo è facoltativo. Il valore predefinito è zero. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
evaluationInterval |
Facoltativo. La frequenza con cui deve essere valutata questa regola. Deve essere un multiplo positivo di 30 secondi o non essere presente. Questo campo è facoltativo. Il valore predefinito è 30 secondi. Se questa PrometheusQueryLanguageCondition è stata generata da una regola di avviso di Prometheus, questo valore deve essere preso dal gruppo di regole contenitore. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
labels |
Facoltativo. Etichette da aggiungere o sovrascrivere nel risultato della query PromQL. I nomi delle etichette devono essere validi. I valori delle etichette possono essere creati come modelli utilizzando le variabili. Gli unici nomi di variabili disponibili sono i nomi delle etichette nel risultato PromQL, inclusi "__name__" e "value". "labels" può essere vuoto. Un oggetto contenente un elenco di coppie |
ruleGroup |
Facoltativo. Il nome del gruppo di regole di questo avviso nel file di configurazione Prometheus corrispondente. Alcuni strumenti esterni potrebbero richiedere che questo campo venga compilato correttamente per fare riferimento al file di configurazione Prometheus originale. Il nome del gruppo di regole e il nome dell'avviso sono necessari per aggiornare le AlertPolicies pertinenti nel caso in cui la definizione del gruppo di regole cambi in futuro. Questo campo è facoltativo. Se questo campo non è vuoto, deve contenere una stringa UTF-8 valida. Questo campo non può superare i 2048 caratteri Unicode di lunghezza. |
alertRule |
Facoltativo. Il nome della regola di avviso di questo avviso nel file di configurazione di Prometheus corrispondente. Alcuni strumenti esterni potrebbero richiedere che questo campo venga compilato correttamente per fare riferimento al file di configurazione Prometheus originale. Il nome del gruppo di regole e il nome dell'avviso sono necessari per aggiornare le AlertPolicies pertinenti nel caso in cui la definizione del gruppo di regole cambi in futuro. Questo campo è facoltativo. Se questo campo non è vuoto, deve essere un nome di etichetta Prometheus valido. Questo campo non può superare i 2048 caratteri Unicode di lunghezza. |
disableMetricValidation |
Facoltativo. Indica se disattivare la convalida dell'esistenza della metrica per questa condizione. Ciò consente di definire criteri di avviso per metriche che non esistono ancora, migliorando i flussi di lavoro avanzati dei clienti, ad esempio la configurazione di criteri di avviso utilizzando Terraform. Gli utenti con il ruolo |
LabelsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
SqlCondition
| Rappresentazione JSON |
|---|
{ "query": string, // Union field |
| Campi | |
|---|---|
query |
Obbligatorio. La query SQL di analisi dei log da eseguire, come stringa. La query deve rispettare la forma richiesta. In particolare, la query non deve tentare di filtrare l'input in base all'ora. Verrà applicato automaticamente un filtro all'input in modo che la query riceva tutte le righe ricevute dall'ultima esecuzione. Ad esempio, la seguente query estrae tutte le voci di log contenenti una richiesta HTTP: |
Campo unione schedule. La pianificazione indica la frequenza con cui deve essere eseguita la query. schedule può essere solo uno dei seguenti tipi: |
|
minutes |
Pianifica l'esecuzione della query ogni tot minuti. |
hourly |
Pianifica l'esecuzione della query ogni tot ore. |
daily |
Pianifica l'esecuzione della query ogni tot giorni. |
Campo unione evaluate. Il test da eseguire sul set di risultati SQL. evaluate può essere solo uno dei seguenti tipi: |
|
rowCountTest |
Verifica il conteggio delle righe rispetto a una soglia. |
booleanTest |
Testa il valore booleano nella colonna indicata. |
Minuti
| Rappresentazione JSON |
|---|
{ "periodicity": integer } |
| Campi | |
|---|---|
periodicity |
Obbligatorio. Numero di minuti tra le corse. L'intervallo deve essere maggiore o uguale a 5 minuti e minore o uguale a 1440 minuti. |
Ogni ora
| Rappresentazione JSON |
|---|
{ "periodicity": integer, // Union field |
| Campi | |
|---|---|
periodicity |
Obbligatorio. Il numero di ore tra le corse. Deve essere maggiore o uguale a 1 ora e minore o uguale a 48 ore. |
Campo unione
|
|
minuteOffset |
Facoltativo. Il numero di minuti dopo l'ora (in UTC) per eseguire la query. Deve essere maggiore o uguale a 0 minuti e minore o uguale a 59 minuti. Se non viene specificato, viene utilizzato un offset arbitrario. |
Ogni giorno
| Rappresentazione JSON |
|---|
{
"periodicity": integer,
"executionTime": {
object ( |
| Campi | |
|---|---|
periodicity |
Obbligatorio. Il numero di giorni tra le corse. Deve essere maggiore o uguale a 1 giorno e minore o uguale a 31 giorni. |
executionTime |
Facoltativo. L'ora del giorno (in UTC) in cui deve essere eseguita la query. Se non viene specificato, il server sceglie un orario arbitrario del giorno ed esegue la query alla stessa ora ogni giorno. |
TimeOfDay
| Rappresentazione JSON |
|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
| Campi | |
|---|---|
hours |
Ore di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività. |
minutes |
Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59. |
seconds |
Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere minore o uguale a 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari. |
nanos |
Frazioni di secondi, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999. |
RowCountTest
| Rappresentazione JSON |
|---|
{
"comparison": enum ( |
| Campi | |
|---|---|
comparison |
Obbligatorio. Il confronto da applicare tra il numero di righe restituite dalla query e la soglia. |
threshold |
Obbligatorio. Il valore con cui confrontare il conteggio delle righe. |
BooleanTest
| Rappresentazione JSON |
|---|
{ "column": string } |
| Campi | |
|---|---|
column |
Obbligatorio. Il nome della colonna contenente il valore booleano. Se il valore in una riga è NULL, la riga viene ignorata. |
BoolValue
| Rappresentazione JSON |
|---|
{ "value": boolean } |
| Campi | |
|---|---|
value |
Il valore booleano. |
Stato
| Rappresentazione JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| Campi | |
|---|---|
code |
Il codice di stato, che deve essere un valore enum di |
message |
Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo |
details[] |
Un elenco di messaggi contenenti i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi da utilizzare per le API. Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo |
Qualsiasi
| Rappresentazione JSON |
|---|
{ "typeUrl": string, "value": string } |
| Campi | |
|---|---|
typeUrl |
Identifica il tipo di messaggio Protobuf serializzato con un riferimento URI costituito da un prefisso che termina con una barra e il nome del tipo completo. Esempio: type.googleapis.com/google.protobuf.StringValue Questa stringa deve contenere almeno un carattere Il prefisso è arbitrario e le implementazioni di Protobuf devono semplicemente rimuovere tutto fino all'ultimo Tutte le stringhe URL di tipo devono essere riferimenti URI validi con l'ulteriore limitazione (per il formato di testo) che il contenuto del riferimento deve essere costituito solo da caratteri alfanumerici, sequenze di escape codificate in percentuale e caratteri del seguente insieme (senza includere gli apici inversi esterni): Nella progettazione originale di |
value |
Contiene una serializzazione Protobuf del tipo descritto da type_url. Una stringa con codifica in base64. |
MutationRecord
| Rappresentazione JSON |
|---|
{ "mutateTime": string, "mutatedBy": string } |
| Campi | |
|---|---|
mutateTime |
Quando è stata eseguita la modifica. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
mutatedBy |
L'indirizzo email dell'utente che apporta la modifica. |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi del tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z). |
nanos |
Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
AlertStrategy
| Rappresentazione JSON |
|---|
{ "notificationRateLimit": { object ( |
| Campi | |
|---|---|
notificationRateLimit |
Obbligatorio per i criteri di avviso basati su log, ovvero i criteri con una condizione Questo limite non viene implementato per le policy di avviso che non hanno una condizione LogMatch. |
notificationPrompts[] |
Per le policy di avviso basate su log, il prompt di notifica è sempre [OPENED]. Per i criteri di avviso non basati su log, i prompt di notifica possono essere [OPENED] o [OPENED, CLOSED]. |
autoClose |
Se una criterio di avviso attiva non ha dati per questo periodo di tempo, tutti gli incidenti aperti verranno chiusi Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
notificationChannelStrategy[] |
Controlla come verranno inviate le notifiche, canale per canale. |
NotificationRateLimit
| Rappresentazione JSON |
|---|
{ "period": string } |
| Campi | |
|---|---|
period |
Non più di una notifica per Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
NotificationChannelStrategy
| Rappresentazione JSON |
|---|
{ "notificationChannelNames": [ string ], "renotifyInterval": string } |
| Campi | |
|---|---|
notificationChannelNames[] |
Il nome completo della risorsa REST per i canali di notifica a cui si applicano queste impostazioni. Ciascuno di questi corrisponde al campo nome di uno degli oggetti NotificationChannel a cui viene fatto riferimento nel campo notification_channels di questo AlertPolicy. Il formato è: |
renotifyInterval |
La frequenza con cui inviare notifiche di promemoria per gli incidenti aperti. Il valore deve essere compreso tra 30 minuti e 24 ore. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
Allineatore
Aligner specifica l'operazione che verrà applicata ai punti dati in ogni periodo di allineamento di una serie temporale. Ad eccezione di ALIGN_NONE, che specifica che non deve essere applicata alcuna operazione, ogni operazione di allineamento sostituisce l'insieme di valori dei dati in ogni periodo di allineamento con un singolo valore: il risultato dell'applicazione dell'operazione ai valori dei dati. Una serie temporale allineata ha un singolo valore di dati alla fine di ogni alignment_period.
Un'operazione di allineamento può modificare anche il tipo di dati dei valori. Ad esempio, se applichi un'operazione di conteggio ai valori booleani, i dati value_type nella serie temporale originale sono BOOLEAN, ma value_type nel risultato allineato è INT64.
| Enum | |
|---|---|
ALIGN_NONE |
Nessun allineamento. Vengono restituiti i dati non elaborati. Non valido se viene richiesta una riduzione tra serie. Il value_type del risultato è uguale al value_type dell'input. |
ALIGN_DELTA |
Allinea e converti in Questo allineamento è valido per le metriche |
ALIGN_RATE |
Allinea e converti in una frequenza. Il risultato viene calcolato come Questo allineatore è valido per le metriche Se per "tasso" intendi "variazione percentuale", utilizza invece l'allineatore |
ALIGN_INTERPOLATE |
Allinea per interpolazione tra punti adiacenti intorno al confine del periodo allineamento. Questo allineatore è valido per GAUGE metriche con valori numerici. Il value_type del risultato allineato è uguale al value_type dell'input. |
ALIGN_NEXT_OLDER |
Allinea spostando il punto dati più recente prima della fine del periodo di allineamento al confine della fine del periodo di allineamento. Questo allineatore è valido per GAUGE metriche. Il value_type del risultato allineato è uguale al value_type dell'input. |
ALIGN_MIN |
Allinea le serie temporali restituendo il valore minimo in ogni periodo allineamento. Questo allineatore è valido per le metriche GAUGE e DELTA con valori numerici. Il value_type del risultato allineato è uguale al value_type dell'input. |
ALIGN_MAX |
Allinea le serie temporali restituendo il valore massimo in ogni periodo allineamento. Questo allineatore è valido per le metriche GAUGE e DELTA con valori numerici. Il value_type del risultato allineato è uguale al value_type dell'input. |
ALIGN_MEAN |
Allinea la serie temporale restituendo il valore medio in ogni periodo allineamento. Questo allineatore è valido per le metriche GAUGE e DELTA con valori numerici. Il value_type del risultato allineato è DOUBLE. |
ALIGN_COUNT |
Allinea la serie temporale restituendo il numero di valori in ogni periodo allineamento. Questo allineatore è valido per le metriche GAUGE e DELTA con valori numerici o booleani. Il value_type del risultato allineato è INT64. |
ALIGN_SUM |
Allinea la serie temporale restituendo la somma dei valori in ogni periodo allineamento. Questo allineatore è valido per le metriche GAUGE e DELTA con valori numerici e di distribuzione. Il value_type del risultato allineato è uguale al value_type dell'input. |
ALIGN_STDDEV |
Allinea la serie temporale restituendo la deviazione standard dei valori in ogni periodo allineamento. Questo allineatore è valido per le metriche GAUGE e DELTA con valori numerici. Il value_type dell'output è DOUBLE. |
ALIGN_COUNT_TRUE |
Allinea la serie temporale restituendo il numero di valori True in ogni periodo allineamento. Questo allineatore è valido per GAUGE metriche con valori booleani. Il value_type dell'output è INT64. |
ALIGN_COUNT_FALSE |
Allinea la serie temporale restituendo il numero di valori False in ogni periodo allineamento. Questo allineatore è valido per GAUGE metriche con valori booleani. Il value_type dell'output è INT64. |
ALIGN_FRACTION_TRUE |
Allinea la serie temporale restituendo il rapporto tra il numero di valori True e il numero totale di valori in ogni periodo allineamento. Questo allineatore è valido per GAUGE metriche con valori booleani. Il valore di output è compreso nell'intervallo [0,0, 1,0] e ha value_type DOUBLE. |
ALIGN_PERCENTILE_99 |
Allinea le serie temporali utilizzando l'aggregazione percentile. Il punto dati risultante in ogni periodo di allineamento è il 99° percentile di tutti i punti dati del periodo. Questo allineatore è valido per le metriche GAUGE e DELTA con valori di distribuzione. L'output è una metrica GAUGE con value_type DOUBLE. |
ALIGN_PERCENTILE_95 |
Allinea le serie temporali utilizzando l'aggregazione percentile. Il punto dati risultante in ogni periodo allineamento è il 95° percentile di tutti i punti dati del periodo. Questo allineatore è valido per le metriche GAUGE e DELTA con valori di distribuzione. L'output è una metrica GAUGE con value_type DOUBLE. |
ALIGN_PERCENTILE_50 |
Allinea le serie temporali utilizzando l'aggregazione percentile. Il punto dati risultante in ogni periodo di allineamento è il 50° percentile di tutti i punti dati del periodo. Questo allineatore è valido per le metriche GAUGE e DELTA con valori di distribuzione. L'output è una metrica GAUGE con value_type DOUBLE. |
ALIGN_PERCENTILE_05 |
Allinea le serie temporali utilizzando l'aggregazione percentile. Il punto dati risultante in ogni periodo di allineamento è il 5° percentile di tutti i punti dati del periodo. Questo allineatore è valido per le metriche GAUGE e DELTA con valori di distribuzione. L'output è una metrica GAUGE con value_type DOUBLE. |
ALIGN_PERCENT_CHANGE |
Allinea e converti in una variazione percentuale. Questo allineatore è valido per le metriche Se i valori di Prima del calcolo precedente, viene calcolata una media mobile di 10 minuti in ogni punto del periodo di allineamento per uniformare la metrica ed evitare falsi positivi dovuti a picchi di breve durata. La media mobile è applicabile solo ai dati i cui valori sono |
Riduttore
Un'operazione di riduzione descrive come aggregare i punti dati di più serie temporali in un'unica serie temporale, in cui il valore di ogni punto dati della serie risultante è una funzione di tutti i valori già allineati nelle serie temporali di input.
| Enum | |
|---|---|
REDUCE_NONE |
Nessuna riduzione delle serie temporali. Viene restituito l'output di Aligner. |
REDUCE_MEAN |
Riduce calcolando il valore medio nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE con valori numerici o di distribuzione. Il value_type dell'output è DOUBLE. |
REDUCE_MIN |
Riduzione calcolando il valore minimo nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE con valori numerici. Il value_type dell'output è uguale al value_type dell'input. |
REDUCE_MAX |
Riduzione calcolando il valore massimo nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE con valori numerici. Il value_type dell'output è uguale al value_type dell'input. |
REDUCE_SUM |
Riduce calcolando la somma delle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE con valori numerici e di distribuzione. Il value_type dell'output è uguale al value_type dell'input. |
REDUCE_STDDEV |
Riduce calcolando la deviazione standard tra le serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE con valori numerici o di distribuzione. Il value_type dell'output è DOUBLE. |
REDUCE_COUNT |
Riduzione calcolando il numero di punti dati nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE di value_type numeriche, booleane, di distribuzione e stringa. Il value_type dell'output è INT64. |
REDUCE_COUNT_TRUE |
Riduzione calcolando il numero di punti dati con valore True nelle serie temporali per ogni periodo allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE del valore booleano value_type. Il value_type dell'output è INT64. |
REDUCE_COUNT_FALSE |
Riduzione calcolando il numero di punti dati con valore False nelle serie temporali per ogni periodo allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE del valore booleano value_type. Il value_type dell'output è INT64. |
REDUCE_FRACTION_TRUE |
Riduzione calcolando il rapporto tra il numero di punti dati con valore True e il numero totale di punti dati per ogni periodo allineamento. Questo riduttore è valido per le metriche DELTA e GAUGE del valore booleano value_type. Il valore di output è compreso nell'intervallo [0,0, 1,0] e ha value_type DOUBLE. |
REDUCE_PERCENTILE_99 |
Riduzione tramite il calcolo del 99° percentile dei punti dati nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche GAUGE e DELTA di tipo numerico e di distribuzione. Il valore dell'output è DOUBLE. |
REDUCE_PERCENTILE_95 |
Riduzione tramite il calcolo del 95° percentile dei punti dati nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche GAUGE e DELTA di tipo numerico e di distribuzione. Il valore dell'output è DOUBLE. |
REDUCE_PERCENTILE_50 |
Riduzione tramite il calcolo del 50° percentile dei punti dati nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche GAUGE e DELTA di tipo numerico e di distribuzione. Il valore dell'output è DOUBLE. |
REDUCE_PERCENTILE_05 |
Riduzione tramite il calcolo del 5° percentile dei punti dati nelle serie temporali per ogni periodo di allineamento. Questo riduttore è valido per le metriche GAUGE e DELTA di tipo numerico e di distribuzione. Il valore dell'output è DOUBLE. |
ComparisonType
Specifica una relazione di ordinamento su due argomenti, denominati left e right.
| Enum | |
|---|---|
COMPARISON_UNSPECIFIED |
Non è specificata alcuna relazione di ordinamento. |
COMPARISON_GT |
True se l'argomento a sinistra è maggiore di quello a destra. |
COMPARISON_GE |
Vero se l'argomento a sinistra è maggiore o uguale a quello a destra. |
COMPARISON_LT |
Vero se l'argomento a sinistra è minore di quello a destra. |
COMPARISON_LE |
Vero se l'argomento a sinistra è minore o uguale a quello a destra. |
COMPARISON_EQ |
True se l'argomento a sinistra è uguale a quello a destra. |
COMPARISON_NE |
True se l'argomento a sinistra non è uguale a quello a destra. |
EvaluationMissingData
Un controllo delle condizioni che determina come vengono valutate le condizioni di soglia delle metriche quando i dati smettono di arrivare. Questo controllo non influisce sui criteri di assenza di metriche.
| Enum | |
|---|---|
EVALUATION_MISSING_DATA_UNSPECIFIED |
Un'opzione di dati mancanti per la valutazione non specificata. Equivalente a EVALUATION_MISSING_DATA_NO_OP. |
EVALUATION_MISSING_DATA_INACTIVE |
Se non ci sono dati per valutare la condizione, valuta la condizione come false. |
EVALUATION_MISSING_DATA_ACTIVE |
Se non sono presenti dati per valutare la condizione, valuta la condizione come true. |
EVALUATION_MISSING_DATA_NO_OP |
Non valutare la condizione in base a un valore se non sono presenti dati. |
ConditionCombinerType
Operatori per combinare le condizioni.
| Enum | |
|---|---|
COMBINE_UNSPECIFIED |
Un combinatore non specificato. |
AND |
Combina le condizioni utilizzando l'operatore logico AND. Un incidente viene creato solo se tutte le condizioni sono soddisfatte contemporaneamente. Questo combinatore è soddisfatto se tutte le condizioni sono soddisfatte, anche se lo sono su risorse completamente diverse. |
OR |
Combina le condizioni utilizzando l'operatore logico OR. Viene creato un incidente se è soddisfatta una delle condizioni elencate. |
AND_WITH_MATCHING_RESOURCE |
Combina le condizioni utilizzando l'operatore logico AND, ma a differenza della normale opzione AND, viene creato un incidente solo se tutte le condizioni vengono soddisfatte contemporaneamente su almeno una risorsa. |
NotificationPrompt
Controlla quando verranno inviate le notifiche.
| Enum | |
|---|---|
NOTIFICATION_PROMPT_UNSPECIFIED |
Nessuna strategia specificata. Trattato come errore. |
OPENED |
Invia una notifica all'apertura di un incidente. |
CLOSED |
Invia una notifica quando un incidente viene chiuso. |
Gravità
Un'enumerazione del possibile livello di gravità per una criterio di avviso.
| Enum | |
|---|---|
SEVERITY_UNSPECIFIED |
Non è specificata alcuna gravità. Questo è il valore predefinito. |
CRITICAL |
Questo è il livello di gravità più alto. Utilizza questa opzione se il problema potrebbe causare danni o tempi di inattività significativi. |
ERROR |
Questo è il livello di gravità medio. Utilizza questa opzione se il problema potrebbe causare danni minori o tempi di inattività. |
WARNING |
Questo è il livello di gravità più basso. Utilizza questo livello se il problema non causa danni o tempi di inattività, ma potrebbe potenzialmente portare a un problema in futuro. |
Annotazioni dello strumento
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento di mondo aperto: ❌