查看記錄檔和指標
Cloud Router 會將記錄資訊傳送至 Cloud Logging，並將監控指標傳送至 Cloud Monitoring。本頁說明如何存取這兩種資訊。
記錄
Cloud Router 會將記錄資訊傳送至 Cloud Logging，後者會記錄下列事件：
- 與 Cloud Router 相關的路由器事件
- 與 BGP 設定和工作階段相關的 BGP 事件
- 與兩個 BGP 對等互連之間路由公告相關的路由事件
- 與 Cloud Router 專屬前置字串配額相關的路由配額事件
查看記錄
控制台
前往 Google Cloud 控制台的「Cloud Router」頁面。
從 Cloud Router 清單中選取 Cloud Router。
在「記錄」欄中，按一下「查看」。
Cloud Router 記錄的格式如下：
路由器、BGP 和路由公告事件：與
gce_router受監控資源相關聯的記錄 (compute.googleapis.com/router_events)：[Event Type]: [Log Text]
路徑配額事件：與
gce_network_region受監控資源相關聯的 JSON 記錄 (router.googleapis.com/route_quota_events)。如要進一步瞭解酬載結構，請參閱「路徑配額事件記錄」。
如要在記錄檔探索工具中建構查詢，請參閱「在記錄檔探索工具中建構查詢」。
資訊記錄
下表列出記錄資訊記錄中記錄的事件。
| 事件 | 說明 |
|---|---|
| 路由器事件 | 已啟用路由器工作 |
| 路由器工作已停用 | |
| BGP 事件 | 已成功為對等互連新增設定：LIST_OF_PEERS |
與 PEER 的 BGP 對等互連已於 x 秒前啟動 |
|
與 PEER 的 BGP 對等互連因 MESSAGE 而中斷，其中 MESSAGE 會提供說明，例如 HOLD_TIMER_EXPIRED 或 LINK_DOWN。如要進一步瞭解 LINK_DOWN，請參閱「Cloud Router 記錄中顯示 LINK_DOWN 訊息」。 |
|
BGP 路由器 ID 設為 BGP_ROUTER_ID |
|
| 路徑事件 | 向對等互連點 advertise 的前置碼：PREFIX |
正在從對等互連撤銷前置字元：PREFIX |
|
Cloud Router 收到前置字串 PREFIX 下一個躍點 LIST_OF_NEXTHOPS |
|
已從 Cloud Router 刪除前置字串 PREFIX 下一個躍點 LIST_OF_NEXTHOPS |
常見的 Logging 事件
如要查看 Cloud Router 的常見 Logging 事件 (如下表所示)，請按照查看記錄的步驟操作。指定表格中列出的其中一個進階篩選器。視需要調整 Logging 搜尋的時間範圍。
| 活動說明 | Logging 進階篩選器 |
|---|---|
| 遷移或重新啟動 Cloud Router 程序 | resource.type="gce_router" "task activated" |
| 新增已知路徑 | resource.type="gce_router" "received by cloud router" |
| 移除已知路由 | resource.type="gce_router" "deleted from cloud router" |
| 匯出 advertise 的路徑 | resource.type="gce_router" ("Route Event" AND "Advertising prefix") |
| BGP 對接已啟動 | resource.type="gce_router" ("BGP peering" AND "came up") |
| BGP 對等互連已啟用 MD5 驗證 | resource.type="gce_router" ("BGP peering" AND "came up" AND "MD5 authentication enabled") |
| BGP 對接停止運作 | resource.type="gce_router" ("BGP peering" AND "went down") |
| Google 對接邊緣路由器上的連結中斷，因此 BGP 對接中斷 | resource.type="gce_router" ("BGP peering" AND "went down" AND "LINK_DOWN") |
| 收到的路徑過多，因此 BGP 工作階段已關閉 | resource.type="gce_router" ("NOTIFICATION 6/1") severity="CRITICAL" |
| 超過 Cloud Router 動態路徑前置字串配額 | resource.type="gce_network_region" ("No more routes" AND "can be programmed") severity="ERROR" |
| 因配額問題而捨棄路徑 | resource.type="gce_network_region" severity="ERROR" jsonPayload.affectedResource.routes.nextHopIpAddresses=" PEER_IP_ADDRESS"
|
| 等待對等互連的 BFD 工作階段 | resource.type="gce_router" ("BFD Event" AND "bfd enabled, state [Init, NoDiagnostic]") |
| BFD 工作階段已啟動 | resource.type="gce_router" ("BFD Event" AND "to [Up, NoDiagnostic]") |
| BFD 工作階段停止運作 (Rx 計時器時間已到) | resource.type="gce_router" ("BFD Event" AND "to [Down, ControlDetectionTimeExpired]") |
BFD 工作階段已停止運作 (對等互連狀態為 Down 或 AdminDown) |
resource.type="gce_router" ("BFD Event" AND "to [Down, NeighborSessionDown]") |
| BFD 工作階段在本機停用 | resource.type="gce_router" ("BFD Event" AND "bfd disabled") |
轉送配額事件記錄
Cloud Router 會透過 gce_network_region 受監控資源，將路由配額事件寫入 router.googleapis.com/route_quota_events 下的 Cloud Logging。這類記錄可協助您監控路由前置字串用量是否超出配額，並找出任何遭捨棄的路由。
路徑配額事件會依下列嚴重性等級記錄：
WARNING：路由用量接近配額限制 (用量達到或超過區域或全域限制的 75%)。ERROR：路由用量達到或超過限制的 100%。多餘的路由無法設定，因此會遭到捨棄。如果因配額用盡而捨棄路由，記錄項目會在jsonPayload.affectedResource.routes欄位中提供捨棄路由的詳細資料。
路徑配額事件欄位
路徑配額記錄項目包含結構化 JSON 酬載 (jsonPayload)，其中包含下列欄位：
| 欄位 | 說明 |
|---|---|
eventTime |
配額事件發生的時間戳記。 |
routeQuotaEvent.helperMessage |
說明配額狀態的訊息，例如 Cloud Router 專屬前置字元配額用量接近或超過上限時，系統會顯示警告。 |
routeQuotaEvent.regionalRouteCount |
每個虛擬私有雲網路中，各區域來自自身區域的不重複 Cloud Router 動態路由前置字元配額用量。用量代表在虛擬私有雲網路特定區域中，由動態路由控制層處理的不重複路由前置字元數量，這些前置字元是從同一區域和網路中的所有 Cloud Router BGP 工作階段接收。 |
routeQuotaEvent.regionalRouteLimit |
「每個虛擬私有雲網路各區域來自自身區域的不重複 Cloud Router 動態路徑前置字串」配額限制。這項限制代表在虛擬私有雲網路的特定區域中，動態路由控制層可處理的不重複路由前置字元數量上限，這些前置字元是從同一區域和網路中的所有 Cloud Router BGP 工作階段接收。 |
routeQuotaEvent.globalRouteCount |
每個虛擬私有雲網路中，各區域來自其他區域的不重複 Cloud Router 動態路由前置字元配額用量。用量代表在虛擬私有雲網路的特定區域中，動態路由控制層處理的不重複路由前置字元數量，這些前置字元是從同一網路其他區域的所有 Cloud Router BGP 工作階段接收。 |
routeQuotaEvent.globalRouteLimit |
每個虛擬私有雲網路中，各區域來自其他區域的不重複 Cloud Router 動態路由前置字元配額上限。這項限制代表在虛擬私有雲網路的特定區域中，動態路徑控制層可處理的不重複路徑前置字串數量上限，這些前置字串是從同一網路其他區域的所有 Cloud Router BGP 工作階段接收。 |
affectedResource.routes[] |
當 Cloud Router 專屬前置字串配額用量超過限制時，系統會捨棄前置字串，且不會建立動態路徑。這個項目包含這些前置字串的屬性 (出現在 ERROR 嚴重性事件中)。每個項目都包含下列屬性：
|
指標
Cloud Router 會將指標發布至 Cloud Monitoring。如需 Cloud Router 發布的指標清單，請參閱「監控 Cloud Router 指標」。
所有 Cloud Router 指標都涵蓋 IPv4 和 IPv6 流量。
使用 API 查看指標
您可以使用 Cloud Monitoring API 存取這些指標。詳情請參閱「讀取指標資料」。
使用 Monitoring 資訊主頁查看指標
您也可以在 Cloud Monitoring 中建立自訂資訊主頁，協助分析這些指標。詳情請參閱「管理自訂資訊主頁」。
如要建立自訂資訊主頁，請按照下列步驟操作。
控制台
前往 Google Cloud 控制台的「Monitoring」頁面。
選取「Dashboards」(資訊主頁)，然後在「Dashboards Overview」(資訊主頁總覽) 頁面中，按一下 「Create dashboard」(建立資訊主頁)。
選用：將資訊主頁標題更新為具描述性的名稱。
在「Chart library」(圖表庫) 中，選取要新增的圖表。舉例來說，如要在資訊主頁中新增「Line」(折線圖) 圖表，請按一下或將該項目從「Chart library」(圖表庫) 拖曳至圖表區域。
在「圖表標題」中，變更圖表標題或使用建議的標題。
在「您想查看哪些資料？」中，執行下列操作：
- 在「Resource type」(資源類型) 中，按一下「Type to filter」(輸入篩選條件) 欄位，然後輸入
Cloud Router。 - 在「Metric」(指標) 中，新增 Cloud Router 指標。
- 在「Resource type」(資源類型) 中，按一下「Type to filter」(輸入篩選條件) 欄位，然後輸入
使用「篩選器」控制項，讓檢視僅顯示特定路由器或工作階段。
如要新增其他指標，請按一下「新增其他指標」。
有些指標適用於 Cloud Router，有些則適用於特定 Cloud Router 上的 BGP 工作階段。Cloud Router 指標會顯示為 router-name，BGP 工作階段指標則會顯示為 router-name(bgp-name)。
Cloud Router 的 Monitoring 指標
這個表格中的「指標類型」字串開頭必須是 router.googleapis.com/。表格中的項目已省略該前置字元。查詢標籤時，請使用 metric.labels. 前置字串，例如 metric.labels.LABEL="VALUE"。
| 指標類型推出階段(資源階層層級) 顯示名稱 |
|
|---|---|
| 種類、類型、單位 受監控資源 |
說明 標籤 |
best_received_routes_count
GA
(專案)
收到的路徑數量 |
|
GAUGE、INT64、1
gce_router |
路由器目前收到的最佳路徑數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 180 秒無法查看資料。 |
bfd/control/receive_intervals
GA
(專案)
BFD 控制封包接收間隔 |
|
GAUGE、INT64、ms
gce_router |
BFD 控制封包接收間隔。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。 |
bfd/control/received_packets_count
GA
(專案)
接收的控制封包 |
|
DELTA、INT64、1
gce_router |
從這個 BFD 工作階段收到的控制封包數量。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。 |
bfd/control/rejected_packets_count
GA
(專案)
遭拒絕的控制封包 |
|
DELTA、INT64、1
gce_router |
這個 BFD 工作階段拒絕的控制封包數量。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。 |
bfd/control/transmit_intervals
GA
(專案)
BFD 控制封包傳輸間隔 |
|
GAUGE、INT64、ms
gce_router |
BFD 控制封包傳輸間隔。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。 |
bfd/control/transmitted_packets_count
GA
(專案)
傳輸的控制封包 |
|
DELTA、INT64、1
gce_router |
從這個 BFD 工作階段傳輸的控制封包數量。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。 |
bfd/session_flap_events_count
GA
(專案)
BFD 工作階段不穩定 |
|
DELTA、INT64、1
gce_router |
這個 BFD 工作階段中，各項 BFD 震盪事件的數量。工作階段震盪事件是指從「Up」狀態轉換。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。event_type：BFD 震盪的原因，例如「AdminDown」或「ControlDetectionTimeExpired」。 |
bfd/session_up
GA
(專案)
BFD 工作階段狀態 |
|
GAUGE、INT64、1
gce_router |
表示 BFD 工作階段是否成功建立。1 表示工作階段正在運作。0 表示工作階段已停止運作。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
peer_ip：BFD 工作階段的對等互連 IP。 |
bgp/received_routes_count
GA
(專案)
BGP 接收的路徑數量 |
|
GAUGE、INT64、1
gce_router |
BGP 工作階段目前收到的路徑數量。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
bgp_peer_name：BGP 工作階段的名稱。 |
bgp/sent_routes_count
GA
(專案)
BGP 傳送的路徑數量 |
|
GAUGE、INT64、1
gce_router |
目前透過 BGP 工作階段傳送的路由數量。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
bgp_peer_name：BGP 工作階段的名稱。 |
bgp/session_up
GA
(專案)
BGP 工作階段狀態 |
|
GAUGE、INT64、1
gce_router |
表示 BGP 工作階段建立成功的指標。1 表示工作階段正在運作。0 表示工作階段已停止運作。取樣頻率為每 60 秒一次。取樣之後，最多 180 秒內都無法查看資料。
bgp_peer_name：BGP 工作階段的名稱。 |
bgp_sessions_down_count
GA
(專案)
BGP 工作階段停止運作次數 |
|
GAUGE、INT64、1
gce_router |
路由器上停止運作的 BGP 工作階段數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 180 秒無法查看資料。 |
bgp_sessions_up_count
GA
(專案)
BGP 工作階段啟動次數 |
|
GAUGE、INT64、1
gce_router |
路由器上運作中的 BGP 工作階段數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 180 秒無法查看資料。 |
dynamic_routes/learned_routes/any_dropped_unique_destinations
Beta 版
(專案)
捨棄所有不重複的目的地 |
|
GAUGE、BOOL、1
gce_network_region |
布林指標，指出網路區域是否因超過配額而捨棄任何不重複的目的地。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 60 秒無法查看資料。
routing_mode：
路徑的轉送模式，可為 ["global" - 從遠端區域得知；"regional" - 從本機區域得知] 其中之一。
|
dynamic_routes/learned_routes/dropped_unique_destinations
Beta 版
(專案)
不重複到達網頁數量減少 |
|
GAUGE、INT64、1
gce_network_region |
網路區域因超過配額而捨棄的不重複目的地數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 60 秒無法查看資料。
routing_mode：
路徑的轉送模式，可為 ["global" - 從遠端區域得知；"regional" - 從本機區域得知] 其中之一。
|
dynamic_routes/learned_routes/unique_destinations_limit
Beta 版
(專案)
不重複目的地數量上限 |
|
GAUGE、INT64、1
gce_network_region |
這個網路區域的路由配額允許的不重複目的地數量上限。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 60 秒無法查看資料。
routing_mode：
路徑的轉送模式，可為 ["global" - 從遠端區域得知；"regional" - 從本機區域得知] 其中之一。
|
dynamic_routes/learned_routes/used_unique_destinations
Beta 版
(專案)
已使用的不重複目的地 |
|
GAUGE、INT64、1
gce_network_region |
這個網路區域中，已知路由使用的不重複目的地數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 60 秒無法查看資料。
routing_mode：
路徑的轉送模式，可為 ["global" - 從遠端區域得知；"regional" - 從本機區域得知] 其中之一。
|
nat/allocated_ports
GA
(專案)
已分配的通訊埠 |
|
GAUGE、INT64、{port}
nat_gateway |
NAT 閘道分配給所有 VM 的通訊埠數量。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
nat_ip：通訊埠的網路位址轉譯 (NAT) IP。 |
nat/closed_connections_count
GA
(專案)
已關閉的連線數量 |
|
DELTA、INT64、{connection}
nat_gateway |
透過 NAT 閘道關閉的連線數量。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/dropped_received_packets_count
GA
(專案)
已接收但遭捨棄的封包數 |
|
DELTA、INT64、{packet}
nat_gateway |
NAT 閘道捨棄的接收封包數量。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/dropped_sent_packets_count
GA
(專案)
已傳送但遭捨棄的封包數 |
|
DELTA、INT64、{packet}
nat_gateway |
NAT 閘道捨棄的傳送封包數量。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。
reason：封包遭捨棄的原因。可能的值包括 OUT_OF_RESOURCES、ENDPOINT_INDEPENDENCE_CONFLICT。
|
nat/nat_allocation_failed
GA
(專案)
NAT 分配失敗 |
|
GAUGE、BOOL、nat_gateway |
指出是否無法將網路位址轉譯 (NAT) IP 指派給 NAT 閘道中的任何 VM。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。 |
nat/new_connections_count
GA
(專案)
新連線數 |
|
DELTA、INT64、{connection}
nat_gateway |
透過網路位址轉譯閘道建立的新連線數量。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/open_connections
GA
(專案)
開啟連線 |
|
GAUGE、INT64、{connection}
nat_gateway |
NAT 閘道目前開啟的連線數量。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/port_usage
GA
(專案)
通訊埠用量 |
|
GAUGE、INT64、{port}
nat_gateway |
從 VM 連至單一網際網路端點 (IP:通訊埠) 的連線數量上限。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/received_bytes_count
GA
(專案)
接收的位元組數 |
|
DELTA、INT64、By
nat_gateway |
透過 NAT 閘道接收的位元組數 (目的地 -> VM)。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/received_packets_count
GA
(專案)
接收的封包數 |
|
DELTA、INT64、{packet}
nat_gateway |
透過 NAT 閘道接收的封包數量 (目的地 -> VM)。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。
|
nat/rule/nat_allocation_failed
GA
(專案)
各規則的 NAT 分配失敗 |
|
GAUGE、BOOL、nat_gateway |
指出是否無法將網路位址轉譯 (NAT) IP 分配給 NAT 閘道中任何 VM，以套用特定 NAT 規則。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
nat_rule_priority：與錯誤相關聯的網路位址轉譯規則優先順序編號。 |
nat/sent_bytes_count
GA
(專案)
傳送的位元組數 |
|
DELTA、INT64、By
nat_gateway |
透過 NAT 閘道傳送的位元組數 (VM -> 目的地)。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
nat/sent_packets_count
GA
(專案)
傳送的封包數 |
|
DELTA、INT64、{packet}
nat_gateway |
透過網路位址轉譯 (NAT) 閘道傳送的封包數量 (VM -> 目的地)。取樣頻率為每 60 秒一次。取樣之後，最多 225 秒內都無法查看資料。
ip_protocol：連線的通訊協定。可以是 TCP、UDP 或 ICMP。 |
router_up
GA
(專案)
執行中的路由器工作 |
|
GAUGE、INT64、1
gce_router |
成功執行的路由器軟體工作數量。如果值大於或等於 1，表示路由器已啟動，但可能無法執行所有軟體工作。將傳回的數字與路由器預期的軟體工作數量進行比較。如果值為 0，表示路由器已停止運作。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 180 秒無法查看資料。 |
sent_routes_count
GA
(專案)
已傳送路徑數量 |
|
GAUGE、INT64、1
gce_router |
路由器目前傳送的路由數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 180 秒無法查看資料。 |
表格產生時間：2026-10-29 23:33:54 UTC。
後續步驟
- 如要排解使用 Cloud Router 時遇到的問題，請參閱「疑難排解」。