Filtros e intervalo de tempo

Real-Time Metrics mostra cada dashboard no Azion Console sob um conjunto de controles: um dropdown de categoria, abas de produto, uma linha de filtros e um seletor de dashboard. O intervalo de tempo e os filtros que você define na linha de filtros se aplicam a todos os gráficos do dashboard que você está vendo.

Layout da tela

A tela de Real-Time Metrics agrupa os dashboards por categoria e produto. Em Build, as abas de produto são Applications, Tiered Cache, Functions e Image Processor. Em Secure, são WAF, Edge DNS, Bot Manager e Threats Breakdown. Em Observe, a única aba é Data Stream.

Os controles aparecem nesta ordem, a partir do topo da tela:

Sem produto nem dashboard na URL, a tela abre em Build › Applications › Data Transferred. Enquanto os gráficos carregam, quatro cards de placeholder ocupam o lugar deles. Cada dashboard e os gráficos dele estão descritos em Dashboards de Build, Dashboards de Secure e Dashboards de Observe.

Intervalo de tempo

O intervalo de tempo define o período que cada gráfico do dashboard busca. Ele é um único seletor de intervalo de datas na linha de filtros, e a tela abre em Last 5 minutes. O seletor tem quatro abas:

O dropdown de unidade da aba Quick oferece Minutes, Hours, Days, Weeks, Months e Years.

Presets de uso comum

A aba Quick lista 12 presets em duas colunas, nesta ordem:

Limites e exibição do intervalo

O calendário aceita datas de 730 dias atrás até o momento atual, e uma data fora dessa janela é ajustada ao limite mais próximo. O início e o fim escolhidos aparecem no formato Mon D, YYYY @ HH:MM:SS.

Depois que você altera o intervalo, o botão Refresh passa a mostrar Update. Selecione Update para carregar todos os gráficos com o novo intervalo.

O tamanho do intervalo também define a resolução dos gráficos de tempo: um ponto por minuto, por hora ou por dia. Para ver os limiares, consulte Como Real-Time Metrics funciona. Para saber até onde os dados alcançam no passado, consulte Limites de Real-Time Metrics.

Atualização automática

Real-Time Metrics recarrega os gráficos em um timer apenas quando você ativa a atualização automática. O controle fica na aba Quick do seletor de intervalo de tempo:

A atualização automática funciona com qualquer intervalo, e nenhum preset a ativa sozinho. Para manter o fim do intervalo no momento de cada atualização, use Set Now na aba Now.

Ao lado do seletor, o botão Refresh recarrega todos os gráficos sob demanda. Depois que você altera o intervalo ou edita o campo de query sem aplicar, o botão mostra Update e aplica a alteração. Refresh e Update ficam desativados enquanto o campo de query mostra um erro de validação ou enquanto o início do intervalo é posterior ao fim.

Fuso horário

Real-Time Metrics lê e plota os dados no fuso horário da sua conta. Os gráficos convertem o intervalo com o deslocamento UTC da conta e deslocam cada ponto do eixo x pelo mesmo valor.

O rodapé do seletor de intervalo de tempo mostra UTC: seguido do fuso horário da conta, e um seletor UTC Offset:. A primeira opção do seletor, como Account (UTC-03:00), é o deslocamento da conta e o padrão. As outras opções mostram (UTC +hh:mm) seguido do nome de um fuso horário, ordenadas por deslocamento, e a caixa Search timezone filtra a lista.

Em um gráfico de tempo, as marcações do eixo x usam o formato %b-%d %H:%M, como Oct-02 11:15. Os títulos do tooltip usam o formato de data e hora en-US.

Filtros

Sem filtro, os gráficos de um dashboard mostram os dados de toda a conta. Um filtro mantém apenas os dados cujo campo corresponde a um valor, em todos os gráficos do dashboard. Para adicionar, editar ou remover um filtro passo a passo, consulte Filtre um dashboard de Real-Time Metrics.

Popover de filtro

O botão de filtro é um ícone com o tooltip Add filter. Ele abre o popover Filter, ou um painel inferior em uma tela com 768 px de largura ou menos. O popover informa: Each combination of operator can only be used once.

Enquanto a lista de campos carrega, a linha de filtros mostra um placeholder.

Campos

A lista de campos não é fixa. Quando um dashboard abre, Real-Time Metrics lê no schema GraphQL os inputs de filtro do dataset do dashboard e os lista como campos. O rótulo de um campo é o nome do input separado em palavras, sem o sufixo de operador, com cada palavra em maiúscula: upstreamCacheStatusEq vira Upstream Cache Status. Os inputs que a descrição no schema marca como obsoletos não aparecem, nem um conjunto fixo de inputs excluídos, como clientId.

Para cada campo de um dataset e o tipo dele, consulte Campos da API GraphQL do Real-Time Metrics.

Alguns campos trazem uma lista de valores em vez de entrada livre:

O dropdown de campos lista alguns campos primeiro, por dashboard. Os demais campos vêm em seguida, em ordem alfabética:

Os dashboards de Bot Manager, Request Breakdown e Threats Breakdown listam todos os campos em ordem alfabética.

Operadores

Os operadores que um campo oferece dependem do tipo dele. Cada operador tem um rótulo no dropdown Operator, um símbolo no chip do filtro aplicado, uma forma no campo de query e o operador GraphQL que a query do gráfico envia:

Contains e Not Contains envolvem o valor como %value% antes de a query rodar. Para ver o que cada operador GraphQL compara, consulte Queries da API GraphQL.

Tipos de valor

A entrada de valor segue o tipo do campo:

Uma faixa precisa de um início menor que o fim. Caso contrário, o popover mostra Begin must be different from end, Begin must be less than end, End must be different from begin ou End must be more than begin. Quando uma lista de valores não carrega, aparece a mensagem Loading failed.

Filtros aplicados

Cada filtro aplicado aparece como um chip abaixo da linha de filtros, na forma <Field> <operator>: <value>, com o rótulo do operador em minúsculas. Uma faixa aparece como (begin,end) e uma lista de In como (a, b). Selecionar um chip abre o popover Filter com os valores daquele filtro, e um ícone de cadeado substitui a seta do campo, porque o campo não pode mudar. O ícone de remover de um chip exclui aquele filtro.

Combinação de filtros

Como o popover Filter informa, cada combinação de operador pode ser usada apenas uma vez. O campo de query une as condições com and, então os gráficos mostram apenas os dados que correspondem a todos os filtros aplicados. Para corresponder a qualquer um de vários valores de um campo, use In.

Filtros ao trocar de dashboard

Ao trocar para um dashboard que lê outro dataset, os filtros são limpos e o intervalo de tempo se mantém. Os filtros cujo campo não existe no novo dataset saem da query. O dataset de cada dashboard está listado em Dashboards de Build.

Campo de query

O campo de query na linha de filtros filtra o dashboard com uma expressão digitada em Azion Query Language. O placeholder dele mostra Filter using Azion Query Language syntax.... Uma expressão segue estas regras:

• Uma condição é um campo, um operador e um valor, separados por espaços: status = 200.
• Um nome de campo com mais de uma palavra vai entre aspas duplas: "Upstream Status".
• O operador in recebe os valores entre parênteses, sem vírgula depois do último: domain in (domain1, domain2).
• O operador between recebe exatamente dois valores diferentes entre parênteses: status between (200, 300).
• As condições se unem com and.

Enquanto você digita, o campo de query sugere nomes de campo, depois operadores e depois valores. Ctrl + Space, ou Cmd + Space, abre as sugestões; Enter aplica a expressão; e Esc fecha as sugestões.

Mensagens de validação

O campo de query mostra estas mensagens como são exibidas, e Refresh fica desativado até a expressão ser válida:

URL compartilhável

O caminho da URL de Real-Time Metrics nomeia a aba de produto e o dashboard, como https://console.azion.com/real-time-metrics/edge-applications/data-transferred para Applications › Data Transferred. Outro usuário da conta que abre essa URL chega ao mesmo dashboard.

Uma URL também pode trazer o parâmetro filters na query string. O valor dele é um objeto JSON codificado em base64, e Real-Time Metrics lê a chave external.tsRange dele, com begin e end, como o intervalo de tempo em que a tela abre.

Anatomia do gráfico

Cada gráfico é um card. De cima para baixo, ele traz o ícone de proprietário, o título do gráfico e o botão de menu; depois a descrição; depois a tag de agregação e, quando se aplica, a tag de variação; depois o gráfico em si.

Legenda

Cada entrada da legenda mostra o nome da série e o total dela no intervalo. Em um gráfico cuja tag de agregação mostra Average, o total é dividido pelo número de pontos. Selecione uma entrada da legenda para ocultar ou mostrar a série dela.

Um gráfico plota no máximo 16 séries; as séries além disso não são adicionadas. A legenda fica na parte de baixo do gráfico por padrão. Ela passa para a direita quando o gráfico ocupa mais de duas colunas do grid e tem mais de cinco séries, e fica na parte de baixo em uma janela com menos de 1024 px de largura. Gráficos de barras ordenadas não mostram legenda.

Tooltip e zoom

O tooltip aparece apenas em uma janela com mais de 540 px de largura. Gráficos cujo eixo x é tempo aceitam zoom: role para cima sobre o gráfico para aproximar e para baixo para afastar. Dentro do intervalo, um bucket de tempo sem dados é plotado como zero.

Gráficos de lista

Um gráfico de lista é uma tabela. Os cabeçalhos das colunas vêm dos nomes dos campos: sum mostra Total, geolocCountryName mostra Country, geolocAsn mostra ASN, geolocRegionName mostra Region e os outros nomes ficam com cada palavra iniciada em maiúscula. A tabela rola dentro de uma altura de 375 px, e uma tabela vazia mostra No registers found.

Estados do gráfico

Um card de gráfico mostra um destes estados no lugar do gráfico:

Menu do gráfico

O botão More options de um card de gráfico abre o menu do gráfico. Cada item aparece apenas quando se aplica ao gráfico:

Copy query

Copy query coloca um bloco de texto na área de transferência: a linha # QUERY, a query GraphQL do gráfico, depois a linha # VARIABLES e as variáveis como um objeto JSON. As duas linhas marcadoras são comentários GraphQL. A query lê os valores de filtro nas variáveis, então não roda sozinha. Para rodá-la, cole a query no Playground GraphiQL e mova o JSON que vem depois de # VARIABLES para o painel de variáveis. Para mais informações, consulte Playground GraphiQL.

Export CSV

Export CSV grava o arquivo com ; como separador e datas no formato en-US, com o mês primeiro e o relógio de 12 horas. O arquivo traz os pontos como o gráfico os plota para o intervalo e os filtros selecionados.

Linhas de média

Uma linha de média é a soma dos pontos do gráfico dividida pelo número de pontos, no intervalo selecionado. A entrada dela na legenda mostra Mean Line - <value>. Uma linha de média por série calcula a mesma média para cada série, e a entrada dela mostra Mean Line - <Series> - <value>.

Tag de variação

A tag de variação compara o intervalo selecionado com a janela de mesmo tamanho imediatamente anterior. Ela aparece em gráficos de tempo cujo resultado é uma única série e em cards de big number. Gráficos por categoria, como gráficos de pizza, gráficos de barras ordenadas e listas, nunca a mostram.

O valor é (current − previous) / previous × 100, mostrado como porcentagem com duas casas decimais. Por exemplo, com Last 1 hour selecionado às 10:00, a tag compara o período das 09:00 às 10:00 com o das 08:00 às 09:00.

Quando a variação fica entre –0,01% e +0,01%, a tag mostra Can’t compare, em uma cor de alerta com um ícone de triângulo. Ela também mostra Can’t compare quando um dos valores está ausente ou quando o valor anterior é 0.

Fora desses casos, a cor indica se a variação é boa para aquele gráfico:

Em um gráfico em que um aumento é bom, a tag acrescenta uma seta para cima e para a direita em um aumento e uma seta para baixo e para a esquerda em uma queda. Tags azuis aparecem apenas em cards de big number.

Recursos relacionados