啟用度量值監視

若要接收監視度量值，您必須設定 IBM Cloud Monitoring 實例。

若要接收監視度量，請使用下列步驟:

1. 導覽至 度量值監視入口網站，然後按一下 建立監視實例。

2. 選取 IBM Cloud Monitoring 實例的地區。

   如果您沒有現有 VPN 伺服器，請參閱 建立 VPN 伺服器 以佈建 VPN 伺服器。

   地區需要符合現有 VPN 伺服器的位置。

3. 選擇定價方案。 定價方案詳細資料在選擇視窗中說明。 選擇最符合您需求的計劃。

4. 為您的實例提供唯一的服務名稱。 名稱可以是您想要的任何名稱，對功能沒有影響。

   請勿為多個 IBM Cloud Monitoring 實例提供相同名稱。

5. 選擇資源群組。 資源群組會以可自訂的分組來組織帳戶資源。 任何使用 IBM Cloud® Identity and Access Management (IAM) 存取控制管理的帳戶資源都屬於您帳戶內的資源群組。

   如果您沒有任何預先配置的資源群組，或沒有理由選擇性地共用此資源，請使用預設選項。

   如果您的帳戶有多個資源群組，您可以選擇哪個群組具有此 IBM Cloud Monitoring 實例的存取權。 透過使用此選擇性存取，度量可用於部分資源群組，而不適用於其他資源群組。

6. 勾選 啟用平台度量值 勾選框。 您必須選取此選項，才能從 VPN 伺服器接收度量值。

7. 按一下建立。 您會回到監視度量值首頁。

在幾分鐘內，新的 IBM Cloud Monitoring 實例即會顯示數個配置。 您可能需要重新整理瀏覽器才能看到它。

使用 API 來使用 IBM Cloud Monitoring

您也可以使用度量查詢 API 來使用 IBM Cloud Monitoring 實例。 如果您需要原始資料點或想要從指令行介面使用度量值，而不是使用 IBM Cloud Monitoring 儀表板，則可能想要使用 API。

建立 IBM Cloud Monitoring 實例之後，您必須收集下列兩項資訊。

• 監視 API 記號
• IBM Cloud Monitoring 實例的端點

若要使用度量查詢 API 來收集此資訊並使用 IBM Cloud Monitoring 實例，請遵循下列步驟:

1. 存取 Monitoring 首頁。

2. 按一下您要使用之實例旁邊的 開啟儀表板。

3. 在您看到 IBM Cloud Monitoring 儀表板之後，請選取資訊看板上的「帳戶設定檔」圖示，然後選取 設定。 現在您會看到您的帳號設定。

4. 您的 Monitor API 記號是位於 Sysdig Monitor API 記號 欄位中的英數字串。 按一下複製按鈕，將記憶體複製到剪貼簿。

   請勿共用此 API 記號。 具有此 API 記號的任何人都可以完整存取您的度量值。

5. IBM Cloud Monitoring 實例的端點是根據地區。 例如，如果您的 IBM Cloud Monitoring 實例存在於 us-south 中，則其端點為:

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

   URL 的第一部分 (在本範例中為 us-south.monitoring.cloud.ibm.com) 是您的端點。 請注意此 URL。

6. 同時具有 API 記號和端點之後，您可以格式化 POST 要求。 下列 POST 要求是一個範例，其中包含您可以修改的所有參數。 下列是參數:

   • 監視 API 記號。
   • IBM Cloud Monitoring 實例的端點。
   • ibm_is_vpn_server_name 的值 (您要查看其度量值的 VPN 伺服器名稱)。

   如果您想要查看所有 VPN 伺服器的此度量值，請不要輸入 scope 屬性的值。 例如，使用 "scope" : ""。

   • 您要查看其結果的計量資料類型。 本範例使用 ibm_is_vpn_server_health_status。
   • from 及 to 屬性定義聚焦掃描的時間範圍，以新紀元時間設定，並以微秒為單位。
   • sampling 及 value 屬性設定 POST 要求中所傳回資料的精度。

因為大量資料儲存在 IBM Cloud Monitoring中，所以選擇特定精度層次非常重要。IBM Cloud Monitoring 每次每個要求只能傳回 600 個資料點。 因此，sampling 和 value 屬性很重要。 將這兩行保留在要求之外，會改為傳回該時段的聚集總和。

如果 from 和 to 指定的時間範圍較大 (例如，4 天)，但您將 sampling 和 value 定義為 10 秒，則表示您會收到 4 天的資料，分成 10 秒片段。 因為傳回大量資料，所以此範例沒有用。 建議指定較大的片段 (例如，1 小時而非 10 秒)。

   curl \
   -H 'Authorization: Bearer <API_TOKEN>’ \
   -H 'Content-Type: application/json' \
   https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
   -d '{
     "requests": [
         {
             "format": {
                 "type": "data"
             },
             "scope": "ibm_is_vpn_server_name = \"test-001\"",
             "metrics": {
                 "k0": "timestamp",
                 "v1": "ibm_is_vpn_server_health_status"
             },
             "time": {
                 "from": 1624849800000000,
                 "to": 1624850400000000,
                 "sampling": 60000000
             },
             "group": {
                 "by": [
                     {
                        "metric": "k0",
                         "value" : 60000000
                     }
                 ],
                 "aggregations": {
                     "v1": "avg"
                 },
                 "groupAggregations": {
                     "v1": "avg"
                 }
             }
         }
     ]
 }'