Share via

Parametry czasu skoroszytu

  • Artykuł

Za pomocą parametrów czasu można ustawić kontekst czasu analizy, który jest używany przez prawie wszystkie raporty. Parametry czasu są proste do skonfigurowania i użycia. Można ich użyć do określenia zakresów czasu, które mają być wyświetlane na liście rozwijanej. Można również utworzyć niestandardowe zakresy czasu.

Tworzenie parametru czasu

  1. Zacznij od pustego skoroszytu w trybie edycji.

  2. Wybierz pozycję Dodaj parametry>Dodaj parametr.

  3. W otwartym okienku nowego parametru wprowadź:

    • Nazwa parametru: TimeRange
    • Typ parametru: Time range picker
    • Wymagane: checked
    • Dostępne zakresy czasu: Last hour, , Last 12 hours, Last 48 hoursLast 24 hours, Last 3 days, Last 7 days, i Allow custom time range selection.

  4. Wybierz pozycję Zapisz , aby utworzyć parametr.

    Screenshot that shows a time range parameter in read mode.

Tak wygląda skoroszyt w trybie odczytu.

Odwołanie do parametru czasu

Można odwoływać się do parametrów czasu z powiązaniami, KQL lub tekstem.

Odwołanie do parametru czasu z powiązaniami

  1. Wybierz pozycję Dodaj zapytanie, aby dodać kontrolkę zapytania, a następnie wybierz zasób Application Szczegółowe informacje.

  2. Większość kontrolek skoroszytu obsługuje selektor zakresu zakresu czasu. Otwórz listę rozwijaną Zakres czasu i wybierz {TimeRange} grupę Parametry zakresu czasu u dołu:

    • Ta kontrolka wiąże parametr zakresu czasu z zakresem czasu wykresu.
    • Zakres czasu przykładowego zapytania wynosi teraz Ostatnie 24 godziny.

  3. Uruchom zapytanie, aby wyświetlić wyniki.

    Screenshot that shows a time range parameter referenced via bindings.

Odwołanie do parametru czasu za pomocą języka KQL

  1. Wybierz pozycję Dodaj zapytanie, aby dodać kontrolkę zapytania, a następnie wybierz zasób Application Szczegółowe informacje.

  2. Otwórz listę rozwijaną Zakres czasu i wybierz Set in query pozycję w grupie Zakres czasu. W języku KQL wprowadź filtr zakresu czasu przy użyciu parametru | where timestamp {TimeRange}:

    • Ten parametr rozszerza czas oceny zapytania na | where timestamp > ago(1d)wartość .
    • Ta opcja jest wartością zakresu czasu parametru.

  3. Uruchom zapytanie, aby wyświetlić wyniki.

    Screenshot that shows a time range referenced in KQL.

Odwołanie do parametru czasu w tekście

  1. Dodaj kontrolkę tekstową do skoroszytu.
  2. W języku Markdown wprowadź ciąg The chosen time range is {TimeRange:label}.
  3. Wybierz pozycję Zakończono edytowanie.
  4. Kontrolka tekstu pokazuje tekst Wybrany zakres czasu to Ostatnie 24 godziny.

Opcje parametrów czasu

Parametr Opis Przykład
{TimeRange} Etykieta zakresu czasu Ostatnie 24 godziny
{TimeRange:label} Etykieta zakresu czasu Ostatnie 24 godziny
{TimeRange:value} Wartość zakresu czasu > ago (1d)
{TimeRange:query} Zapytanie zakresu czasu > ago (1d)
{TimeRange:start} Czas rozpoczęcia zakresu czasu 20.03.2019 16:18
{TimeRange:end} Czas zakończenia zakresu czasu 21.03.2019 16:18
{TimeRange:grain} Ziarno zakresu czasu 30 m

Używanie opcji parametrów w zapytaniu

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

Następne kroki

Wprowadzenie do skoroszytów platformy Azure