Simple Log Service:Sintaxe de consulta e análise de dados de métricas

Confira exemplos de SQL. Para mais informações, consulte os SQL use cases.

• Consulte e analise todos os dados.

  *| SELECT * FROM "my_metric_store.prom" WHERE __name__ != '' 

• Para a métrica http_request_count, consulte os dados em que o valor de domain no campo __labels__ seja www.example.com e obtenha a soma dos valores do campo __value__.

  *| SELECT sum(__value__) FROM "my_metric_store.prom" WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com' 

• Referente à métrica http_request_count, filtre os dados onde o valor de domain no campo __labels__ corresponda a www.example.com, agrupe os valores do campo __value__ por hora e calcule a soma total.

  *| SELECT sum(__value__),date_trunc('hour', __time_nano__/1000000) as t
  FROM "my_metric_store.prom" 
  WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com'
  GROUP BY t
  ORDER BY t DESC

Detalhes da sintaxe SQL:

• A sintaxe SQL para dados de métricas segue o mesmo padrão da sintaxe SQL para dados de log (Analysis syntax). Ao consultar dados de métricas com SQL, o nome da tabela na cláusula FROM deve estar no formato {metrics_store_name}.prom. {metrics_store_name} representa o nome do Metricstore criado por você.

  Nota

  Coloque o nome da tabela entre aspas duplas ("").

• Use a função element_at() para extrair um valor de chave do campo __labels__. Exemplo: element_at(__labels__, 'key').

• Para saber mais sobre esquemas de tabelas, consulte o Encoding format.

Cada função PromQL retorna uma tabela, funcionando de maneira similar a uma função com valor de tabela definida pelo usuário (UDTF).

• Esquema de tabela retornado por promql_query(string) e promql_query_range(string, string):

  Campo	Tipo de campo	Descrição
  metric	varchar	Nome da métrica. Pode estar vazio se a consulta incluir uma cláusula GROUP BY.
  labels	map<varchar, varchar>	Rótulos estruturados como um mapa de chave-valor.
  time	bigint	Timestamp.
  value	double	Valor em um ponto específico no tempo.

  Exemplos de consulta:

  • Função promql_query(string)

    Insira *| select promql_query('up') from metrics no editor de consultas e clique em Search & Analyze. O resultado será exibido em uma tabela com quatro colunas: time, metric, labels e value, apresentando os valores da métrica up de cada instância.

  • Função promql_query_range(string, string)

    Execute a instrução SQL select promql_query_range('up', '30s') from metrics para consultar os dados de intervalo da métrica PromQL up com um passo de 30s. O resultado aparece em uma tabela contendo dados de séries temporais.

• Esquema de tabela retornado por promql_labels(), promql_labels(string), promql_label_values(string) e promql_label_values(string, string):

  Campo	Tipo de campo	Descrição
  label	varchar	Chave do rótulo

  Exemplos de consulta:

  • Função promql_labels()

    *| select promql_labels() from metrics. O resultado da consulta retorna a coluna label, contendo cinco nomes de rótulo: code, instance, job, le e method.

  • Função promql_labels(string)

    Por exemplo, execute a consulta *| select promql_labels('up') from metrics para listar todos os nomes de rótulo da métrica up. O resultado inclui __name__, instance e job.

  • Função promql_label_values(string)

    Como exemplo, execute a consulta *| select promql_label_values('instance') from metrics. A coluna label no resultado traz três endereços de instância: demo.promlabs.com:10000, demo.promlabs.com:10001 e demo.promlabs.com:10002.

  • Função promql_label_values(string, string)

    Exemplo de consulta: *| select promql_label_values('up{demo!="a"}','instance') from metrics. O resultado retorna a coluna label com três linhas: demo.promlabs.com:10000, demo.promlabs.com:10001 e demo.promlabs.com:10002.

• Esquema de tabela retornado por promql_series(string):

  Campo	Tipo de campo	Descrição
  series	map<varchar, varchar>	Série temporal.

  Exemplo de consulta:

  Por exemplo, execute a consulta *| select promql_series('up') from metrics. A coluna series no resultado contém três linhas correspondentes a demo.promlabs.com:10001, demo.promlabs.com:10000 e demo.promlabs.com:10002. Cada linha é um mapa contendo os campos instance, __name__ (valor: up) e job (valor: demo).