Getting Cloud Interconnect Diagnostics

Beta

This product or feature is covered by the Pre-GA Offerings Terms of the Google Cloud Platform Terms of Service. Pre-GA products and features may have limited support, and changes to pre-GA products and features may not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

Cloud Interconnect diagnostics allow you to troubleshoot your Cloud Interconnect during provisioning and after activation.

The diagnostics provide you current, detailed technical information about the Google Cloud side of the Cloud Interconnect connection on demand.

Diagnostics during provisioning

Viewing diagnostics provides you with the information required to troubleshoot and fix problems in your on-premises router configuration, which can be helpful if your Cloud Interconnect fails to progress through the provisioning process.

The diagnostics results contain different data depending on what stage in the provisioning process your Cloud Interconnect is in. The major and minor steps are listed in the next section. This diagnostic information provides you with possible next steps to take to ensure that the provisioning process progresses without further issues.

Use the command output reference to interpret diagnostic command results or the information provided in the Google Cloud Console.

Provisioning stages

The Cloud Interconnect provisioning process occurs in multiple stages. You must meet the following requirements in each stage before you can move on to the next one:

• Stage 1: Circuit connection:

  • The optical power state is OK
  • LACP is detached
  • ARP entries are present on the circuit(s)

• Stage 2: Circuit qualification (Multiple links):

  • The optical power state is OK
  • LACP is detached
  • ARP entries are present on the circuit(s)

• Stage 3: Production configuration:

  • The optical power state is OK
  • LACP is active
  • ARP entries are present on the Cloud Interconnect

Using diagnostics

Console

1. Go to the Cloud Interconnect Physical connections tab in the Google Cloud Console.
   Go to the Physical connections tab
2. Click on the name of a Cloud Interconnect.
3. On the Cloud Interconnect Details page, diagnostics information is in the following screen locations:
   • For warnings or errors, look at the Status field in the upper left of the screen.
   • For the provisioned capacity of the Cloud Interconnect look at the Provisioned Capacity field.
   • If you suspect issues with the Cloud Interconnect, look at the VLAN Attachments section for information like the effective capacity of the Cloud Interconnect, the number of down links, and so on.
   • For additional details, such as light levels, look at the Link circuit info section.

gcloud

Enter the following command to see diagnostics information for the Cloud Interconnect.

• Replace [NAME] with the name of the Cloud Interconnect in your project.
• Replace [PROJECT_ID] with the id of the Google Cloud project.

gcloud beta compute interconnects get-diagnostics [NAME] --project=[PROJECT_ID]

The command output should look similar to the example below:

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"

api

Get Diagnostics interconnects.getDiagnostics method where [NAME] is the Cloud Interconnect name.

 GET https://compute.googleapis.com/compute/projects/[PROJECT_ID]/global/interconnects/[NAME]/diagnostics

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

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

Command output reference

The output parameters for the gcloud commands and the interconnects.getDiagnostics API have the meanings listed in the following table.

Note: If you want to trigger on-premises warnings for the value of the transmitting and receiving optical power, you can take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links.

Output parameter	Description
macAddress	Describes the MAC address of the Cloud Interconnect bundle on the Google Cloud side.
arpCache	Describes individual neighbors currently seen by the Cloud Router in the ARP cache for the Cloud Interconnect. This is empty when the Cloud Interconnect is not bundled.
arpCache[].macAddress	Lists the The MAC address of this ARP neighbor.
arpCache[].ipAddress	Lists the IP address of this ARP neighbor.
links[]	Describes the status for each link on the Cloud Interconnect.
links[].circuitId	Lists the Google-assigned unique ID for this circuit, as assigned during circuit turn-up
links[].googleDemarc	Describes the Google-assigned demarc, as assigned at circuit turn-up and provided by Google to the customer in the LOA.
links[].receivingOpticalPower	Describes the current value and status for the received light level.
links[].receivingOpticalPower.value	Lists the current value of the received light level, in dBm.
links[].receivingOpticalPower.state	The status of the current value when compared to the warning and alarm levels for the receiving transceiver. OK: The value has not crossed a warning threshold. LOW_WARNING: The value has crossed below the low warning threshold. HIGH_WARNING: The value has crossed above the high warning threshold. LOW_ALARM: The value has crossed below the low alarm threshold. HIGH_ALARM: The value has crossed above the high alarm threshold.
links[].transmittingOpticalPower	The current value and status for the transmit light level.
links[].transmittingOpticalPower.value	The current value of the transmitting light level, in dBm.
links[].transmittingOpticalPower.state	The status of the current value when compared to the warning and alarm levels for the transmitting transceiver. OK: The value has not crossed a warning threshold. LOW_WARNING: The value has crossed below the low warning threshold. HIGH_WARNING: The value has crossed above the high warning threshold. LOW_ALARM: The value has crossed below the low alarm threshold. HIGH_ALARM: The value has crossed above the high alarm threshold.
links[].lacpStatus	The LACP information for the single link.
links[].lacpStatus.state	ACTIVE: The link is configured and active within the bundle. DETACHED: The link is not configured within the bundle.
links[].lacpStatus.googleSystemId	System ID of the port on the Google Cloud side of the LACP exchange.
links[].lacpStatus.neighborSystemId	System ID of the port on the customer's side of the LACP exchange.
links[].arpCache[]	A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled.
links[].arpCache[].macAddress	The MAC address of this ARP neighbor on this link.
links[].arpCache[].ipAddress	The IP address of this ARP neighbor on this link.