Strumento: list_metric_descriptors
Utilizza questo strumento principale per scoprire i tipi di metriche disponibili in un progetto Google Cloud. Questo è un buon primo passo per capire quali dati sono disponibili per il monitoraggio e la creazione di dashboard o avvisi.
Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP list_metric_descriptors.
| Richiesta curl |
|---|
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": "list_metric_descriptors", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Schema di input
La richiesta ListMetricDescriptors.
ListMetricDescriptorsRequest
| Rappresentazione JSON |
|---|
{ "name": string, "filter": string, "pageSize": integer, "pageToken": string, "activeOnly": boolean } |
| Campi | |
|---|---|
name |
Obbligatorio. Il progetto su cui eseguire la richiesta. Il formato è: |
filter |
Facoltativo. Se questo campo è vuoto, vengono restituiti tutti i descrittori di metriche personalizzati e definiti dal sistema. In caso contrario, il filtro specifica quali descrittori di metriche devono essere restituiti. Ad esempio, il seguente filtro corrisponde a tutte le metriche personalizzate: |
pageSize |
Facoltativo. Un numero positivo che rappresenta il numero massimo di risultati da restituire. Il valore predefinito e massimo è 10.000. Se viene inviato un valore page_size <= 0 o > 10.000, verranno restituiti al massimo 10.000 risultati. |
pageToken |
Facoltativo. Se questo campo non è vuoto, deve contenere il valore |
activeOnly |
Facoltativo. Se è true, nella risposta verranno inclusi solo i tipi di metriche e risorsa monitorata che dispongono di dati recenti (entro circa 25 ore). Se un descrittore della metrica enumera i tipi di risorsa monitorata, nel descrittore della metrica restituito verranno inclusi solo i tipi di risorsa monitorata per i quali il tipo di metrica dispone di dati recenti e, se nessuno di questi dispone di dati recenti, il descrittore della metrica non verrà restituito. Se un descrittore della metrica non enumera i tipi di risorse monitorate compatibili, verrà restituito solo se il tipo di metrica dispone di dati recenti per un tipo di risorsa monitorata. Il descrittore restituito non elenca alcun tipo di risorsa monitorata. |
Schema di output
La risposta ListMetricDescriptors.
ListMetricDescriptorsResponse
| Rappresentazione JSON |
|---|
{
"metricDescriptors": [
{
object ( |
| Campi | |
|---|---|
metricDescriptors[] |
I descrittori delle metriche disponibili per il progetto e che corrispondono al valore di |
nextPageToken |
Se sono presenti più risultati di quelli restituiti, questo campo è impostato su un valore non vuoto. Per visualizzare i risultati aggiuntivi, utilizza questo valore come |
MetricDescriptor
| Rappresentazione JSON |
|---|
{ "name": string, "type": string, "labels": [ { object ( |
| Campi | |
|---|---|
name |
Il nome della risorsa del descrittore della metrica. |
type |
Il tipo di metrica, incluso il prefisso del nome DNS. Il tipo non è codificato in formato URL. Tutti i tipi di metriche definite dall'utente hanno il nome DNS |
labels[] |
L'insieme di etichette che possono essere utilizzate per descrivere un'istanza specifica di questo tipo di metrica. Ad esempio, il tipo di metrica |
metricKind |
Indica se la metrica registra valori istantanei, modifiche a un valore e così via. Alcune combinazioni di |
valueType |
Indica se la misurazione è un numero intero, un numero in virgola mobile e così via. Alcune combinazioni di |
unit |
Le unità in cui viene riportato il valore della metrica. È applicabile solo se Sistemi diversi potrebbero scalare i valori per visualizzarli più facilmente (ad esempio, un valore di Se vuoi che una metrica personalizzata registri il numero esatto di secondi CPU utilizzati da un job, puoi creare una metrica In alternativa, se vuoi che una metrica personalizzata registri i dati in modo più granulare, puoi creare una metrica Le unità supportate sono un sottoinsieme dello standard The Unified Code for Units of Measure: Unità di base (UNIT)
Prefissi (PREFIX)
Grammatica La grammatica include anche i seguenti connettori:
La grammatica di un'unità è la seguente: Note:
|
description |
Una descrizione dettagliata della metrica, che può essere utilizzata nella documentazione. |
displayName |
Un nome conciso per la metrica, che può essere visualizzato nelle interfacce utente. Utilizza la lettera maiuscola a inizio frase senza il punto finale, ad esempio "Conteggio richieste". Questo campo è facoltativo, ma è consigliabile impostarlo per qualsiasi metrica associata a concetti visibili agli utenti, ad esempio la quota. |
metadata |
Facoltativo. Metadati che possono essere utilizzati per guidare l'utilizzo della metrica. |
launchStage |
Facoltativo. La fase di lancio della definizione della metrica. |
monitoredResourceTypes[] |
Sola lettura. Se presente, un |
LabelDescriptor
| Rappresentazione JSON |
|---|
{
"key": string,
"valueType": enum ( |
| Campi | |
|---|---|
key |
La chiave per questa etichetta. La chiave deve soddisfare i seguenti criteri:
|
valueType |
Il tipo di dati che può essere assegnato all'etichetta. |
description |
Una descrizione leggibile per l'etichetta. |
MetricDescriptorMetadata
| Rappresentazione JSON |
|---|
{ "launchStage": enum ( |
| Campi | |
|---|---|
launchStage |
Deprecato. Devi utilizzare invece |
samplePeriod |
Il periodo di campionamento dei punti dati della metrica. Per le metriche scritte periodicamente, i punti dati consecutivi vengono archiviati a questo intervallo di tempo, escludendo la perdita di dati dovuta a errori. Le metriche con una granularità più elevata hanno un periodo di campionamento più breve. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
ingestDelay |
Il ritardo dei punti dati causato dall'importazione. I punti dati precedenti a questa data vengono acquisiti e sono disponibili per la lettura, esclusa la perdita di dati dovuta a errori. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
timeSeriesResourceHierarchyLevel[] |
L'ambito dei dati delle serie temporali della metrica. |
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 |
ValueType
Tipi di valori che possono essere utilizzati come valori etichetta.
| Enum | |
|---|---|
STRING |
Una stringa di lunghezza variabile, non superiore a 1024 caratteri. Questo è il tipo di valore predefinito. |
BOOL |
Booleano; vero o falso. |
INT64 |
Un numero intero a 64 bit con segno. |
MetricKind
Il tipo di misurazione. Descrive come vengono riportati i dati. Per informazioni sull'impostazione dell'ora di inizio e di fine in base a MetricKind, vedi TimeInterval.
| Enum | |
|---|---|
METRIC_KIND_UNSPECIFIED |
Non utilizzare questo valore predefinito. |
GAUGE |
Una misurazione istantanea di un valore. |
DELTA |
La variazione di un valore durante un intervallo di tempo. |
CUMULATIVE |
Un valore accumulato in un intervallo di tempo. Le misurazioni cumulative in una serie temporale devono avere la stessa ora di inizio e ore di fine crescenti, finché un evento non reimposta il valore cumulativo su zero e non imposta una nuova ora di inizio per i punti successivi. |
ValueType
Il tipo di valore di una metrica.
| Enum | |
|---|---|
VALUE_TYPE_UNSPECIFIED |
Non utilizzare questo valore predefinito. |
BOOL |
Il valore è un valore booleano. Questo tipo di valore può essere utilizzato solo se il tipo di metrica è GAUGE. |
INT64 |
Il valore è un numero intero a 64 bit con segno. |
DOUBLE |
Il valore è un numero con rappresentazione in virgola mobile a precisione doppia. |
STRING |
Il valore è una stringa di testo. Questo tipo di valore può essere utilizzato solo se il tipo di metrica è GAUGE. |
DISTRIBUTION |
Il valore è un . |
MONEY |
Il valore è denaro. |
LaunchStage
La fase di lancio definita in Fasi di lancio di Google Cloud Platform.
| Enum | |
|---|---|
LAUNCH_STAGE_UNSPECIFIED |
Non utilizzare questo valore predefinito. |
UNIMPLEMENTED |
La funzionalità non è ancora implementata. Gli utenti non possono utilizzarlo. |
PRELAUNCH |
Le funzionalità pre-lancio sono nascoste agli utenti e sono visibili solo internamente. |
EARLY_ACCESS |
Le funzionalità di accesso in anteprima sono limitate a un gruppo chiuso di tester. Per utilizzare queste funzionalità, devi registrarti in anticipo e firmare un contratto di Trusted Tester (che include disposizioni sulla riservatezza). Queste funzionalità possono essere instabili, essere modificate in modi incompatibili con le versioni precedenti e non ne è garantito il rilascio. |
ALPHA |
Alpha è un test a disponibilità limitata per le release prima che sia autorizzato un uso più ampio. Nella versione Alpha, tutti i problemi di progettazione significativi vengono risolti e stiamo verificando la funzionalità. I clienti alpha devono richiedere l'accesso, accettare i termini applicabili e inserire i propri progetti nella lista consentita. Le versioni alpha non sono necessariamente complete di tutte le funzionalità. Inoltre, non prevedono SLA (accordi sul livello del servizio) né obblighi di assistenza tecnica, ma sono sufficientemente avanzate da consentire ai clienti di utilizzarle in ambienti di test o per test a uso limitato, proprio come farebbero in normali casi di produzione. |
BETA |
La versione beta è il punto in cui siamo pronti ad aprire una release per l'utilizzo da parte di qualsiasi cliente. Nelle versioni beta non sono previsti SLA (accordi sul livello del servizio) né obblighi di assistenza tecnica. I prodotti saranno completi dal punto di vista delle funzionalità, ma potrebbero presentare alcuni problemi ancora da risolvere. Le versioni beta sono adatte a casi d'uso di produzione limitati. |
GA |
Le funzionalità GA sono aperte a tutti gli sviluppatori e sono considerate stabili e completamente qualificate per l'uso in produzione. |
DEPRECATED |
Le funzionalità deprecate verranno sospese e rimosse. Per ulteriori informazioni, consulta la sezione "Norme sul ritiro" dei nostri Termini di servizio e la documentazione Piattaforma Google Cloud soggetta alle norme sul ritiro. |
TimeSeriesResourceHierarchyLevel
Il livello della gerarchia di risorse dei dati delle serie temporali di una metrica.
| Enum | |
|---|---|
TIME_SERIES_RESOURCE_HIERARCHY_LEVEL_UNSPECIFIED |
Non utilizzare questo valore predefinito. |
PROJECT |
Limita l'ambito di una metrica a un progetto. |
ORGANIZATION |
Limita l'ambito di una metrica a un'organizzazione. |
FOLDER |
Limita l'ambito di una metrica a una cartella. |
Annotazioni dello strumento
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌