監控保留項目的用量

控制台

如要使用基本查詢建立監控資訊主頁，請按照下列步驟操作：

1. 前往 Cloud de Confiance 控制台的「資訊主頁」頁面。

   前往資訊主頁

2. 按一下「建立資訊主頁」add。

   「新資訊主頁」頁面隨即開啟。

3. 按一下「新增小工具」add_box。

   系統隨即會顯示「新增小工具」窗格。

4. 按一下其中一個可用的小工具。例如，按一下「折線圖」小工具。

   系統隨即會顯示「設定小工具」窗格。

5. 按一下「Select a metric」(選取指標)。

6. 在「選取指標」視窗中，執行下列操作：

   1. 輸入 Reservation，然後選取「預訂」。

   2. 在「使用中的指標類別」清單中，再次選取「預訂」。

   3. 在「使用中的指標」清單中，選取其中一個可用指標。 例如選取「已使用」。

   4. 按一下「套用」。

7. 如要依特定區域篩選預訂，請按照下列步驟操作：

   1. 在「新增篩選器」清單中，選取其中一個可用的預訂篩選器。以這個範例來說，請選取「位置」。

   2. 在「比較子」清單中，選取其中一個可用運算子。 在本範例中，請選取「= (equals)」(= (等於)) (預設)。

   3. 在「Value」(值) 清單中，選取要用來篩選預訂的區域。在本範例中，請選取 us-central1-a。

8. 按一下「套用」。

如要進一步瞭解如何使用 Cloud de Confiance 控制台自訂 Monitoring 資訊主頁，請參閱「建立及管理自訂資訊主頁」。

REST

如要使用基本查詢建立監控資訊主頁，請對 dashboards.create 方法提出 POST 要求。

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "minAlignmentPeriod": "60s",
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesFilter": {
                    "aggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_MEAN"
                    },
                    "filter": "FILTER",
                    "secondaryAggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_NONE"
                    }
                  }
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6
      }
    ]
  }
}

更改下列內容：

• PROJECT_ID：目前專案的專案 ID。

• FILTER：用於資訊主頁的監控篩選器。舉例來說，如要監控區域 us-central1-a 中已使用的預訂項目，請指定下列項目：

  resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND resource.location = 'us-central1-a'

如要進一步瞭解如何使用 Monitoring API 自訂 Monitoring 資訊主頁，請參閱「使用 API 建立及管理資訊主頁」。

控制台

如要建立監控資訊主頁，並新增使用 PromQL 設定查詢的小工具，請按照下列步驟操作：

1. 在 Cloud de Confiance 控制台中，前往「Dashboards」(資訊主頁)dashboard 頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 按一下「建立資訊主頁」add。

   「新資訊主頁」頁面隨即開啟。

3. 按一下「新增小工具」add_box。

   系統隨即會顯示「新增小工具」窗格。

4. 按一下其中一個可用的小工具。例如，按一下「折線圖」小工具。

   系統隨即會顯示「設定小工具」窗格。

5. 如果沒有看到程式碼編輯器，請按一下 code「PromQL」或 code「MQL」。在「語言」部分，選取「PromQL」。

6. 在查詢編輯器中輸入 PromQL 查詢。舉例來說，如要查看預留項目中使用的 VM 與預留 VM 的比例，請指定下列項目：

   (
     max by (metadata_system_name) ({"compute.googleapis.com/reservation/used"})
     /
     max by (metadata_system_name) ({"compute.googleapis.com/reservation/reserved"})
   )
   

7. 點選「執行查詢」。

8. 按一下「套用」。

如要進一步瞭解如何使用 Cloud de Confiance 控制台自訂 Monitoring 資訊主頁，請參閱「建立及管理自訂資訊主頁」。

REST

如要建立 Monitoring 資訊主頁，並新增已使用 PromQL 查詢設定的小工具，請向 dashboards.create 方法提出 POST 要求。

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesQueryLanguage": "PROMQL_QUERY"
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6,
        "xPos": 6
      }
    ]
  }
}

更改下列內容：

• PROJECT_ID：目前專案的專案 ID。

• PROMQL_QUERY：用於折線圖小工具的 PromQL 查詢。舉例來說，如要查看預留項目中已用 VM 與預留 VM 的比例，請指定下列項目：

  (
  max by (metadata_system_name) ({"compute.googleapis.com/reservation/used"})
  /
  max by (metadata_system_name) ({"compute.googleapis.com/reservation/reserved"})
  )

如要瞭解如何使用 Monitoring API 自訂 Monitoring 資訊主頁，請參閱「使用 API 建立及管理資訊主頁」。

控制台

如要使用基本查詢建立 Monitoring 警告政策，請按照下列步驟操作：

1. 前往 Cloud de Confiance 控制台的「Alerting」(警告)。

   前往「Alerting」(快訊)

2. 按一下 add「建立政策」。

   「建立警告政策」頁面隨即開啟。

3. 按一下「選取指標」bar_chart。

   畫面上會顯示「選取指標」視窗。

4. 在「選取指標」視窗中，執行下列操作：

   1. 在「Filter by resource or metric name」(按照資源或指標名稱篩選) 欄位中，輸入 Reservation。

   2. 如果「預訂」指標顯示在「使用中的資源」清單中，請選取該指標。否則，請按照下列步驟操作：

      1. 取消選取「僅顯示活躍的資源和指標」。

         系統會顯示「未使用的資源」清單。

      2. 在「閒置資源」清單中，選取「預留項目」。

   3. 在「使用中的指標類別」清單中，再次選取「預訂」。

      系統會顯示「有效指標」清單。

   4. 在「使用中的指標」清單中，選取其中一個可用指標。

      例如選取「已使用」。

   5. 按一下「套用」。

5. 按一下「新增篩選條件」add_box。

   系統會顯示「新增篩選器」部分。

6. 在「新增篩選器」部分，執行下列操作：

   1. 在「標籤」清單中，選取這份文件中指定的預留項目可用篩選器。

      舉例來說，如要依名稱篩選預訂項目，請選取「name」。

   2. 在「比較」清單中，選取其中一個可用運算子。

      例如，選取「= (equals)」(= (等於)) (預設)。

   3. 在「Value」(值) 清單中，選取要監控的預訂名稱。

   4. 按一下「完成」。

7. 點選「下一步」。

   「設定快訊觸發條件」窗格隨即顯示。

8. 在「條件類型」部分，選取下列任一選項：

   1. 如要讓時間序列高於或低於特定值時觸發條件，請選取「門檻」。

   2. 如要在時間序列在特定時間沒有資料時觸發條件，請選取「指標不存在」。

   3. 如要讓系統在預測時間序列即將超過門檻時觸發條件，請選取「預測」。

   例如，選取「門檻」 (預設)。

9. 在「Alert trigger」(快訊觸發條件) 清單中，選取觸發快訊的條件。

   例如，選取「任何時間序列違反條件時」 (預設)。

10. 在「門檻位置」清單中，選取觸發條件的時間。

    例如選取「高於門檻」。

11. 在「Threshold value」(門檻值) 欄位中，輸入條件的值。

    例如輸入 0。

12. 在「條件名稱」欄位中，輸入條件名稱。

    例如：Reservation RESERVATION_NAME consumed.

    其中 RESERVATION_NAME 是您在先前步驟中指定的預訂名稱。

13. 點選「下一步」。

    系統會顯示「設定通知並完成快訊」窗格。

14. 按一下「使用通知管道」。

15. 在「Notification channels」(通知管道) 欄位中，選取要接收事件通知的管道。

    如果沒有可用的通知管道，請按一下「管理通知管道」，然後按照步驟建立通知管道。詳情請參閱「建立及管理通知管道」。

16. 在「Incident autoclose duration」(事件自動關閉期限) 欄位中，選取事件自動關閉的期限。

    例如選取「3 天」。

17. 在「快訊政策名稱」欄位中，輸入快訊政策的名稱。

    例如：Alert: you started consuming reservation RESERVATION_NAME!

    其中 RESERVATION_NAME 是您在先前步驟中指定的預留項目名稱。

18. 點選「下一步」。

    系統會開啟警報條件的檢查頁面。

19. 點選「建立政策」。

    建立警告政策可能需要幾秒鐘才能完成。這項操作會將您重新導向至「建立警告政策」頁面。

如要進一步瞭解使用 Cloud de Confiance 控制台和基本查詢建立快訊政策時可用的選項，請參閱「建立以指標為基礎的快訊政策」。

REST

如要使用基本查詢建立 Monitoring 警告政策，請對 projects.alertPolicies.create 方法提出 POST 要求。

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: you started consuming reservation RESERVATION_NAME!",
  "conditions": [
    {
      "displayName": "Reservation RESERVATION_NAME consumed.",
      "conditionThreshold": {
        "filter": "FILTER",
        "aggregations": [
          {
            "alignmentPeriod": "300s",
            "crossSeriesReducer": "REDUCE_NONE",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "thresholdValue": 0
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

更改下列內容：

• PROJECT_ID：目前專案的專案 ID。

• RESERVATION_NAME：現有預留位置的名稱，該預留位置位於目前專案中。

• FILTER：用於警告政策的監控篩選條件。舉例來說，如要監控預留項目的 used 指標，請指定下列項目：RESERVATION_NAME

  resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND metadata.system.name = 'RESERVATION_NAME'

• AUTO_CLOSE_TIME：系統自動關閉事件前的時間 (以秒為單位)。值必須介於 0s 至 604800s (7 天) 之間。例如，輸入 259200s (3 天)。

• NOTIFICATION_CHANNEL：現有通知管道的名稱。如要設定通知管道，請參閱「建立及管理通知管道」。

如要進一步瞭解使用 Monitoring API 和基本查詢建立快訊政策時可用的選項，請參閱「使用 API 建立快訊政策」。

控制台

如要使用 PromQL 建立 Monitoring 警告政策，請按照下列步驟操作：

1. 前往 Cloud de Confiance 控制台的「Alerting」(警告)。

   前往「Alerting」(快訊)

2. 按一下 add「建立政策」。

   「建立警告政策」頁面隨即開啟。

3. 在「政策設定模式」中，選取「程式碼編輯器 (MQL 或 PromQL)」。

   系統隨即會顯示「Query editor」(查詢編輯器) 窗格。

4. 選取「PromQL」PromQL做為語言，然後輸入 PromQL 查詢。

   舉例來說，如要建立查詢，依名稱將預留項目分組，並在超過 90% 的預留項目用盡時觸發快訊條件，請輸入下列查詢：

   (
     max by (metadata_system_name) ({"compute.googleapis.com/reservation/used"})
     /
     max by (metadata_system_name) ({"compute.googleapis.com/reservation/reserved"})
   ) > 0.9
   

5. 點選「下一步」。

   「設定快訊觸發條件」窗格隨即顯示。

6. 如果條件名稱，請輸入條件名稱。

   例如：Over 90% of your reservations are consumed.

7. 再次點選「繼續」。

   系統會顯示「設定通知並完成快訊」窗格。

8. 按一下「使用通知管道」。

9. 在「Notification channels」(通知管道) 欄位中，選取要接收事件通知的管道。

   如果沒有可用的通知管道，請按一下「管理通知管道」，然後按照步驟建立通知管道。詳情請參閱「建立及管理通知管道」。

10. 在「Incident autoclose duration」(事件自動關閉期限) 欄位中，選取事件自動關閉的期限。

    例如選取「3 天」。

11. 在「快訊政策名稱」欄位中，輸入快訊政策的名稱。

    例如：Alert: over 90% of your reservations are consumed.

12. 點選「下一步」。

    系統會開啟警報條件的檢查頁面。

13. 點選「建立政策」。

    建立警告政策可能需要幾秒鐘才能完成。這項操作會將您重新導向至「建立警告政策」頁面。

如要進一步瞭解如何使用Cloud de Confiance 控制台和 PromQL 建立警告政策，請參閱「建立以 PromQL 為基礎的警告政策 (控制台)」。

REST

如要使用 PromQL 建立 Monitoring 警告政策，請向 projects.alertPolicies.create 方法發出 POST 要求。

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: over 90% of your reservations are consumed.",
  "conditions": [
    {
      "displayName": "Over 90% of your reservations are consumed.",
      "conditionMonitoringQueryLanguage": {
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "query": "PROMQL_QUERY"
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

更改下列內容：

• PROJECT_ID：目前專案的專案 ID。

• PROMQL_QUERY：用於警告政策的 PromQL 查詢。舉例來說，如要建立查詢，追蹤目前專案預留項目中，已用 VM 占預留 VM 的百分比是否超過 90%，請指定下列項目：

  (
  max by (metadata_system_name) ({"compute.googleapis.com/reservation/used"})
  /
  max by (metadata_system_name) ({"compute.googleapis.com/reservation/reserved"})
  ) > 0.9

• AUTO_CLOSE_TIME：系統自動關閉事件前的時間 (以秒為單位)。這個值必須介於 0s 至 604800s (7 天) 之間。例如，輸入 259200s (3 天)。

• NOTIFICATION_CHANNEL：現有通知管道的名稱。如要設定通知管道，請參閱「建立及管理通知管道」。

如要進一步瞭解如何使用 Monitoring API 和 PromQL 建立快訊政策，請參閱「建立以 PromQL 為基礎的快訊政策 (API)」。