Documentazione di Oracle Cloud Infrastructure

Dati di trace del cluster

È possibile creare cluster utilizzando il linguaggio TQL (Trace Explorer Query Language) quando si utilizzano query per raggruppare gli intervalli in base agli attributi.

Query cluster

Il linguaggio TQL (Trace Explorer Query Language) supporta la creazione di query cluster che consentono di raggruppare i trace o gli intervalli in base agli attributi e identificare i valori erratici. È possibile eseguirli utilizzando il comando CLUSTER BY.

Tipi di attributo supportato

I tipi di attributo possono essere metriche o dimensioni.

  • Metrica: valori numerici che includono Time (epoch)
  • Dimensione: valori di stringa
Nota

Le query cluster supportano al massimo 6 attributi.

Sintassi

CLUSTER BY <TQL query>

Una query TQL è una query con attributi e dati in base alla quale eseguire il cluster. Può essere qualsiasi query, incluse le query nidificate. Per informazioni sulle query e sulla sintassi, vedere Utilizzo delle query in Trace Explorer.

Esempi di sintassi:
  • CLUSTER BY traceduration, errorcount

    Nell'esempio precedente vengono eseguiti query sugli attributi: traceduration e errorcount da tutti i trace. Tenere presente che la clausola show trace non viene utilizzata poiché è facoltativa e TQL la aggiunge per impostazione predefinita. 

  • CLUSTER BY show traces traceduration, host where ServiceName = 'Service1'

    Nell'esempio precedente viene utilizzata la clausola show trace in modo esplicito per eseguire una query sugli attributi: traceduration e host da tutti i trace in cui ServiceName è uguale a Service1.

Risultati

Il risultato sono i dati in formato tabella con le seguenti colonne:

Tabella 5-1 Risultati cluster per comando

Nome Digitare descrizione
ID cluster Numeriche Identificativo cluster
Conteggio Numeriche Numero di intervalli o trace nel cluster
Percentuale Numeriche Percentuale di intervalli o trace nel cluster
Valore anomalo Stringa True o False

Indica se il cluster è un valore anomalo
Dimensione/i

(Solo se le dimensioni fanno parte della query cluster)

 Stringa Nome dimensione

Valore singolo per dimensione
Metriche_min

(Solo se le metriche fanno parte della query cluster)

 Numeriche Valore minimo metrica
Metriche_max

(Solo se le metriche fanno parte della query cluster)

 Numeriche Valore massimo metrica
Metriche_centro

(Solo se le metriche fanno parte della query cluster)

 Numeriche Valore centro metriche

Esempi

Esempio 1:

CLUSTER BY show traces traceduration
Esempio di linguaggio query Trace Explorer mediante il comando cluster by

Nell'esempio precedente viene eseguita una query sull'attributo: tracedurazione da tutti gli intervalli. Si noti che utilizza la clausola show trace in modo esplicito.

Esempio 2:

CLUSTER BY show spans spanDuration, OperationName as ServerRequest where kind='SERVER'

Nell'esempio precedente vengono eseguiti query sugli attributi: spanDuration e OperationName da tutti gli intervalli in cui kind è uguale a SERVER.

Per la visualizzazione, è possibile generare un grafico a bolle utilizzando la Costruzione guidata widget dati traccia. Per informazioni, vedere Creare un widget basato su query utilizzando le tracce nella documentazione del dashboard di gestione. Esempio di grafico a bolle con il comando cluster by

Nota

  • I valori vuoti vengono eliminati dai dati di clustering. Utilizzare la funzione omittedTo per assegnare un valore vuoto.
  • Non è possibile raggruppare più di 1 milione di record di dati alla volta.
  • Se sono presenti più di 300 cluster, vengono restituiti i primi 300 cluster.