Thanks for your feedback!
EDIT
Como eu obtenho as respostas do antigo api-metrics?
| O contrato da API que substitui o api-metrics é diferente. |
Comparado com as funcionalidades do Analytics de quando ele estava acoplado à plataforma, o novo Analytics agora está muito mais flexível, permitindo que você possa personalizar suas buscas com maior liberdade.
Para isso, disponibilizamos o endpoint {/analytics/v1/products/api-gateway/traces/query}, que substitui o api-metrics.
Veja um exemplo de uso:
Obtendo o total de chamadas do dia com o endpoint traces/query
Se preferir, acompanhe os passos com o vídeo 1 no final da página.
-
Na ferramenta da sua escolha (e.g., Postman), selecione o método POST e informe a sua URL com o endpoint
{/analytics/v1/products/api-gateway/traces/query}. -
Em Headers, informe o valor da chave sensedia-auth.
Veja aqui como obter esse valor.
-
Escreva a sua busca no corpo da requisição.
Você pode usar DQL ou Lucene.
Veja mais abaixo dicas de como obter a query pronta, seja a partir de um filtro do General Trace ou de uma visualização do Dashboard.
-
Clique em SEND e veja o resultado no corpo da resposta.
Aqui vão algumas dicas para economizar seu tempo.
Você pode montar a busca usando a interface gráfica e depois copiar a query resultante e colar no passo 3 acima.
Monte a sua query a partir da interface gráfica do Analytics usando filtros do General Trace ou visualizações do Dashboard. Veja abaixo como.
| As consultas feitas pelo endpoint /traces/query possuem limitações de uso, como timeout e rate limit. Elas são indicadas apenas para consultas pontuais. Para uma extração dos dados mais completa, utilize o Data Streaming. |
Filtros do General Trace
Siga os passos do exemplo abaixo para gerar uma query a partir da interface gráfica do General Trace.
Os passos podem ser usados com qualquer combinação de filtros, definidos no passo 1 a seguir.
Exemplo de "atalho" para escrever uma query usando o General Trace
Se preferir, acompanhe os passos com o vídeo 2 no final da página.
-
No Analytics, em General Trace, crie uma busca usando os filtros disponíveis.
Para este exemplo, vamos definir um filtro por status code e um intervalo de tempo de 1 semana, como ilustrado na imagem abaixo.
-
Uma vez criados os filtros, clique em Inspect.
-
Clique em Request e procure pela query.
-
Selecione e copie a query do Inspect > Request do General Trace.
-
Esta query é usada no passo 3 do primeiro exemplo, isto é:
-
Vá para o Postman e cole a query no local apropriado dentro campo Body da requisição.
Atente-se para o início e fim das chaves.
-
Ainda no Postman, clique em SEND e confira o resultado no corpo da resposta.
-
Agregações do Visualize ou Dashboards
Siga os passos do exemplo abaixo para gerar uma query a partir da interface gráfica do Dashboard ou Visualize.
Os passos podem ser usados com qualquer gráfico.
Você pode adequar a busca para trazer o que precisa, utilizando os recursos do Visualize ou Dashboards.
Exemplo de "atalho" para escrever uma query com agregação usando o Dashboards
Se preferir, acompanhe os passos com o vídeo 3 no final da página.
-
No Analytics, entre em Dashboards.
-
Na lista com seus Dashboards, procure e abra o Dashboard que contém a visualização com a agregação que deseja.
-
Clique no ícone no canto superior direito do painel que contém a visualização escolhida e clique em More > Inspect.
Em seguida, clique em View:Data > Requests > Request e copie toda a query.
-
Vá para o Postman e cole a query no campo Body da requisição.
-
Ainda no Postman, clique em SEND e confira o resultado no corpo da resposta.
