Documentación de Oracle Cloud Infrastructure

Datos de Rastreo de Cluster

Puede crear clusters mediante el lenguaje de consulta del explorador de rastreo (TQL) al trabajar con consultas para períodos de cluster por atributos.

Consultas de cluster

El lenguaje de consulta del explorador de rastreo (TQL) soporta la creación de consultas de cluster que permiten agrupar rastreos o períodos por atributos e identificar valores atípicos. Se pueden ejecutar mediante el comando CLUSTER BY.

Tipos de atributo soportados

Los tipos de atributo pueden ser métricas o dimensiones.

  • Métrica: valores numéricos, incluido el tiempo (época)
  • Dimensión: valores de cadena
Nota

Las consultas de cluster soportan un máximo de 6 atributos.

Sintaxis

CLUSTER BY <TQL query>

Una consulta TQL es una consulta con atributos y datos por los que agrupar. Puede ser cualquier consulta, incluidas las consultas anidadas. Para obtener información sobre las consultas y la sintaxis, consulte Trabajo con consultas en el explorador de rastreo.

Ejemplos de sintaxis:
  • CLUSTER BY traceduration, errorcount

    En el ejemplo anterior, se consultan los atributos: traceduration y errorcount de todos los rastreos. Tenga en cuenta que no utiliza la cláusula show traces, ya que es opcional y TQL la agrega por defecto. 

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

    En el ejemplo anterior, se utiliza la cláusula show traces explícitamente para consultar los atributos: traceduration y host de todos los rastreos donde ServiceName es igual a Service1.

Resultados

El resultado son los datos en formato de tabla con las siguientes columnas:

Tabla 5-1 Resultados de cluster por comando

Nombre Tipo Descripción
Identificador de Cluster Numérico Identificador de cluster
Recuento Numérico Número de intervalos o rastreos en ese cluster
Porcentaje Numérico Porcentaje de intervalos o rastreos en ese cluster
Valores atípicos Cadena verdadero o falso

Si ese cluster es o no un valor atípico
Dimensiones

(Solo si las dimensiones forman parte de la consulta de cluster)

 Cadena Nombre de dimensión

Valor único por dimensión
Métricas_min

(Solo si las métricas forman parte de la consulta de cluster)

 Numérico Valor mínimo de métrica
Métricas_max

(Solo si las métricas forman parte de la consulta de cluster)

 Numérico Valor máximo de métrica
Métricas_centro

(Solo si las métricas forman parte de la consulta de cluster)

 Numérico Valor de centro de métricas

Ejemplos

Ejemplo 1:

CLUSTER BY show traces traceduration
Ejemplo de lenguaje de consulta del explorador de rastreo mediante el comando cluster by

El ejemplo anterior consulta el atributo: traceduration de todos los intervalos. Tenga en cuenta que utiliza la cláusula show traces de forma explícita.

Ejemplo 2:

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

En el ejemplo anterior, se consultan los atributos: spanDuration y OperationName de todos los intervalos donde kind es igual a SERVER.

Para la visualización, puede generar un gráfico de burbujas mediante el creador de widgets de datos de rastreo. Para obtener más información, consulte Creación de un widget basado en consultas mediante rastreos en la documentación del panel de control de gestión. Ejemplo de gráfico de buble con el comando cluster by

Nota

  • Los valores vacíos se borran de los datos de agrupación en clusters. Utilice la función omittedTo para asignar un valor vacío.
  • No se pueden agrupar más de 1 millón de registros de datos a la vez.
  • Si hay más de 300 clusters, se devuelven los 300 clusters principales.