Documentação do Oracle Cloud Infrastructure

Dados de Rastreamento do Cluster

Você pode criar clusters usando o Trace Explorer Query Language (TQL) ao trabalhar com consultas para intervalos de cluster por atributos.

Consultas de Cluster

O Trace Explorer Query Language (TQL) suporta a criação de consultas de cluster que permitem rastrear ou intervalos de cluster por atributos e identificar discrepâncias. Eles podem ser executados usando o comando CLUSTER BY.

Tipos de Atributo Suportados

Os tipos de atributo podem ser métricas ou dimensões.

  • Métrica: valores numéricos incluindo Tempo (epoch)
  • Dimensão: valores de string
Observação

As consultas de cluster suportam no máximo 6 atributos.

Sintaxe

CLUSTER BY <TQL query>

Uma consulta TQL é uma consulta com atributos e dados pelos quais clusterizar. Pode ser qualquer consulta, incluindo consultas aninhadas. Para obter informações sobre consultas e sintaxe, consulte Trabalhar com Consultas no Trace Explorer.

Exemplos de Sintaxe:
  • CLUSTER BY traceduration, errorcount

    O exemplo acima consulta os atributos: traceduration e errorcount de todos os rastreamentos. Observe que ele não está usando a cláusula show traces, pois é opcional e o TQL a adiciona por padrão. 

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

    O exemplo acima usa a cláusula show traces explicitamente para consultar os atributos: traceduration e host de todos os rastreamentos em que ServiceName é igual a Service1.

Resultados

O resultado são os dados em um formato de tabela com as seguintes colunas:

Tabela 5-1 Resultados de Cluster por Comando

Nome Tipo Descrição
ID do Cluster Numérico Identificador do cluster
Contagem Numérico Número de intervalos ou rastreamentos nesse cluster
Porcentagem Numérico Porcentagem de intervalos ou rastreamentos nesse cluster
Exceção String Verdadeiro ou Falso

Se esse cluster é ou não um valor atípico
Dimensão(ões)

(Somente se as dimensões fizerem parte da consulta de cluster)

 String Nome da Dimensão

Valor único por dimensão
Métrica(s)_min

(Somente se as métricas fizerem parte da consulta do cluster)

 Numérico Valor mínimo da métrica
Métrica(s)_max

(Somente se as métricas fizerem parte da consulta do cluster)

 Numérico Valor máximo da métrica
Métrica(s)_centro

(Somente se as métricas fizerem parte da consulta do cluster)

 Numérico Valor do centro de métricas

Exemplos

Exemplo 1:

CLUSTER BY show traces traceduration
Exemplo de Linguagem de Consulta do Trace Explorer usando o cluster por comando

O exemplo acima consulta o atributo: traceduration de todos os intervalos. Observe que ele está usando a cláusula show traces explicitamente.

Exemplo 2:

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

O exemplo acima consulta os atributos: spanDuration e OperationName de todos os intervalos em que kind é igual a SERVER.

Para visualização, você pode gerar um gráfico de bolhas usando o construtor de widget de dados de rastreamento. Para obter informações, consulte Criar um Widget Baseado em Consulta Usando Rastreamentos na documentação do Painel de Controle de Gerenciamento. Exemplo de gráfico de problemas usando o cluster por comando

Observação

  • Valores vazios são eliminados dos dados de cluster. Use a função omittedTo para designar um valor vazio.
  • Não mais de 1 milhão de registros de dados podem ser agrupados por vez.
  • Se houver mais de 300 clusters, os 300 principais clusters serão retornados.