# Filtros e intervalo de tempo [Real-Time Metrics](/pt-br/documentacao/plataforma/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](/pt-br/documentacao/plataforma/applications/), [Tiered Cache](/pt-br/documentacao/plataforma/applications/cache/tiered-cache/), [Functions](/pt-br/documentacao/plataforma/functions/) e [Image Processor](/pt-br/documentacao/plataforma/applications/#image-processor). Em **Secure**, são [WAF](/pt-br/documentacao/plataforma/firewall/#waf), [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/), [Bot Manager](/pt-br/documentacao/plataforma/firewall/#bot-manager) e **Threats Breakdown**. Em **Observe**, a única aba é [Data Stream](/pt-br/documentacao/plataforma/data-stream/). Os controles aparecem nesta ordem, a partir do topo da tela: | Controle | Forma | Comportamento | | -------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | Categoria | Um dropdown com **Build**, **Secure** e **Observe** | Ao trocar a categoria, a tela abre o primeiro produto dela e o primeiro dashboard desse produto. | | Abas de produto | Uma aba por produto da categoria | Cada aba abre os dashboards de um produto. | | Linha de filtros | O botão de filtro, o campo de query, o seletor de intervalo de tempo e o botão **Refresh**, dentro de um card | Define os dados que cada gráfico do dashboard busca. | | Filtros aplicados | Um chip por filtro, abaixo da linha de filtros | Cada chip mostra um filtro e o abre para edição. | | Seletor de dashboard | Um botão segmentado, como **Data Transferred** e **Requests** | Aparece apenas quando o produto tem mais de um dashboard: **Applications** e **Bot Manager**. | | Gráficos | Cards de big number na primeira linha, depois os outros gráficos em um grid de 12 colunas | Os gráficos que não cabem na tela continuam mais abaixo na página. | 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](/pt-br/documentacao/plataforma/real-time-metrics/dashboards-build/), [Dashboards de Secure](/pt-br/documentacao/plataforma/real-time-metrics/dashboards-secure/) e [Dashboards de Observe](/pt-br/documentacao/plataforma/real-time-metrics/dashboards-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: | Aba | O que define | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Quick** | Uma direção, **Last** ou **Next**; um número, mínimo 1, padrão 15; e uma unidade, padrão **Minutes**; depois **Apply**. Os presets **Commonly used** vêm em seguida. | | **Absolute**, **Relative** | Um formulário compartilhado: os campos **Start date** e **End date**, um calendário no formato `dd/mm/yy`, horários a cada 30 minutos de `00:00` a `23:30`, uma opção com o rótulo **From now** e **Apply**. | | **Now** | O botão **Set Now**. A aba informa: `Selecting 'Set Now' sets the time dynamically to the exact moment of each refresh.` | 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: | Preset | Período coberto | | ------------------- | -------------------------------------------------- | | **Today** | O dia atual, de 00:00 a 23:59:59 | | **This week** | A semana atual, de domingo 00:00 a sábado 23:59:59 | | **Last 1 minute** | 1 minuto | | **Last 5 minutes** | 5 minutos | | **Last 15 minutes** | 15 minutos | | **Last 30 minutes** | 30 minutos | | **Last 1 hour** | 1 hora | | **Last 24 hours** | 24 horas | | **Last 7 days** | 7 dias | | **Last 30 days** | 30 dias | | **Last 90 days** | 90 dias | | **Last 1 year** | 365 dias | ### 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](/pt-br/documentacao/plataforma/real-time-metrics/como-funciona/). Para saber até onde os dados alcançam no passado, consulte [Limites de Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/limites/). --- ## 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: | Controle | Valores | Padrão | | ------------------------ | --------------------------------------------------------- | ----------- | | Switch **Refresh Every** | Ativado ou desativado | Desativado | | Intervalo de atualização | Um número, mínimo 1, editável apenas com o switch ativado | 10 | | Unidade | **Seconds**, **Minutes** ou **Hours** | **Seconds** | 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](/pt-br/documentacao/guias/plataforma/observabilidade/adicionar-filtros-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.` | Controle | Rótulo | Comportamento | | -------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | | Campo | **Filter**, placeholder **Select a field** | Uma lista pesquisável dos campos do dashboard, os mais relevantes primeiro. | | Operador | **Operator**, placeholder **Select an operator** | Oculto até você escolher um campo. Quando o campo tem um único operador, ele já vem selecionado e bloqueado. | | Valor | Depende do tipo do campo | Descrito em Tipos de valor. A descrição de um campo no schema GraphQL pode aparecer como nota na entrada de valor. | | Botões | **Cancel** e **Apply** | **Apply** fica desativado até o formulário ser válido. | 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](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-metrics/). Alguns campos trazem uma lista de valores em vez de entrada livre: | Campo | Valores | | -------------------------------------------- | -------------------------------------------------------------------------------------- | | **Domain** ou **Workload** | Os workloads da sua conta. O rótulo depende de a sua conta usar domínios ou workloads. | | O campo de zona de Edge DNS | As suas zonas de Edge DNS, por nome | | O campo de função | As suas funções, por nome | | **Classified** e o campo de categoria de bot | *Legitimate*, *Good Bot*, *Bad Bot*, *Under Evaluation* | | O campo de desafio | *Solved*, *Not Solved* | | **Action** | *Allow*, *Custom HTML*, *Deny*, *Drop*, *Hold Connection*, *Random Delay*, *Redirect* | O dropdown de campos lista alguns campos primeiro, por dashboard. Os demais campos vêm em seguida, em ordem alfabética: | Dashboard | Campos listados primeiro | | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Applications**: **Data Transferred**, **Requests**, **Status Codes**, **Bandwidth Saving**; **Image Processor**: **Requests** | **Domain** ou **Workload**, **Status**, **Upstream Status**, **Upstream Cache Status**, **Request Time** | | **Tiered Cache**: **Caching Offload** | **Upstream Bytes Received**, **Status**, **Upstream Status**, **Upstream Cache Status**, **Request Time** | | **Functions**: **Invocations** | **Domain** ou **Workload**, **Edge Function Id**, **Compute Time**, **Invocations**, **Edge Functions Instance Id List** | | **Edge DNS**: **Standard Queries** | **Qtype**, **Requests**, **Source Loc Pop**, **Zone Id** | | **Data Stream**: **Data Streamed** | **Domain** ou **Workload**, **Status**, **Data Streamed**, **Endpoint Type**, **Requests** | 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: | Operador | Símbolo no chip | Forma no campo de query | Operador GraphQL | | ------------------------- | --------------- | ----------------------- | ---------------- | | **Equals** | `=` | `=` | `Eq` | | **Not Equals** | `≠` | `<>` | `Ne` | | **Contains** | `⊃` | `like` | `Like` | | **Not Contains** | `⊅` | `ilike` | `Ilike` | | **In** | `in` | `in` | `In` | | **Between** | `≤` | `between` | `Range` | | **Less Than** | `<` | `<` | `Lt` | | **Less Than or Equal** | `≤` | `<=` | `Lte` | | **Greater Than** | `>` | `>` | `Gt` | | **Greater Than or Equal** | `≥` | `>=` | `Gte` | **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](/pt-br/documentacao/devtools/graphql/recursos/#operadores). ### Tipos de valor A entrada de valor segue o tipo do campo: | Tipo de campo | Entrada de valor | | --------------------------------- | --------------------------------------------------------------------------------------------------------- | | Texto, `String` | Uma caixa de texto | | Inteiro, `Int` | Um número inteiro | | Decimal, `Float` | Um número com 2 a 5 casas decimais | | Faixa, `IntRange` ou `FloatRange` | Um par **Begin** e **End** | | Um campo com lista de valores | Uma seleção múltipla com uma caixa **Search**, ou uma seleção simples, ambas com o placeholder **Select** | 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 ` : `, 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](/pt-br/documentacao/plataforma/real-time-metrics/dashboards-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: | Mensagem | Causa | | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `please add spaces between the field, operator, and value. For example, write "status = 200" instead of "status=200".` | Uma condição não tem espaços ao redor do operador. | | `composite fields must be included in quotes. e.g: "Upstream Status".` | Um nome de campo com mais de uma palavra não está entre aspas duplas. | | `some provided fields do not match the currently available ones. Please, check and try again.` | Um campo não existe no dataset do dashboard. | | `there are fields with 'in' operator that need to be inside parentheses. Please, check and try again. e.g: domain in (domain1, domain2)` | Os valores de uma condição `in` não estão entre parênteses. | | `fields with 'in' operator that need the comma removed at the end of the values in parentheses. Please, check and try again.` | A lista de valores de uma condição `in` termina com vírgula. | | `Please enclose the values for the BETWEEN operator in parentheses. For example: status between (200, 300).` | Os valores de uma condição `between` não estão entre parênteses. | | `The BETWEEN operator requires its values to be enclosed in parentheses. For example: status between (200, 300).` | Os valores de uma condição `between` não estão entre parênteses. | | `The BETWEEN operator must have exactly two values. For example: status between (200, 300).` | Uma condição `between` tem um valor, ou mais de dois. | | `The two values for the BETWEEN operator must be different. For example: status between (200, 300).` | Uma condição `between` repete o mesmo valor. | --- ## 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. | Parte | O que mostra | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ícone de proprietário | Um ícone sem texto que indica quem é dono do gráfico: o logo da Azion, um ícone de grupo para a conta ou um ícone de pessoa para um usuário. Todo gráfico que Real-Time Metrics entrega traz o logo da Azion. | | Título | O nome do gráfico, como **Edge Offload** ou **Missed Data**. | | Botão de menu | Um botão de ícone com o rótulo **More options** que abre o menu do gráfico. | | Descrição | Um texto curto sobre o que o gráfico plota. | | Tag de agregação | **Sum** ou **Average**, com um ícone de calculadora: a agregação que a query do gráfico usa. | | Tag de variação | A variação em relação à janela anterior de mesmo tamanho, descrita em Tag de variação. | | Série | Uma categoria de dados. Por exemplo, um gráfico de requisições pode trazer uma série por domínio, cada uma delas uma linha de pontos ao longo do tempo. | | Eixo x | Em um gráfico de tempo, o período do intervalo selecionado. | | Legenda | Uma entrada por série, na forma ` - `. | | Tooltip | O nome e o valor de cada série no ponto sob o cursor, em ordem decrescente de valor. | ### 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: | Estado | O que aparece | | ------------- | --------------------------------------------------------------------------------------------------------- | | Carregando | Um placeholder no lugar do gráfico | | Sem dados | `No data available` | | Erro na query | `The chart can't be plotted. There was an issue loading the data.`, no lugar da linha da tag de agregação | --- ## 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: | Item | O que faz | | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | **Open Help Center** | Abre o artigo do Help Center do gráfico no painel lateral do Console. | | **Copy query** | Copia a query GraphQL do gráfico e as variáveis dela para a área de transferência. Não abre nada. | | **Export CSV** | Baixa um arquivo `.csv` com o nome do gráfico, com os pontos como estão plotados. | | **Show Mean Line**, **Hide Mean Line** | Desenha ou remove uma linha na média de todos os pontos. Aparece em gráficos de tempo com pelo menos uma série. | | **Show Mean Line per series**, **Hide Mean Line per series** | Desenha ou remove uma linha de média por série, para comparar séries. Aparece em gráficos de tempo com duas ou mais séries. | ### 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](/pt-br/documentacao/devtools/graphql/playground-graphql/). ### 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 - `. Uma linha de média por série calcula a mesma média para cada série, e a entrada dela mostra `Mean Line - - `. --- ## 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: | Gráfico | Aumento | Queda | Exemplo | | ----------------------------- | -------- | -------- | ----------------------------------- | | Um aumento é bom | Verde | Vermelho | **Edge Offload** | | Um aumento é ruim | Vermelho | Verde | **Missed Data** | | Nenhuma direção é boa ou ruim | Azul | Azul | **Good Bot Hits**, **Transactions** | 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 - [Filtre um dashboard de Real-Time Metrics](/pt-br/documentacao/guias/plataforma/observabilidade/adicionar-filtros-metrics.md): Os passos para adicionar, editar e remover um filtro em um dashboard. - [Exporte os dados e a query de um gráfico](/pt-br/documentacao/guias/plataforma/observabilidade/analisar-metricas.md): Os passos para exportar um gráfico como CSV e rodar a query dele fora do Console. - [Dashboards de Build](/pt-br/documentacao/plataforma/real-time-metrics/dashboards-build.md): Cada dashboard de Build, o dataset dele e o que cada gráfico plota. - [Limites de Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/limites.md): Até onde o intervalo de tempo alcança no passado, o limite de séries e os outros limites.