Get diagnostics

Console

1. In the Google Cloud console, go to the Cloud Interconnect Physical connectionstab.

   Go to Physical connections

2. Select the name of a Dedicated Interconnect connection.

3. Diagnostics information is in the following locations on the connection details page:

   • For warnings or errors, see the Statusfield.
   • For the provisioned capacity of the Dedicated Interconnect, see the Provisioned capacityfield.
   • If you suspect issues with the Dedicated Interconnect connection, see the VLAN attachmentssection for information such as the effective capacity of the connection or the number of down links.
   • For additional details, such as light levels, see the Link circuit infosection.

gcloud

Use the gcloud compute interconnects get-diagnostics command:

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

Replace the following:

• NAME : the name of the Dedicated Interconnect connection in your project
• PROJECT_ID : the ID of the Google Cloud project

The output is similar to the following:

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

Use the interconnects.getDiagnostics method :

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

Replace the following:

• PROJECT_ID : the ID of the Google Cloud project
• NAME : the name of the Dedicated Interconnect connection in your project

If this command succeeds, it returns InterconnectDiagnostics output in the following format. To interpret the output, see the command output reference .

{
  "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"
        }
      ]
    }
  ]
}

Console

1. In the Google Cloud console, go to the Cloud Interconnect Physical connectionstab.

   Go to Physical connections

2. In the Interconnect groupstable, select the name of a Dedicated Interconnect connection group.

3. Diagnostics information is in the following locations on the group details page:

   • Near the top of the page, you can view the group's status and description.
   • Under the status and description, you can view how many of your connections are up, your intended SLA, and whether you are eligible for your intended SLA.
   • If there is a blocker preventing your connection group from meeting the requirements of your intended SLA, those blockers appear in the SLA eligibility blockersfield under the previous section.
   • The table at the bottom of the page displays details about each connection in your connection group.

gcloud

Use the gcloud compute interconnects groups get-operational-status command, replacing NAME with the name of the Dedicated Interconnect connection you want to check:

gcloud compute interconnects groups get-operational-status NAME 

Console

1. In the Google Cloud console, go to the Cloud Interconnect VLAN attachmentstab.

   Go to VLAN attachments

2. Select the VLAN attachment group that you want to edit.

3. Diagnostics information is in the following locations on the group details page:

   • Near the top of the page, you can view the group's status and description.
   • Under the status and description, you can view how many of your VLAN attachments are up, your intended SLA, and whether you are eligible for your intended SLA.
   • If there is a blocker preventing your VLAN attachment group from meeting the requirements of your intended SLA, those blockers appear in the SLA eligibility blockersfield under the previous section.
   • The table at the bottom of the page displays details about each VLAN attachment in your VLAN attachment group.

gcloud

Use the gcloud compute interconnects attachments groups get-operational-status command:

gcloud compute interconnects attachments groups get-operational-status NAME 

Replace the following:

• NAME : the name of the VLAN attachment group in your project

The output is similar to the following:

 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