標籤與指派

標籤用來描述資源，選擇器則根據探測器標籤決定檢查要在哪裡執行。設計標籤分類時，請將這兩個用途分開思考。

建立一致的標籤規則

每個標籤都是一組 key/value，每一部分最多 64 個字元。實用的分類應該穩定，且團隊成員都能理解：

請先在「標籤」中建立可用值，再將它們套用到探測器與檢查。重新命名或刪除標籤可能改變選擇器的比對結果，因此變更分類規則前，請先檢查受影響的檢查。

選擇要執行檢查的探測器

控制器使用支援標籤相等比較及邏輯組合的選擇器抽象語法樹。Web 編輯器會協助建立這個運算式，並預覽目前有哪些已啟用的探測器符合條件。

概念如下：

region=tokyo AND (provider=isp-a OR provider=isp-b)

空白選擇器會符合專案中所有已啟用的探測器。只有希望檢查涵蓋所有探測器時，才應刻意使用這個設定。

實際生效的指派

控制器會為每個符合條件且已啟用的探測器，建立一筆實際生效的探測器／檢查指派。指派會記錄檢查與選擇器的版本，讓 agent 能偵測設定變更。

變更相關的探測器、檢查或標籤後，系統會重新整理指派。如果無法同步完成，背景重試程序會再次處理。

排查缺少量測結果的問題

請依下列順序檢查：

1. 確認檢查已儲存，而且執行間隔有效。
2. 預覽選擇器，確認預期的探測器有出現在比對結果中。
3. 確認探測器已啟用。
4. 確認探測器在線上，且近期持續傳送心跳訊號。
5. 依探測器或檢查篩選專案指派。
6. 等待 agent 下一次輪詢指派。
7. 查看探測器服務日誌，確認是否有執行或提交結果的錯誤。

如果探測器符合條件，卻無法執行明確指定 IPv4 或 IPv6 的檢查，請查看它回報的 IP 版本能力，以及主機實際的網路設定。

謹慎管理公開內容

狀態頁可以公開檢查的特定指派，也可以公開該檢查的所有指派。變更標籤後，請重新檢查狀態頁包含的指派，避免意外公開原本不在範圍內的探測器名稱、目標或位置。