Documentation sur Oracle Cloud Infrastructure

Données de trace de grappe

Vous pouvez créer des grappes à l'aide du langage TQL (Trace Explorer Query Language) lorsque vous utilisez des interrogations pour regrouper des intervalles par attribut.

Interrogations de grappe

Le langage TQL (Trace Explorer Query Language) prend en charge la création d'interrogations de grappe qui permettent de regrouper les traces ou les intervalles par attribut et d'identifier les valeurs aberrantes. Ils peuvent être exécutés à l'aide de la commande CLUSTER BY.

Types d'attribut pris en charge

Les types d'attribut peuvent être des mesures ou des dimensions.

  • Mesure : valeurs numériques incluant le temps (epoch)
  • Dimension : valeurs de chaîne
Note

Les interrogations de grappe prennent en charge un maximum de 6 attributs.

Syntaxe

CLUSTER BY <TQL query>

Une requête TQL est une requête avec des attributs et des données à regrouper. Il peut s'agir de n'importe quelle interrogation, y compris des interrogations imbriquées. Pour plus d'informations sur les interrogations et la syntaxe, voir Utiliser des interrogations dans l'explorateur de suivi.

Exemples de syntaxe :
  • CLUSTER BY traceduration, errorcount

    L'exemple ci-dessus interroge les attributs : traceduration et errorcount à partir de toutes les traces. Notez qu'il n'utilise pas la clause show traces (Afficher les traces) car elle est facultative et que TQL l'ajoute par défaut. 

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

    L'exemple ci-dessus utilise la clause show traces (Afficher les traces) explicitement pour interroger les attributs : traceduration et host (Hôte) à partir de toutes les traces où ServiceName est égal à Service1.

Résultats

Le résultat est les données dans un format de table avec les colonnes suivantes :

Tableau 5-1 : Résultats de la grappe par commande

Nom Type Description
ID grappe Nombre Identificateur de grappe
Compte Nombre Nombre d'intervalles ou de traces dans cette grappe
Pourcentage Nombre Pourcentage d'intervalles ou de traces dans cette grappe
Valeur aberrante String True ou False

Indique si cette grappe est une valeur aberrante
Dimension(s)

(Seulement si les dimensions font partie de l'interrogation de grappe)

 String Dimension name

Valeur unique par dimension
Mesure(s) - min

(Uniquement si les mesures font partie de l'interrogation du cluster)

 Nombre Valeur minimale de la mesure
Mesure(s)_max

(Uniquement si les mesures font partie de l'interrogation du cluster)

 Nombre Valeur maximale de mesure
Mesure(s)_center

(Uniquement si les mesures font partie de l'interrogation du cluster)

 Nombre Valeur de centre de mesures

Exemples

Exemple 1 :

CLUSTER BY show traces traceduration
Exemple de langage d'interrogation de l'explorateur de trace à l'aide de la commande cluster by

L'exemple ci-dessus interroge l'attribut : traceduration à partir de tous les intervalles. Notez que la clause show traces (Afficher les traces) est utilisée explicitement.

Exemple 2 :

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

L'exemple ci-dessus interroge les attributs : spanDuration et OperationName à partir de tous les intervalles où kind est égal à SERVER.

Pour la visualisation, vous pouvez générer un graphique à bulles à l'aide du générateur de widget de données de trace. Pour plus d'informations, voir Créer un widget basé sur des interrogations à l'aide des traces dans la documentation du tableau de bord de gestion. Exemple de graphique buble utilisant la commande cluster by

Note

  • Les valeurs vides sont supprimées des données de mise en grappe. Utilisez la fonction omittedTo pour affecter une valeur vide.
  • Il n'est pas possible de mettre en grappe plus de 1 million d'enregistrements de données à la fois.
  • S'il y a plus de 300 grappes, les 300 principales grappes sont retournées.