Udostępnij za pośrednictwem

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.

    Zrzut ekranu przedstawiający parametr zakresu czasu w trybie odczytu.

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 usługi Application Insights.

  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.

    Zrzut ekranu przedstawiający parametr zakresu czasu, do którego odwołuje się powiązanie.

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 usługi Application Insights.

  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.

    Zrzut ekranu przedstawiający zakres czasu, do którego odwołuje się 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