從工作簿固定時，Azure 儀表板未使用新時間范圍更新

Question

我想可視化 map 中的一些數據，因此我使用了工作簿。 我沒有在查詢中設置時間范圍，因為時間范圍應該可以在儀表板中配置。 將特定磁貼固定到儀表板后，map 在時間范圍更改時不會更新。 當我更改工作簿中的時間范圍時，它按預期工作。

請找到我在工作簿中嘗試過的 Kusto 查詢：

let mainTable = union customEvents
    | extend name =replace("\n", "", name)
    | where iif('*' in ("*"), 1 == 1, name in ("*"))
    | where true;
let queryTable = mainTable;
let cohortedTable = queryTable
    | extend dimension = client_CountryOrRegion
    | extend dimension = iif(isempty(dimension), "<undefined>", dimension)
    | summarize hll = hll(itemId) by tostring(dimension)
    | extend Events = dcount_hll(hll)
    | order by Events desc
    | serialize rank = row_number()
    | extend dimension = iff(rank > 5, 'Other', dimension)
    | summarize merged = hll_merge(hll) by tostring(dimension)
    | project ['Country or region'] = dimension, Counts = dcount_hll(merged);
cohortedTable

您對此的意見非常有幫助。 提前致謝

Answer 1

為了在儀表板時間范圍更新時更新查詢，工作簿中的查詢需要使用時間范圍參數：

https://docs.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-overview#dashboard-time-ranges

如果將固定項目配置為使用時間范圍參數，則固定工作簿查詢部分將遵循儀表板的時間范圍。 儀表板的時間范圍值將用作時間范圍參數的值，儀表板時間范圍的任何更改都會導致固定項更新。 如果固定部件正在使用儀表板的時間范圍，您將看到固定部件的副標題更新，以在時間范圍更改時顯示儀表板的時間范圍。

此外，使用時間范圍參數的固定工作簿部件將以儀表板的時間范圍確定的速率自動刷新。 上次運行查詢的時間將出現在固定部分的副標題中。

如果固定步驟具有明確設置的時間范圍（不使用時間范圍參數），則無論儀表板的設置如何，該時間范圍將始終用於儀表板。 固定部分的副標題不會顯示儀表盤的時間范圍，查詢不會在儀表盤上自動刷新。 副標題將顯示查詢最后一次執行的時間。

您需要更新工作簿以具有時間范圍參數，然后更新該查詢步驟以在查詢文本中使用該時間范圍參數，例如

let mainTable = union customEvents
    | where timestamp {TimeRange}  // reference the time range parameter in the query text
    | extend name =replace("\n", "", name)
    | where iif('*' in ("*"), 1 == 1, name in ("*"))
    | where true;
let queryTable = mainTable;
let cohortedTable = queryTable
    | extend dimension = client_CountryOrRegion
    | extend dimension = iif(isempty(dimension), "<undefined>", dimension)
    | summarize hll = hll(itemId) by tostring(dimension)
    | extend Events = dcount_hll(hll)
    | order by Events desc
    | serialize rank = row_number()
    | extend dimension = iff(rank > 5, 'Other', dimension)
    | summarize merged = hll_merge(hll) by tostring(dimension)
    | project ['Country or region'] = dimension, Counts = dcount_hll(merged);
cohortedTable

或者通過在編輯查詢時從 UX 中的時間范圍下拉列表中選擇時間范圍參數（對於基於日志的查詢，如果這是對時間范圍不是 ux 中的字段的 ADX 數據源的查詢，您必須在查詢文本中使用時間范圍參數）

如果您將使用此類查詢（引用時間范圍參數）的查詢步驟固定到儀表板，則儀表板知道如何將儀表板的時間范圍“注入”到查詢中。 （如果沒有時間范圍參數，我們可以嘗試多種（天真的）方法來嘗試注入時間范圍，但取決於查詢的確切作用，查詢有可能有效但不正確）

有關如何使用時間范圍參數的詳細信息，請參閱上面的時間范圍參數鏈接，以及可用的各種語法，有一些方法可以獲取參數中時間范圍的開始、結束、持續時間、分桶等內容句法。