全部產品
Search

搜尋本產品

    Simple Log Service：跨時序庫（Metricstore）查詢

    文件中心

    Simple Log Service：跨時序庫（Metricstore）查詢

    更新時間：Jun 08, 2026

    時序型資料檢視（StoreView） 支援時序庫（Metricstore）聯集查詢。本文介紹如何利用PromQL語句在StoreView中進行資料查詢、StoreView如何對接Grafana以及如何使用API介面擷取StoreView資訊。

    使用前提

    已建立Project和MetricStore。具體操作，請參見管理Project和管理MetricStore。

    關聯時序庫（Metricstore）建立時序資料檢視（StoreView）

    1. 建立時序型資料檢視

    1. 登入Log Service控制台，在Project列表，單擊開啟目標Project。

    2. 在左側導覽列選擇資料檢視 > 時序型資料檢視，進入資料檢視頁面後單擊image建立時序型資料檢視。

    3. 在建立資料檢視面板，參考下圖，輸入Storeview名稱，並添加關聯的Metricstore，然後單擊確定。

      重要

      • 在時序型資料檢視（StoreView）中，必須包含一個同Project下的時序庫。

      • 時序資料檢視（Storeview） 支援多Store聯集查詢分析能力，為保證查詢分析結果正確性，有以下兩個建議：

        • 不建議將存在重複時間軸的Metricstore關聯在同一個StoreView中。

        • 不建議將多個資料量龐大（例如，時序庫的Shard已大於64）的Metricstore關聯在一起執行計算。

      將Storeview 類型選擇為Metric。

    2. 使用PromQL語句查詢資料檢視

    說明

    • 時序型資料檢視（Storeview）中關聯多個Metricstore後，查詢分析結果將展示跨多個時序庫的計算處理結果。

    • 時序型資料檢視（Storeview）不支援使用SQL和預定義處理。支援直接在查詢方塊中輸入PromQL語句，後端計算引擎會自行完成跨多個時序庫的計算處理。

    在左側資料集面板中選擇 test 資料集，在查詢編輯器中輸入 PromQL 語句 cpu_count{}，然後單擊右上方 立即執行 按鈕，運行結果地區將展示對應的指標折線圖。

    時序型資料檢視（StoreView）對接Grafana

    1. 安裝Grafana後登入Grafana。在左側導覽列，選擇Configuration > Data Sources。

    2. 在Data Sources頁簽，單擊Add data source。然後選擇Prometheus，單擊Select。

    3. 在Settings頁簽中，請參考如下說明配置資料來源。

      配置資料來源參數說明

      參數

      說明

      Name

      請您自訂一個資料來源的名稱，例如Prometheus-1。

      HTTP

      • URL：Log ServiceStoreView的URL，格式為https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}。其中{sls-endpoint}為Project所在地區的Endpoint，{project}和{storeview}為您已建立的Log Service的Project和StoreView，請根據實際值替換。例如：https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/test。

        說明

        為保證傳輸安全性，請務必設定為https。

      • Whitelisted Cookies：添加訪問白名單，可選。

      Auth

      開啟Basic auth開關。

      Basic Auth Details

      • User為阿里雲帳號AccessKeyID。

      • Password為阿里雲帳號AccessKeySecret。

      建議您使用僅具備指定Project唯讀許可權的RAM使用者帳號，詳情請參見指定Project唯讀授權策略。

    4. 單擊Save & Test。

    StoreView HTTP API介面

    概述

    Log Service提供多個用於查詢時序型資料檢視（StoreView）的API，這些API相容Prometheus開源協議。Prometheus所提供的介面都在/api/v1目錄下，StoreView相關的API同樣遵循此規則，其完整的URL為https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/。

    變數

    是否必填

    說明

    {project}

    是

    Log ServiceProject名稱，更多資訊，請參見管理Project。

    {sls-endpoint}

    是

    Project所在地區的Endpoint。

    {storeview}

    是

    建立的StoreView。

    時序指標查詢API

    Instant Queries API

    Instant Queries API用於查詢指定時間點的指標資料。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query

    參數說明如下表所示。

    變數

    是否必填

    說明

    query

    是

    具體的PromQL語句。更多資訊，請參見PromQL文法。

    time

    否

    執行查詢的時間點，Unix時間戳記格式，精確到秒。預設為最新時間。

    timeout

    否

    執行查詢的逾時時間，單位：秒。

    同時支援1s、2m、3h、4d等用法，例如：timeout=10s。更多資訊，請參見Time Durations。

    lookback_delta

    否

    可用於自訂設定Prometheus中query.lookback-delta這項flag參數值，僅對當次Query有效。該參數值需遵循Time Durations用法，例如：lookback_delta=1m，更多資訊請參見Time Durations。此參數表示PromQL計算中尋點過程的最大回溯區間，SLS時序庫中該值預設為"3m"。

    Range Queries API

    Range Queries API用於查詢指定時間範圍內多個時間點的指標資料。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range

    參數說明如下表所示。

    變數

    是否必填

    說明

    query

    是

    具體的PromQL語句。更多資訊，請參見PromQL文法。

    start

    否

    查詢的起始時間點，Unix時間戳記格式，精確到秒。

    end

    否

    查詢的截止時間點，Unix時間戳記格式，精確到秒。

    step

    否

    執行查詢的間隔時間，單位：秒。

    同時支援1s、2m、3h、4d等用法，例如：step=2m。更多資訊，請參見Time Durations。

    timeout

    否

    執行查詢的逾時時間，單位：秒。

    同時支援1s、2m、3h、4d等用法，例如：timeout=10s。更多資訊，請參見Time Durations。

    lookback_delta

    否

    可用於自訂設定Prometheus中query.lookback-delta這項flag參數值，僅對當次Query有效。該參數值需遵循Time Durations用法，例如：lookback_delta=1m，更多資訊請參見Time Durations。此參數表示PromQL計算中尋點過程的最大回溯區間，SLS時序庫中該值預設為"3m"。

    配置樣本，請參考時序指標查詢API。

    中繼資料查詢API

    Query Series API

    Query Series API用於查詢指定時間段內特定條件下的所有StoreView以及該StoreView下所有的Label數值對。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series

    參數說明如下表所示。

    變數

    是否必填

    說明

    match[]

    是

    篩選條件，例如：match[]=up{instance="demo.*"}。

    您可以設定一個或多個值。

    start

    否

    查詢的起始時間點，Unix時間戳記格式，精確到秒。

    預設為目前時間的5分鐘之前。

    end

    否

    查詢的截止時間點，Unix時間戳記格式，精確到秒。

    預設為目前時間。

    重要

    如果start和end參數都是自訂的，該API也只支援查詢end時間點之前5分鐘的資料，即查詢 (end - 5 minute, end) 區間內的資料。

    x-sls-disable-range-limit

    否

    參數值為true表示放開前述的5分鐘查詢限制，以傳入的start與end為準。

    forceMaxMetaTimeRangeSeconds

    否

    參數單位為秒，該參數值用於限制最大的查詢範圍，當 (end - start) > forceMaxMetaTimeRangeSeconds 時會將查詢範圍對齊到 (end-forceMaxMetaTimeRangeSeconds, end) 。

    為了查詢效率考慮，建議預設附帶此項參數。

    Query Label Names API

    查詢指定時間段內特定條件下所有的LabelName。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels

    參數說明如下表所示。

    變數

    是否必填

    說明

    match[]

    是

    篩選條件，例如：match[]=up{instance="demo.*"}。

    您可以設定零個、一個或多個值。

    start

    否

    查詢區間的起始時間點，Unix時間戳記格式，精確到秒。

    預設為目前時間的5分鐘之前。

    end

    否

    查詢區間的截止時間點，Unix時間戳記格式，精確到秒。

    預設為目前時間。

    重要

    如果start和end參數都是自訂的，該API也只支援查詢end時間點之前5分鐘的資料，即查詢 (end - 5 minute, end) 區間內的資料。

    x-sls-disable-range-limit

    否

    參數值為true表示放開前述的5分鐘查詢限制，以傳入的start與end為準。

    forceMaxMetaTimeRangeSeconds

    否

    參數單位為秒，該參數值用於限制最大的查詢範圍，當 (end - start) > forceMaxMetaTimeRangeSeconds 時會將查詢範圍對齊到 (end-forceMaxMetaTimeRangeSeconds, end) 。

    為了查詢效率考慮，建議預設附帶此項參數。

    Query Label Values API

    Query Label Values API用於查詢指定時間段內特定條件以及特定LabelName下所有的LabelValue資訊。

    重要

    該介面URL中的<label_name>需替換為具體的LabelName。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/label/<label_name>/values

    參數說明如下表所示。

    變數

    是否必填

    說明

    match[]

    是

    篩選條件，例如：match[]=up{instance="demo.*"}。

    您可以設定一個或多個值。

    start

    否

    查詢的起始時間點，Unix時間戳記格式，精確到秒。

    預設為目前時間的5分鐘之前。

    end

    否

    查詢區間的截止時間點，Unix時間戳記格式，精確到秒。

    預設為目前時間。

    重要

    如果start和end參數都是自訂的，該API也只支援查詢end時間點之前5分鐘的資料，即查詢 (end - 5 minute, end) 區間內的資料。

    x-sls-disable-range-limit

    否

    參數值為true表示放開前述的5分鐘查詢限制，以傳入的start與end為準。

    forceMaxMetaTimeRangeSeconds

    否

    參數單位為秒，該參數值用於限制最大的查詢範圍，當 (end - start) > forceMaxMetaTimeRangeSeconds 時會將查詢範圍對齊到 (end-forceMaxMetaTimeRangeSeconds, end) 。

    為了查詢效率考慮，建議預設附帶此項參數。

    配置樣本，請參考中繼資料查詢API。

    後續步驟

    查詢時序型資料檢視

    在左側導覽列選擇資料檢視 > 時序型資料檢視，查看已建立的時序型資料檢視。

    更新時序型資料檢視

    1. 在資料檢視列表，滑鼠懸浮在目標資料檢視上，單擊image，然後單擊修改。

    2. 在修改資料檢視面板，您可以修改已關聯的時序庫，然後單擊確定。

      每個 Store 包含專案和時序庫兩個下拉框，可單擊 + STORE 添加更多關聯時序庫。

    刪除時序型資料檢視

    在資料檢視列表，滑鼠懸浮在目標資料檢視上，單擊image，然後單擊刪除。

    相關文檔