Variáveis de modelo: painel de filtro dinamicamente

Primeiro, você definirá uma variável de modelo. Esta é a variável que você usará em uma consulta NRQL para criar um widget.

Para definir uma variável:

1. Em um novo dashboard sem variáveis, clique no botão editar botão e, em seguida, clique no botão + Add variable localizado no canto superior esquerdo. Depois de terminar de adicionar variáveis, clique em Done editing.

   Se o dashboard incluir widget, clique no botão + Add variable.

   

2. Conclua o fluxo de trabalho Add variable . Abaixo estão algumas regras e dicas para cada um dos campos.

   Campo	Detalhes
   Nome para usar na consulta	O nome da variável. Isto é o que você usará na consulta, cercado por {{...}}. Por exemplo, se você usar country aqui como nome, ao escrever uma consulta você chamará a variável com {{country}}. Os nomes das variáveis devem começar com uma letra e podem conter letras, números e sublinhados.
   Nome de exibição	Opcional. É assim que a variável será exibida acima do dashboard para que o usuário dashboard saiba o que a variável representa. Se for deixado em branco, usará o valor do nome principal.
   Tipo	Existem três opções: Query: você pode escrever uma consulta que retornará uma lista dinâmica de opções usadas no menu dropdown . Por exemplo, a consulta a seguir retornaria uma lista dinâmica de valores country : SELECT uniques(countryCode) FROM PageAction since 2 days ago Copiar Para regras e dicas sobre como escrever consultas, consulte variáveis do tipo consulta. List: uma lista de valores separados por vírgula usados para preencher as opções no menu dropdown . Por exemplo, você poderia definir manualmente uma lista de valores country usando uma lista como: ES, US, CA. Text field: em vez de uma dropdown de valores para escolher, isso permite que o usuário dashboard filtre qualquer texto inserido.
   Conta	Presente apenas para o tipo query . Para organizações com múltiplas contas, define a conta que é consulta.
   Consulta	Escreva aqui sua consulta usando uniques (attribute).
   Ignorar seletor de hora	Opcional. Presente apenas para o tipo de consulta. Ao desativar esta opção, a consulta será executada utilizando o valor do seletor de hora selecionado no dashboard. Dessa forma, quando o valor do seletor de hora mudar, os resultados do dropdown da variável responderão dinamicamente ao novo intervalo de tempo selecionado.
   Seleção múltipla	Opcional. Esta opção permite um dropdown para permitir múltiplas seleções ao mesmo tempo, em vez de uma única seleção.
   Valores padrão	Opcional. Estes são os valores padrão que o dashboard irá filtrar. Por exemplo, se você usasse a consulta country acima, poderia inserir ES como o valor padrão e o dashboard filtraria automaticamente esse valor. Você também pode selecionar todas as possibilidades. Para usar vários valores em uma cláusula WHERE você precisa usar IN em vez de =.
   Formato de saída	Isso permite alterar a forma como os dados gerados pela variável são tratados na consulta. A opção selecionada aqui está relacionada à consulta que você adicionará posteriormente no widget. A opção default é string porque é a opção mais comum usada na maioria das consultas. Você pode alterar a opção default para uma destas: String : use isto para valores de texto não numéricos. Number : use isto para valores numéricos. Identifier : use isto quando quiser substituir partes da consulta, como nomes de eventos ou nomes de facetas.

   Veja este exemplo de como seria uma variável de modelo para valores country :

   

   Depois de definir sua variável de modelo, você poderá adicionar um widget que use sua variável de modelo criada.

Depois de configurar uma variável de modelo, você precisará de um widget em um dashboard que use a variável que você definiu em sua consulta.

Para criar um widget:

1. No dashboard , clique no botão + Add widget localizado no canto superior direito.

2. Existem 2 opções:

   • Adicione um gráfico. Você criará seu widget usando o criador de consulta.
   • Adicione texto, imagens ou links. Você criará seu widget adicionando seu próprio conteúdo usando nosso editor Markdown.

3. Escolhemos a opção Add a chart .

4. Adicione sua consulta e clique em Run.

   Seguindo nosso exemplo mencionado na etapa 1:

   SELECT countryCode FROM PageAction WHERE countryCode IN ({{countryCode}})

   Copiar
   

   Observe que estas são as cláusulas NRQL que aceitarão variáveis de modelo como valores: SELECT, FROM, FACET, ORDER BY e WHERE.

   Em vez disso, a seguinte lista de cláusulas NRQL não aceitará variáveis de modelo como argumentos: AS, COMPARE WITH, LIMIT, OFFSET, SINCE, SLIDE BY, TIMESERIES, UNTIL e WITH....

5. Clique Save

Você pode ativar a opção de vários valores na seção de opções de exibição ao criar uma variável do tipo NRQL/ENUM.

Aqui está um exemplo de consulta que cria uma variável chamada {{MultiValue}} e retorna uma lista de todos os eventIds exclusivos:

SELECT uniques(eventId) FROM AjaxRequest

Então você criaria um widget com a seguinte consulta:

SELECT count(*) FROM AjaxRequest WHERE eventId IN ({{MultiValue}})

Você pode definir apenas uma variável de modelo por vez, mas pode usar mais de uma variável de modelo em um único widget.

Aqui está um exemplo de consulta que usa duas variáveis de modelo. Observe que isso pressupõe que as variáveis de modelo countryCode e city já tenham sido criadas e que tenham um único valor.

SELECT countryCode, city FROM PageAction WHERE countryCode = {{countryCode}} and city = {{city}}

Se você tiver vários valores para suas variáveis, como Chicago, New York, Paris para sua variável city , será necessário usar IN:

SELECT countryCode, city FROM PageAction WHERE countryCode IN ({{countryCode}}) and city IN ({{city}})

Usando variáveis e regex, você pode criar um filtro, desde que tenha certeza de que uma parte do filtro foi corrigida.

Você precisa usar esta correspondência parcial se quiser usar like.

Digamos que você queira filtrar por versão de lançamento. A consulta retorna algo como: release-1234.

Você pode criar uma variável usando aparse para analisar o número da versão:

SELECT uniques(aparse(platformVersion , 'release-*')) FROM PageView

Em seguida, crie um widget com a seguinte consulta:

SELECT count(*) FROM PageAction WHERE aparse(platformVersion, 'release-*') IN ({{releaseversion}}) facet platformVersion

Ou se preferir, você pode usar o comando capture :

SELECT count(*) FROM PageAction WHERE capture(platformVersion, r'release-(?P<platformVersion>\d+)') IN ({{releaseversion}}) Facet platformVersion

Você pode usar LIKE e RLIKE como variáveis de modelo para filtrar dados em um dashboard. Para usar esse recurso, o valor adicionado ao criar a variável de modelo deve usar os símbolos curinga % no início e no final do valor.

Aqui está um exemplo. Você define uma variável de string, conforme mostrado aqui:

Você pode então criar um gráfico de widget e usar sua variável assim:

FROM NrdbQuery SELECT user WHERE user LIKE {{like_filter}}

ou assim:

FROM NrdbQuery SELECT user WHERE user RLIKE {{like_filter}}

Você pode criar uma variável do tipo NRQL com um formato de saída de string e usá-la após uma cláusula facet para agrupar por valores diferentes.

Por exemplo, você pode criar uma variável chamada {{userAgentName}} com a seguinte aparência:

SELECT uniques(userAgentName) FROM PageAction

Então você criaria um widget com a seguinte consulta:

SELECT count(*) FROM PageAction WHERE userAgentName={{userAgentName}} FACET userAgentName

Você pode criar uma variável com formato de saída identifier e usá-la após uma cláusula FACET para agrupar por valores diferentes.

Por exemplo, você pode criar uma variável {{location}} do tipo lista com dois valores possíveis: countryCode e city. Você definiria o formato de saída como identifier.

Então você criaria um widget com a seguinte consulta:

SELECT count(*) FROM PageAction FACET {{location}}

Você pode criar uma variável com formato de saída number e usá-la dentro de uma função percentil.

Por exemplo, você poderia criar uma variável {{percentile}} do tipo list com dois valores possíveis: 55 e 90. Você deseja definir o formato de saída como number.

Então você criaria um widget com a seguinte consulta:

SELECT percentile(duration,{{percentile}}) FROM PageAction

Para usar variáveis para filtragem você só precisa adicionar a variável criada no lado direito de uma cláusula WHERE , assim:

SELECT countryCode, city FROM PageAction WHERE countryCode IN ({{countryCode}})

Por padrão, a opção “ignorar seletor de hora” está habilitada, o que significa que a consulta é sempre executada usando o valor padrão do intervalo de tempo 1 HOUR, mesmo que o seletor de hora no dashboard tenha um valor diferente selecionado (ex. 5 minutos). , 3 horas, etc.). A exceção para esse caso é quando a consulta possui um intervalo de tempo explícito definido com uma cláusula SINCE , como por exemplo:

SELECT uniques(eventId) 
FROM AjaxRequest 
SINCE 5 minutes ago

Os resultados estarão no intervalo dos últimos 5 minutos.

Quando a opção “ignorar seletor de hora” estiver desligada, a consulta será executada com o valor selecionado no seletor de hora. Por exemplo, se você definir o seletor de hora para 30 minutos, como na captura de tela abaixo, no formulário de edição de variáveis, o campo "ignorar seletor de hora" ficará desativado.

Isso resulta nos valores dos últimos 30 minutos. Quando você define o valor do seletor de hora como Default e sua consulta tem uma cláusula SINCE , o valor mais recente será usado para executar a consulta.