Parâmetros de tempo da pasta de trabalho

  • Artigo

Com parâmetros de tempo, você pode definir o contexto de tempo de análise, que é usado por quase todos os relatórios. Os parâmetros de tempo são simples de configurar e usar. Você pode usá-los para especificar os intervalos de tempo a serem exibidos em uma lista suspensa. Você também pode criar intervalos de tempo personalizados.

Criar um parâmetro de tempo

  1. Comece com uma pasta de trabalho vazia no modo de edição.

  2. Selecione Adicionar parâmetros>Adicionar parâmetro.

  3. No novo painel de parâmetros que se abre, introduza:

    • Nome do parâmetro: TimeRange
    • Tipo de parâmetro: Time range picker
    • Obrigatório: checked
    • Intervalos de tempo disponíveis: Last hour, , , Last 12 hoursLast 24 hours, , Last 7 daysLast 48 hoursLast 3 dayse .Allow custom time range selection

  4. Selecione Salvar para criar o parâmetro.

    Screenshot that shows a time range parameter in read mode.

Esta é a aparência da pasta de trabalho no modo de leitura.

Referenciar um parâmetro de tempo

Você pode fazer referência a parâmetros de tempo com associações, KQL ou texto.

Referenciar um parâmetro de tempo com ligações

  1. Selecione Adicionar consulta para adicionar um controle de consulta e, em seguida, selecione um recurso do Application Insights.

  2. A maioria dos controles de pasta de trabalho oferece suporte a um seletor de escopo de intervalo de tempo. Abra a lista suspensa Intervalo de tempo e selecione o {TimeRange} no grupo Parâmetros do intervalo de tempo na parte inferior:

    • Esse controle vincula o parâmetro de intervalo de tempo ao intervalo de tempo do gráfico.
    • O escopo de tempo da consulta de exemplo agora é Últimas 24 horas.

  3. Execute a consulta para ver os resultados.

    Screenshot that shows a time range parameter referenced via bindings.

Referenciar um parâmetro de tempo com KQL

  1. Selecione Adicionar consulta para adicionar um controle de consulta e, em seguida, selecione um recurso do Application Insights.

  2. Abra a lista suspensa Intervalo de tempo e selecione o Set in queryno grupo Intervalo de tempo. No KQL, insira um filtro de escopo de tempo usando o parâmetro | where timestamp {TimeRange}:

    • Este parâmetro expande o tempo de avaliação da consulta para | where timestamp > ago(1d).
    • Esta opção é o valor do intervalo de tempo do parâmetro.

  3. Execute a consulta para ver os resultados.

    Screenshot that shows a time range referenced in KQL.

Fazer referência a um parâmetro de tempo no texto

  1. Adicione um controle de texto à pasta de trabalho.
  2. No Markdown, insira The chosen time range is {TimeRange:label}.
  3. Selecione Edição Concluída.
  4. O controle de texto mostra o texto O intervalo de tempo escolhido é Últimas 24 horas.

Opções de parâmetros de tempo

Parâmetro Description Exemplo
{TimeRange} Rótulo de intervalo de tempo Últimas 24 horas
{TimeRange:label} Rótulo de intervalo de tempo Últimas 24 horas
{TimeRange:value} Valor do intervalo de tempo > ago (1d)
{TimeRange:query} Consulta de intervalo de tempo > ago (1d)
{TimeRange:start} Hora de início do intervalo de tempo 20/03/2019 16:18
{TimeRange:end} Hora de fim do intervalo de tempo 21/03/2019 16:18
{TimeRange:grain} Grãos de intervalo de tempo 30 metros

Usar opções de parâmetro em uma consulta

requests
| make-series Requests = count() default = 0 on timestamp from {TimeRange:start} to {TimeRange:end} step {TimeRange:grain}

Próximos passos

Introdução às Pastas de Trabalho do Azure