Como criar uma visualização de dados e consultar o StoreView - Simple Log Service: Central de Documentação do Alibaba Cloud

Pré-requisitos

Crie um projeto e um metricstore. Para mais informações, consulte Gerenciar projetos e Gerenciar um metricstore.

Criar um StoreView e associar metricstores

1. Criar um Storeview para Metricstore

Faça login no console do Simple Log Service. Na lista Projects, clique em no projeto desejado.
No painel de navegação à esquerda, escolha Data View > Time Series Data View. Na página do StoreView, clique em para criar um Storeview para Metricstore.
No painel Create StoreView, insira um Storeview Name, adicione os metricstores associados e clique em OK.
Importante
- Um Storeview para Metricstore deve conter um metricstore do mesmo projeto.
- O StoreView para Metricstore oferece suporte a consultas e análises em vários metricstores. Para garantir resultados precisos, siga estas recomendações:
  - Não associe metricstores com séries temporais sobrepostas ao mesmo StoreView.
  - Evite associar múltiplos metricstores de grande escala para computação. Por exemplo, não associe metricstores com contagem de shards superior a 64.
Defina o Storeview Type como Metric.

2. Consultar um StoreView com PromQL

Nota

Ao associar vários metricstores a um StoreView, os resultados de consulta e análise agregam dados de todos os metricstores associados.
O StoreView para Metricstore não oferece suporte a SQL ou processamento predefinido. Insira uma instrução PromQL diretamente no editor de consultas. O mecanismo de backend executa automaticamente os cálculos em todos os metricstores associados.

No painel de conjuntos de dados à esquerda, selecione o conjunto de dados test. No editor de consultas, insira a instrução PromQL cpu_count{} e clique em Run no canto superior direito. O gráfico de linhas da métrica aparecerá na área de resultados.

Conectar um StoreView ao Grafana

Instale e faça login no Grafana. No painel de navegação à esquerda, escolha Configuration > Data Sources.
Na aba Data Sources, clique em Add data source. Em seguida, selecione Prometheus e clique em Select.

Na aba Settings, configure a fonte de dados.

Parâmetros da fonte de dados

Parâmetro	Descrição
Name	Insira um nome personalizado para a fonte de dados. Exemplo: Prometheus-1.
HTTP	URL: URL do StoreView no Simple Log Service, no formato https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}. Substitua {sls-endpoint} pelo endpoint da região do projeto. Substitua {project} e {storeview} pelos nomes do projeto e do StoreView. Exemplo: https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/test. Nota Para garantir a transmissão segura de dados, use `https`. Whitelisted Cookies: Opcional. Adiciona cookies à lista de permissões das requisições.
Auth	Ative a opção Basic auth.
Basic Auth Details	User: AccessKey ID da sua conta Alibaba Cloud. Password: AccessKey secret da sua conta Alibaba Cloud. Recomendamos usar o par de AccessKeys de um usuário RAM com permissões somente leitura no projeto especificado. Para mais informações, consulte Conceder permissões somente leitura em um projeto específico.

Clique em Save & Test.

API HTTP do StoreView

Visão geral

O Simple Log Service oferece diversas APIs para consultar um StoreView para Metricstore. Essas APIs são compatíveis com o protocolo Prometheus open source e seguem a convenção de diretório /api/v1. A URL completa é https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/.

Parâmetro	Obrigatório	Descrição
{project}	Sim	Nome do projeto do Simple Log Service. Para mais informações, consulte Gerenciar projetos.
{sls-endpoint}	Sim	Endpoint da região do projeto.
{storeview}	Sim	Nome do StoreView.

APIs de consulta de métricas

Instant queries

A API Instant Queries consulta dados de métricas em um ponto específico no tempo.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
query	Sim	Expressão PromQL. Para mais informações, consulte Sintaxe PromQL.
time	Não	Timestamp de avaliação da consulta, especificado como timestamp Unix em segundos. O padrão é a hora atual.
timeout	Não	Tempo limite da consulta. Especifique o valor em segundos ou use formatos de duração como `1s`, `2m` ou `3h` (por exemplo, `timeout=10s`). Para mais informações, consulte Durações de tempo.
lookback_delta	Não	Personaliza a flag `query.lookback-delta` do Prometheus para a consulta. Define o período máximo de retrocesso para localizar pontos de dados durante a avaliação do PromQL. O valor deve usar o formato de duração de tempo, por exemplo, `lookback_delta=1m`. O valor padrão no banco de dados de séries temporais do Log Service é `3m`. Para mais informações, consulte Durações de tempo.

Range queries

A API Range Queries consulta dados de métricas em um intervalo de tempo especificado.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
query	Sim	Expressão PromQL. Para mais informações, consulte Sintaxe PromQL.
start	Não	Início do intervalo de consulta, especificado como timestamp Unix em segundos.
end	Não	Fim do intervalo de consulta, especificado como timestamp Unix em segundos.
step	Não	Passo de resolução da consulta, em segundos. Também é possível usar formatos de duração como `1s`, `2m` ou `3h` (por exemplo, `step=2m`). Para mais informações, consulte Durações de tempo.
timeout	Não	Tempo limite da consulta. Especifique o valor em segundos ou use formatos de duração como `1s`, `2m` e `3h`. Por exemplo, `timeout=10s`. Para mais informações, consulte Durações de tempo.
lookback_delta	Não	Personaliza a flag `query.lookback-delta` do Prometheus para a consulta. Define o período máximo de retrocesso para localizar pontos de dados durante a avaliação do PromQL. O valor deve usar o formato de duração de tempo, por exemplo, `lookback_delta=1m`. O valor padrão no banco de dados de séries temporais do Log Service é `3m`. Para mais informações, consulte Durações de tempo.

Para exemplos de configuração, consulte APIs de consulta de métricas.

APIs de consulta de metadados

Query series

A API Query Series retorna todas as séries temporais e rótulos correspondentes a um conjunto de seletores de rótulos dentro de um intervalo de tempo especificado.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
match[]	Sim	Seletores de série para correspondência. Exemplo: `match[]=up{instance="demo.*"}`. Especifique um ou mais parâmetros `match[]`.
start	Não	Início do intervalo de consulta, como timestamp Unix em segundos. O padrão é 5 minutos antes da hora atual.
end	Não	Fim do intervalo de consulta, como timestamp Unix em segundos. O padrão é a hora atual. Importante Se você especificar valores personalizados para os parâmetros start e end, a API limitará a consulta ao intervalo de 5 minutos anterior ao horário de end. O intervalo efetivo da consulta será [`end` - 5 minutos, `end`].
x-sls-disable-range-limit	Não	Quando definido como `true`, este parâmetro ignora o limite de consulta de 5 minutos e utiliza o intervalo completo especificado por `start` e `end`.
forceMaxMetaTimeRangeSeconds	Não	Especifica o intervalo máximo de tempo da consulta em segundos. Se a duração entre `end` e `start` exceder esse valor, o intervalo de consulta será ajustado para (`end` - forceMaxMetaTimeRangeSeconds, `end`). Recomendamos incluir este parâmetro para garantir consultas eficientes.

Query label names

Consulta todos os nomes de rótulos que atendem às condições especificadas dentro de um intervalo de tempo.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
match[]	Sim	Seletores de série para correspondência. Exemplo: `match[]=up{instance="demo.*"}`. Especifique zero, um ou mais parâmetros `match[]`.
start	Não	Início do intervalo de consulta, como timestamp Unix em segundos. O padrão é 5 minutos antes da hora atual.
end	Não	Fim do intervalo de consulta, como timestamp Unix em segundos. O padrão é a hora atual. Importante Se você especificar valores personalizados para os parâmetros start e end, a API limitará a consulta ao intervalo de 5 minutos anterior ao horário de end. O intervalo efetivo da consulta será [`end` - 5 minutos, `end`].
x-sls-disable-range-limit	Não	Quando definido como `true`, este parâmetro ignora o limite de consulta de 5 minutos e utiliza o intervalo completo especificado por `start` e `end`.
forceMaxMetaTimeRangeSeconds	Não	Especifica o intervalo máximo de tempo da consulta em segundos. Se a duração entre `end` e `start` exceder esse valor, o intervalo de consulta será ajustado para (`end` - forceMaxMetaTimeRangeSeconds, `end`). Recomendamos incluir este parâmetro para garantir consultas eficientes.

Query label values

A API Query Label Values retorna todos os valores de um rótulo específico correspondentes aos seletores indicados dentro de um intervalo de tempo.

Importante

Substitua <label_name> na URL da API pelo nome específico do rótulo.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/label/<label_name>/values

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
match[]	Sim	Seletores de série para correspondência. Exemplo: `match[]=up{instance="demo.*"}`. Especifique um ou mais parâmetros `match[]`.
start	Não	Início do intervalo de consulta, como timestamp Unix em segundos. O padrão é 5 minutos antes da hora atual.
end	Não	Fim do intervalo de consulta, como timestamp Unix em segundos. O padrão é a hora atual. Importante Se você especificar valores personalizados para os parâmetros start e end, a API limitará a consulta ao intervalo de 5 minutos anterior ao horário de end. O intervalo efetivo da consulta será [`end` - 5 minutos, `end`].
x-sls-disable-range-limit	Não	Quando definido como `true`, este parâmetro ignora o limite de consulta de 5 minutos e utiliza o intervalo completo especificado por `start` e `end`.
forceMaxMetaTimeRangeSeconds	Não	Especifica o intervalo máximo de tempo da consulta em segundos. Se a duração entre `end` e `start` exceder esse valor, o intervalo de consulta será ajustado para (`end` - forceMaxMetaTimeRangeSeconds, `end`). Recomendamos incluir este parâmetro para garantir consultas eficientes.

Para exemplos de configuração, consulte APIs de consulta de metadados.

Próximos passos

Consultar um StoreView

No painel de navegação à esquerda, escolha Data View > Time Series Data View para visualizar os StoreViews criados.

Atualizar um StoreView

Na lista de StoreViews, passe o mouse sobre o StoreView desejado, clique em no ícone e clique em Modify.
No painel Modify StoreView, modifique os metricstores associados e clique em OK.

Cada store inclui listas suspensas de project e metricstore. Clique em + STORE para associar mais metricstores.

Excluir um StoreView

Na lista de StoreViews, passe o mouse sobre o StoreView desejado, clique em no ícone e clique em Delete.

Documentação relacionada

Para sintaxe de consulta e análise de dados de séries temporais, consulte Sintaxe de consulta e análise para dados de séries temporais.
O Simple Log Service fornece APIs para consultar métricas de séries temporais e gravar dados de métricas em um metricstore. Para mais informações, consulte Referência da API HTTP do Metricstore.