Parametri temporali della cartella di lavoro

Con i parametri temporali, è possibile impostare il contesto temporale dell'analisi, che viene usato in quasi tutti i report. I parametri temporali sono semplici da configurare e usare. È possibile usarli per specificare gli intervalli di tempo da visualizzare in un elenco a discesa. È anche possibile creare intervalli di tempo personalizzati.

Creare un parametro temporale

  1. Iniziare con una cartella di lavoro vuota in modalità di modifica.

  2. Selezionare Aggiungi parametri>Aggiungi parametro.

  3. Nel riquadro del nuovo parametro che viene aperto, immettere:

    • Nome parametro: TimeRange
    • Tipo di parametro: Time range picker
    • Obbligatorio: checked
    • Intervalli di tempo disponibili : Last hour, Last 12 hours, Last 24 hours, Last 48 hours, Last 3 days, Last 7 days e Allow custom time range selection.
  4. Selezionare Salva per creare il parametro.

    Screenshot che mostra un parametro relativo a un intervallo di tempo in modalità di lettura.

Questa è l'aspetto della cartella di lavoro in modalità di lettura.

Fare riferimento a un parametro temporale

È possibile fare riferimento a parametri temporali con associazioni, query KQL o testo.

Fare riferimento a un parametro temporale con associazioni

  1. Selezionare Aggiungi query per aggiungere un controllo query e quindi selezionare una risorsa di Application Insights.

  2. La maggior parte dei controlli delle cartelle di lavoro supporta una selezione ambito Intervallo di tempo. Aprire l'elenco a discesa Intervallo di tempo e selezionare {TimeRange} nel gruppo Parametri intervallo di tempo nella parte inferiore:

    • Questo controllo associa il parametro dell'intervallo di tempo all'intervallo di tempo del grafico.
    • L'ambito temporale della query di esempio è ora Ultime 24 ore.
  3. Eseguire la query per visualizzare i risultati.

    Screenshot che mostra un parametro relativo a un intervallo di tempo a cui si fa riferimento tramite associazioni.

Fare riferimento a un parametro temporale con query KQL

  1. Selezionare Aggiungi query per aggiungere un controllo query e quindi selezionare una risorsa di Application Insights.

  2. Aprire l'elenco a discesa Intervallo di tempo e selezionare Set in query nel gruppo Intervallo di tempo. Nella query KQL immettere un filtro per l'ambito temporale usando il parametro | where timestamp {TimeRange}:

    • Questo parametro si espande in base al tempo di valutazione della query, fino a | where timestamp > ago(1d).
    • Questa opzione è il valore dell'intervallo di tempo del parametro.
  3. Eseguire la query per visualizzare i risultati.

    Screenshot che mostra un intervallo di tempo a cui si fa riferimento nella query KQL.

Fare riferimento a un parametro temporale nel testo

  1. Aggiungere un comando di testo alla cartella di lavoro.
  2. In Markdown immettere The chosen time range is {TimeRange:label}.
  3. Selezionare Modifica completata.
  4. Il comando di testo mostra il testo L'intervallo di tempo scelto è Ultime 24 ore.

Opzioni del parametro temporale

Parametro Descrizione Esempio
{TimeRange} Etichetta dell’intervallo di tempo Ultime 24 ore
{TimeRange:label} Etichetta dell’intervallo di tempo Ultime 24 ore
{TimeRange:value} Valore dell'intervallo di tempo > fa (1 g)
{TimeRange:query} Query basata su un intervallo di tempo > fa (1 g)
{TimeRange:start} Ora di inizio dell'intervallo di tempo 3/20/2019 16:18
{TimeRange:end} Ora di fine dell'intervallo di tempo 3/21/2019 16:18
{TimeRange:grain} Intervallo dell’intervallo di tempo 30 m

Usare le opzioni dei parametri in una query

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

Passaggi successivi

Iniziare a utilizzare Cartelle di lavoro di Azure