本頁面由 Cloud Translation API 翻譯而成。

取得診斷資訊

Cloud Interconnect 診斷工具可讓您在佈建時和啟用後排解專屬互連網路連線問題。

這項診斷工具可根據您的需求，針對專屬互連網路連線的Google Cloud 端提供最新的詳細技術資訊。

服務中斷期間的診斷

如果發生全球性服務中斷，請勿使用專屬互連連線的診斷結果，決定要將網路流量重新導向何處。

專屬互連網路連線是全域資源，與區域性的 VLAN 連結不同。如果發生全球性服務中斷，Cloud Interconnect 的診斷工具可能無法正常運作。

佈建時進行診斷

您可以查看診斷工具，藉此瞭解修正和排解內部部署路由器設定問題所需的資訊。在佈建程序中，如果專屬互連網路連線沒有進展，這項資訊就非常實用。

視專屬互連連線在佈建程序中的階段而定，診斷結果會包含不同的資料。下一節會列出主要和次要步驟。診斷資訊會提供可行的後續步驟，確保佈建程序順利進行，不會再有問題。

使用指令輸出參考資料來解讀診斷指令結果或 Google Cloud 控制台提供的資訊。

佈建階段

專屬互連網路連線佈建程序有多個階段。在每個階段中，您必須符合下列相應的需求條件，才能進到下一個階段：

第 1 階段 - 線路連線：
- 連線中每個連結的光功率狀態為 OK。
第 2 階段 - 線路評估 (僅適用於有多個連結的連線)：
- 連線中每個連結的光功率狀態為 OK。
- 每個連結都會獲派臨時 IP 位址。系統會透過連線偵測測試，個別驗證每個連結的有效性。
- 位址解析通訊協定 (ARP) 項目存在。
第 3 階段 - 正式設定：
- 連線中每個連結的光功率狀態為 OK。
- 連線中的所有連結都會在 LACP 組合中設定。
- 系統會為未標記的連結組合介面指派臨時 IP 位址。 Google Cloud 透過 Ping 驗證連線能力。啟用程序完成後，系統就會移除測試 IP 位址。
- ARP 項目存在。

使用診斷工具

如要查看專屬互連網路連線的診斷資訊，請按照下列步驟操作。

這項工作需要的權限

如要執行這項工作，您必須擁有以下權限或下列 Identity and Access Management (IAM) 角色。

權限

compute.interconnects.get
compute.interconnects.use

角色

Compute 網路管理員 (roles/compute.networkAdmin)

主控台

前往 Google Cloud 控制台的 Cloud Interconnect「實體連線」分頁。

前往「實體連線」
選取專屬互連網路連線的名稱。
連線詳細資料頁面上的診斷資訊會顯示在下列位置：
- 如需警告或錯誤資訊，請查看「狀態」欄位。
- 如要瞭解專屬互連網路的已佈建容量，請查看「已佈建容量」欄位。
- 如果您懷疑專屬互連網路連線發生問題，請參閱「VLAN 連結」一節，瞭解連線的有效容量或下行連結數等資訊。
- 如需其他詳細資料 (如光訊號強度)，請參閱「連結電路資訊」一節。

gcloud

使用 gcloud compute interconnects get-diagnostics 指令：

gcloud compute interconnects get-diagnostics NAME
    --project=PROJECT_ID

更改下列內容：

NAME：專案中的專屬互連網路連線名稱
PROJECT_ID： Google Cloud 專案的 ID

輸出結果會與下列內容相似：

macAddress: "00:11:22:33:44:55"
arpCache:
  macAddress: "55:44:33:22:11:00"
  ipAddress: "1.2.3.4"
links:
  - circuitId: "circuit-id-1"
    receivingOpticalPower:
      value: 0.4
      state: OK
    lacpStatus:
      state: ACTIVE
      googleSystemId: "00:11:22:33:44:55"
      neighborSystemId: "55:44:33:22:11:00"
     macsec:
      ckn: 0101010189abcdef...0123456789abcdef
      operational: true
  - circuitId: "circuit-id-2"
    receivingOpticalPower:
      value: 0.4
      state: OK
    lacpStatus:
      state: DETACHED
    macsec:
      ckn: 0101010189abcdef...0123456789abcdef
      operational: false
    arpCache:
      macAddress: "01:23:45:67:89:0a"
      ipAddress: "2.3.4.5"

API

使用 interconnects.getDiagnostics 方法：

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME/getDiagnostics

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID
NAME：專案中的專屬互連網路連線名稱

如果指令成功執行，則會傳回下列格式的 InterconnectDiagnostics 輸出內容。如要解讀輸出內容，請參閱指令輸出參考資料。

{
  "macAddress": "00:11:22:33:44:55",
  "arpCache": [
    {
      "macAddress": "55:44:33:22:11:00",
      "ipAddress": "1.2.3.4"
    }
  ],
  "links": [
    {
      "circuitId": "circuit-id",
      "receivingOpticalPower": {
        "value": 0.4,
        "state": OK,
      },
      "lacpStatus": {
        "state": ACTIVE,
        "googleSystemId": "00:11:22:33:44:55",
        "neighborSystemId": "55:44:33:22:11:00"
      }
    },
    {
      "circuitId": "circuit-id",
      "receivingOpticalPower": {
        "value": 0.4,
        "state": OK,
      },
      "lacpStatus": {
        "state": DETACHED
      },
      "arpCache": [
        {
          "macAddress": "01:23:45:67:89:0a",
          "ipAddress": "2.3.4.5"
        }
      ]
    }
  ]
}

使用連線群組的診斷工具

您也可以從互連網路連線群組中的所有互連網路連線取得匯總診斷資訊。

這項工作需要的權限

如要執行這項工作，您必須擁有以下權限或下列 Identity and Access Management (IAM) 角色。

權限

compute.interconnectGroups.get
cloudasset.assets.listComputeInterconnect
cloudasset.assets.listComputeInterconnectAttachment
cloudasset.assets.listComputeNetworks
cloudasset.assets.listComputeRouters
cloudasset.assets.listComputeVpnGateways

角色

roles/owner
roles/editor
互連網路群組分析者 (roles/compute.interconnectGroupAnalyzer)

主控台

前往 Google Cloud 控制台的 Cloud Interconnect「實體連線」分頁。

前往「實體連線」
在「Interconnect groups」(互連網路群組) 表格中，選取專屬互連網路連線群組的名稱。
診斷資訊會顯示在群組詳細資料頁面的下列位置：
- 在頁面頂端附近，您可以查看群組的狀態和說明。
- 在狀態和說明下方，您可以查看連線數、預期服務水準協議，以及是否符合預期服務水準協議的資格。
- 如果連線群組有任何阻礙，導致無法達到預期服務等級協議 (SLA) 的要求，這些阻礙會顯示在上一節的「服務等級協議資格阻礙」欄位中。
- 頁面底端的表格會顯示連線群組中各連線的詳細資料。

gcloud

使用 gcloud compute interconnects groups get-operational-status 指令，將 NAME 替換為要檢查的專屬互連連線名稱：

gcloud compute interconnects groups get-operational-status NAME

使用 VLAN 連結群組的診斷資訊

您可以從 VLAN 連結群組中的所有 VLAN 連結取得匯總診斷資訊。

這項工作需要的權限

如要執行這項工作，您必須擁有以下權限或下列 Identity and Access Management (IAM) 角色。

權限

compute.interconnectAttachmentGroups.get
compute.routers.get
cloudasset.assets.listComputeInterconnect
cloudasset.assets.listComputeInterconnectAttachment
cloudasset.assets.listComputeNetworks
cloudasset.assets.listComputeRouters
cloudasset.assets.listComputeVpnGateways

角色

roles/owner
roles/editor
互連網路連結群組分析者 (roles/compute.interconnectAttachmentGroupAnalyzer)

主控台

前往 Google Cloud 控制台的 Cloud Interconnect「VLAN attachments」(VLAN 連結) 分頁。

前往 VLAN 連結
選取要編輯的 VLAN 連結群組。
診斷資訊會顯示在群組詳細資料頁面的下列位置：
- 在頁面頂端附近，您可以查看群組的狀態和說明。
- 在狀態和說明下方，您可以查看有多少 VLAN 連結正常運作、預期服務水準協議，以及您是否符合預期服務水準協議的資格。
- 如果 VLAN 連結群組有任何阻礙，導致無法符合預期服務水準協議的規定，這些阻礙會顯示在上一節的「不適用服務水準協議的原因」欄位中。
- 頁面底部的表格會顯示 VLAN 連結群組中每個 VLAN 連結的詳細資料。

gcloud

使用 gcloud compute interconnects attachments groups get-operational-status 指令：

gcloud compute interconnects attachments groups get-operational-status NAME

更改下列內容：

NAME：專案中的 VLAN 連結群組名稱

輸出結果會與下列內容相似：

result:
attachmentStatuses:
- adminEnabled: true
  attachment: https://www.googleapis.com/compute/v1/projects/equinix-gci-testing/regions/us-west2/interconnectAttachments/byohsm-lab-sfo-attachment3
  isActive: ACTIVE
  status: CONNECTION_UP
- adminEnabled: true
  attachment: https://www.googleapis.com/compute/v1/projects/equinix-gci-testing/regions/us-west2/interconnectAttachments/ccsw03-sfo05-z1-a1
  isActive: ACTIVE
  status: CONNECTION_UP
configured:
  availabilitySla:
    effectiveSla: PRODUCTION_NON_CRITICAL
groupStatus: FULLY_UP
intent:
  availabilitySla: PRODUCTION_NON_CRITICAL
operational:
  availabilitySla:
    effectiveSla: PRODUCTION_NON_CRITICAL

指令輸出參考資料

下表列出了 Google Cloud CLI 指令和 interconnects.getDiagnostics API 的輸出參數定義。

輸出參數	說明
`macAddress`	說明 Google Cloud 端專屬互連網路連線組合的 MAC 位址。
`arpCache`	說明專屬互連網路連線的 ARP 快取中，Cloud Router 偵測到的個別相鄰節點。如果連線未組合，則這個欄位沒有任何內容。
`arpCache[].macAddress`	列出這個 ARP 相鄰節點的 MAC 位址。
`arpCache[].ipAddress`	列出這個 ARP 相鄰節點的 IP 位址。
`links[]`	說明專屬互連網路連線的每個連結狀態。
`links[].circuitId`	列出 Google 為這個線路指派的專屬 ID；這個 ID 是在線路啟用期間指派的。
`links[].googleDemarc`	說明 Google 指派的責任分界點；這個分界點是在線路啟用時指派的，由 Google 在授權書中提供給客戶。
`links[].macsec`	連結的 MACsec 狀態。如果未啟用 MACsec，系統會省略這個欄位。
`links[].macsec.ckn`	目前使用的連線關聯金鑰名稱 (CKN)。如果未啟用 MACsec，系統會省略這個欄位。
`links[].macsec.operational`	連結的 MACsec 狀態。如果未啟用 MACsec，系統會省略這個欄位。可能的值如下： TRUE：連結的 MACsec 正在運作。 FALSE：連結上的 MACsec 未運作。
`links[].operationalState`	這個專屬互連網路連結的運作狀態。如果未啟用 MACsec，系統會省略這個欄位。可能的值如下： LINK_OPERATIONAL_STATUS_UP:連結運作正常。 LINK_OPERATIONAL_STATUS_DOWN:連結無法運作。連結的運作狀態不會受到連結的 MACsec 狀態影響。
`links[].receivingOpticalPower`	說明已接收光訊號強度目前的值和狀態。
`links[].receivingOpticalPower.value`	列出已接收光訊號強度目前的值，單位為 dBm。
`links[].receivingOpticalPower.state`	與接收訊號的收發器警告和警示標準相比時，目前值的狀態： OK：值未達警告門檻。 LOW_WARNING：值已低於警告門檻下限。 HIGH_WARNING：值已超過警告門檻上限。 LOW_ALARM：值已低於警示門檻下限。 HIGH_ALARM：值已超過警示門檻上限。
`links[].transmittingOpticalPower`	傳輸的光訊號強度目前的值和狀態。
`links[].transmittingOpticalPower.value`	傳輸的光訊號強度目前的值，單位為 dBm。
`links[].transmittingOpticalPower.state`	與傳輸訊號的收發器警告和警示標準相比時，目前值的狀態： OK：值未達警告門檻。 LOW_WARNING：值已低於警告門檻下限。 HIGH_WARNING：值已超過警告門檻上限。 LOW_ALARM：值已低於警示門檻下限。 HIGH_ALARM：值已超過警示門檻上限。
`links[].lacpStatus`	單一連結的 LACP 資訊。
`links[].lacpStatus.state`	ACTIVE：組合中已設定並啟用的連結。 DETACHED：組合中未設定的連結。
`links[].lacpStatus.googleSystemId`	LACP 交換時 Google Cloud 端通訊埠的系統 ID。
`links[].lacpStatus.neighborSystemId`	LACP 交換時客戶端通訊埠的系統 ID。
`links[].arpCache[]`	`InterconnectDiagnostics.ARPEntry` 物件清單，說明這個連結上顯示的 ARP 相鄰節點項目。如果連結已組合，則這個欄位沒有任何內容。
`links[].arpCache[].macAddress`	這個連結的 ARP 相鄰節點的 MAC 位址。
`links[].arpCache[].ipAddress`	這個連結的 ARP 相鄰節點的 IP 位址。

後續步驟

如要建立專屬互連網路連線，請參閱專屬互連網路佈建總覽。
如要進一步瞭解 Cloud Interconnect 選項，請參閱 Cloud Interconnect 總覽。
如要解決使用 Cloud Interconnect 時可能遇到的常見問題，請參閱疑難排解。

取得診斷資訊 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

服務中斷期間的診斷

佈建時進行診斷

佈建階段

使用診斷工具

這項工作需要的權限

主控台

gcloud

API

使用連線群組的診斷工具

這項工作需要的權限

主控台

gcloud

使用 VLAN 連結群組的診斷資訊

這項工作需要的權限

主控台

gcloud

指令輸出參考資料

後續步驟

取得診斷資訊