Share via

Parámetros temporales de los libros

  • Artículo

Con los parámetros temporales, puede establecer el contexto de tiempo del análisis, que usan casi todos los informes. Los parámetros temporales son sencillos de configurar y usar. Puede usarlos para especificar los intervalos de tiempo que se mostrarán en una lista desplegable. También puede crear intervalos de tiempo personalizados.

Creación de un parámetro temporal

  1. Comience con un libro vacío en modo de edición.

  2. Seleccione Agregar parámetros>Agregar parámetro.

  3. En el panel de nuevo parámetro que se abre, escriba:

    • Nombre del parámetro: TimeRange
    • Tipo de parámetro: Time range picker
    • Obligatorio: checked
    • Intervalos de tiempo disponibles: Last hour, Last 12 hours, Last 24 hours, Last 48 hours, Last 3 days, Last 7 days y Allow custom time range selection.

  4. Seleccione Guardar para crear el parámetro.

    Screenshot that shows a time range parameter in read mode.

Este es el aspecto del libro en modo de lectura.

Referencia a un parámetro temporal

Puede hacer referencia a parámetros temporales con enlaces, KQL o texto.

Referencia a un parámetro temporal con enlaces

  1. Seleccione Agregar consulta para agregar un control de consulta y, a continuación, seleccione un recurso de Application Insights.

  2. La mayoría de los controles de libro admiten un selector de ámbito de Intervalo de tiempo. Abra la lista desplegable Intervalo de tiempo y seleccione {TimeRange} en el grupo Parámetros de intervalo de tiempo de la parte inferior:

    • Este control enlaza el parámetro de intervalo de tiempo con el intervalo de tiempo del gráfico.
    • El ámbito de tiempo de la consulta de ejemplo es ahora Últimas 24 horas.

  3. Ejecute la consulta para ver los resultados.

    Screenshot that shows a time range parameter referenced via bindings.

Referencia a un parámetro con KQL

  1. Seleccione Agregar consulta para agregar un control de consulta y, a continuación, seleccione un recurso de Application Insights.

  2. Abra la lista desplegable Intervalo de tiempo y seleccione en Set in query el grupo Intervalo de tiempo. En KQL, escriba un filtro de ámbito de tiempo mediante el parámetro: | where timestamp {TimeRange}.

    • Este parámetro amplía el tiempo de evaluación de la consulta a | where timestamp > ago(1d).
    • Esta opción es el valor del intervalo de tiempo del parámetro.

  3. Ejecute la consulta para ver los resultados.

    Screenshot that shows a time range referenced in KQL.

Referencia a un parámetro de tiempo en el texto

  1. Agregue un control de texto al libro.
  2. En Markdown, escriba The chosen time range is {TimeRange:label}.
  3. Seleccione Edición finalizada.
  4. El control de texto muestra el texto El intervalo de tiempo elegido es Últimas 24 horas.

Opciones de parámetro temporal

Parámetro Descripción Ejemplo
{TimeRange} Etiqueta de intervalo de tiempo Últimas 24 horas
{TimeRange:label} Etiqueta de intervalo de tiempo Últimas 24 horas
{TimeRange:value} Valor de intervalo de tiempo > ago (1d)
{TimeRange:query} Consulta de intervalo de tiempo > ago (1d)
{TimeRange:start} Hora de inicio del intervalo de tiempo 3/20/2019 4:18 PM
{TimeRange:end} Hora de finalización del intervalo de tiempo 3/21/2019 4:18 PM
{TimeRange:grain} Grano del intervalo de tiempo 30 m

Uso de opciones de parámetros en una consulta

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

Pasos siguientes

Introducción a Libros de Azure