Documentazione dell'infrastruttura Oracle Cloud

Selezione delle dimensioni per una query

Limita i dati delle metriche restituiti selezionando le dimensioni durante l'esecuzione di query sui dati delle metriche in Monitoraggio. Una dimensione è un qualificatore fornito in una definizione di metrica. In MQL, il componente di selezione delle dimensioni specifica le coppie nome-valore per le dimensioni, circondate da parentesi graffe.

Per la risoluzione dei problemi delle query, vedere Risoluzione dei problemi delle query.

Esempi
Nota

I preventivi attorno al valore (come in "FAULT-DOMAIN-1") possono essere omessi a meno che il valore non contenga spazi o non venga utilizzato in Fuzzy Matching.
Esempio 1: dominio di errore
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()
Esempio 2: compartimento
IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max()
Esempio 3: forma (con raggruppamento)
CpuUtilization[1m]{shape="VM.Standard.E4.Flex"}.groupBy(availabilityDomain,poolId).mean()
Esempio 4: coppie nome-valore più dimensioni: dominio di errore, nome e forma
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean()
Le dimensioni in questa query vengono elaborate con un operatore AND. I dati risultanti includono solo i flussi di metriche corrispondenti a tutte le dimensioni.
Esempio 5: valori multipli per una dimensione: dominio di errore 1 o 2
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
I valori delle dimensioni in questa query vengono elaborati con un operatore OR, utilizzando la corrispondenza non esatta. La corrispondenza esatta è disponibile solo nelle espressioni MQL. Nella console, utilizzare la modalità avanzata. I dati risultanti includono flussi di metriche che corrispondono a uno dei due valori.
Corrispondenza non esatta

Specificare corrispondenze approssimative ("fuzzy") ai valori di dimensione in un'espressione MQL.

Nota

La corrispondenza esatta è disponibile solo nelle espressioni MQL. Nella console utilizzare la modalità avanzata.

Al posto del segno di uguale (=) tra il nome della dimensione e il set di valori, utilizzare l'operatore di confronto seguente.

Operatore di confronto Descrizione
=~ (segno di uguale seguito da tilde) Indicativamente uguale a. Usa per corrispondenze non esatta

Per la corrispondenza non esatta, racchiudere il set di valori tra virgolette: name = "val*" o name = "value1|value2"

Aggiornare il set di valori utilizzando uno o più dei caratteri seguenti.

Carattere corrispondenza non esatta valore Descrizione
* (asterisco) Carattere jolly, che indica da zero a molti caratteri.
|(pipe) Operando OR per i valori dimensione.

Esempio che mostra la corrispondenza non esatta per i set di valori a tre dimensioni (test delle istanze di computazione nel dominio di errore 1 che utilizzano la forma myshape):

CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1", resourceDisplayName =~ "test*", shape =~ "myshape"}.mean()
Valori esclusi

Filtrare i valori di dimensione (escludi) in un'espressione MQL.

Nota

L'esclusione dei valori è disponibile solo nelle espressioni MQL. Nella console utilizzare la modalità avanzata.

Al posto del segno di uguale (=) tra il nome della dimensione e il set di valori, utilizzare uno dei seguenti operatori di confronto.

Operatore di confronto Descrizione
!= (punto esclamativo seguito da segno di uguale) Diverso da. Consente di filtrare un singolo valore di dimensione.
!~ (punto esclamativo seguito da tilde) Diverso da. Utilizzare per filtrare più valori di dimensione (quando l'espressione utilizza caratteri jolly o operandi OR).

Se si utilizza l'operatore di confronto !~, aggiornare il set di valori delle dimensioni utilizzando uno o più dei seguenti caratteri.

Carattere corrispondenza non esatta valore Descrizione
* (asterisco) Carattere jolly, che indica da zero a molti caratteri.
|(pipe) Operando OR per i valori dimensione.

Esempio 1 (valore singolo): query di base per l'utilizzo della CPU, escluso il dominio di errore 1.

CpuUtilization [1m]{faultDomain != "FAULT-DOMAIN-1"}.mean()

Esempio 2 (valori multipli): query di base per l'utilizzo della CPU, esclusi i domini di errore 1 e 2.

CpuUtilization [1m]{faultDomain !~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()

  • In questa sezione viene descritto come selezionare le dimensioni nella pagina Esplora metriche. Per le modifiche alle query di allarme, vedere Creazione di un allarme di base.

    1. Creare una query di base nella pagina Explorer metriche.
    2. Se la query non è aperta, aprirla selezionando Modifica query.
    3. Per selezionare le dimensioni utilizzando la modalità Base (impostazione predefinita), fornire i valori per i campi riportati di seguito.
      Nota

      Per alcuni spazi di nomi delle metriche vengono visualizzati campi dimensione aggiuntivi o di altro tipo. Ad esempio, viene visualizzato un campo del tipo di distribuzione per lo spazio di nomi delle metriche oci_autonomous_database. Per informazioni dettagliate, consultare la documentazione specifica del servizio.
      • Nome dimensione: un qualificatore specificato nella definizione della metrica. Ad esempio, la dimensione resourceId è specificata nella definizione della metrica per CpuUtilization.

        Per selezionare una risorsa specifica all'interno del compartimento selezionato, filtrare i risultati in base a una dimensione specifica della risorsa, ad esempio resourceDisplayName.

        Nota

        Vengono tagliati elenchi lunghi di dimensioni.

        • Per visualizzare le dimensioni in base al nome, digitare uno o più caratteri nella casella. Una lista aggiornata (tagliata) mostra i nomi delle dimensioni corrispondenti.
        • Per recuperare tutte le dimensioni per una metrica, vedere Elenco delle definizioni delle metriche.
      • Valore dimensione: il valore che si desidera utilizzare per la dimensione specificata, ad esempio l'identificativo di risorsa per un'istanza.
      • Dimensione aggiuntiva: aggiunge un'altra coppia nome-valore per una dimensione.
    4. Per selezionare le dimensioni aggiornando l'espressione MQL, effettuare le operazioni riportate di seguito.
      1. Selezionare Modalità avanzata.
      2. Modificare il testo nella casella Editor di codici query.

        Esempio di dimensione in un'espressione MQL:

        CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()

        In questo esempio, la query limita la restituzione dei dati al dominio di errore 1. Il grafico di Query di esempio e grafico delle metriche ora mostra quattro flussi di metriche. Ogni flusso di metriche corrisponde a un'istanza nel dominio di errore 1.Flussi di metriche filtrati in un singolo dominio di errore.

    5. Selezionare Aggiorna grafico.

  • Utilizzare il comando oci monitoring Metric-data riepilogate-metrics-data e i parametri necessari per eseguire la query sui dati delle metriche. Utilizzare il parametro --query-text per selezionare le dimensioni (parte dell'espressione MQL).

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    Per un elenco completo dei parametri e dei valori per i comandi CLI, consultare il manuale Command Line Reference for Monitoring.

  • Eseguire l'operazione SummarizeMetricsData per eseguire una query sui dati delle metriche. Utilizzare l'attributo query per selezionare le dimensioni (parte dell'espressione MQL). Per un esempio, vedere SummarizeMetricsDataDetails.