InterconnectDiagnostics

Diagnostics information about the Interconnect connection, which contains detailed and current technical information about Trusted Cloud side of the connection.

JSON representation 
{
  "macAddress": string,
  "arpCaches": [
    {
      object (ARPEntry)
    }
  ],
  "links": [
    {
      object (LinkStatus)
    }
  ],
  "bundleOperationalStatus": enum (BundleOperationalStatus),
  "bundleAggregationType": enum (BundleAggregationType)
}
Fields
macAddress

string

The MAC address of the Interconnect's bundle interface.
arpCaches[]

object (ARPEntry)

A list of

InterconnectDiagnostics.ARPEntry

objects, describing individual neighbors currently seen by the Trusted Cloud router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled.
bundleOperationalStatus

enum (BundleOperationalStatus)

The operational status of the bundle interface.
bundleAggregationType

enum (BundleAggregationType)

The aggregation type of the bundle interface.

ARPEntry

Describing the ARP neighbor entries seen on this link

JSON representation 
{
  "macAddress": string,
  "ipAddress": string
}
Fields
macAddress

string

The MAC address of this ARP neighbor.
ipAddress

string

The IP address of this ARP neighbor.

LinkStatus

JSON representation 
{
  "circuitId": string,
  "googleDemarc": string,
  "receivingOpticalPower": {
    object (LinkOpticalPower)
  },
  "transmittingOpticalPower": {
    object (LinkOpticalPower)
  },
  "lacpStatus": {
    object (LinkLACPStatus)
  },
  "operationalStatus": enum (LinkOperationalStatus),
  "arpCaches": [
    {
      object (ARPEntry)
    }
  ],
  "macsec": {
    object (MacsecStatus)
  }
}
Fields
circuitId

string

The unique ID for this link assigned during turn up by Trusted Cloud.
googleDemarc

string

The Demarc address assigned by Trusted Cloud and provided in the LoA.
receivingOpticalPower

object (LinkOpticalPower)

An

InterconnectDiagnostics.LinkOpticalPower

object, describing the current value and status of the received light level.
transmittingOpticalPower

object (LinkOpticalPower)

An

InterconnectDiagnostics.LinkOpticalPower

object, describing the current value and status of the transmitted light level.
lacpStatus

object (LinkLACPStatus)
operationalStatus

enum (LinkOperationalStatus)

The operational status of the link.
arpCaches[]

object (ARPEntry)

A list of

InterconnectDiagnostics.ARPEntry

objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled
macsec

object (MacsecStatus)

Describes the status of MACsec encryption on this link.

LinkOpticalPower

JSON representation 
{
  "value": number,
  "state": enum (State)
}
Fields
value

number

Value of the current receiving or transmitting optical power, read in dBm. 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.
state

enum (State)

The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include:

  • 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.

State

State of the current optical power.

Enums
OK The value of the current optical power has not crossed a warning threshold.
LOW_WARNING The value of the current optical power has crossed below the low warning threshold.
HIGH_WARNING The value of the current optical power has crossed above the high warning threshold.
LOW_ALARM The value of the current optical power has crossed below the low alarm threshold.
HIGH_ALARM The value has crossed above the high alarm threshold.

LinkLACPStatus

JSON representation 
{
  "state": enum (State),
  "googleSystemId": string,
  "neighborSystemId": string
}
Fields
state

enum (State)

The state of a LACP link, which can take one of the following values:

  • ACTIVE: The link is configured and active within the bundle.
  • DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty.
googleSystemId

string

System ID of the port on Trusted Cloud side of the LACP exchange.
neighborSystemId

string

System ID of the port on the neighbor's side of the LACP exchange.

State

Enums
ACTIVE The link is configured and active within the bundle.
DETACHED The link is not configured within the bundle, this means the rest of the object should be empty.

LinkOperationalStatus

Enums

MacsecStatus

Describes the status of MACsec encryption on the link.

JSON representation 
{
  "operational": boolean,
  "ckn": string
}
Fields
operational

boolean

Indicates whether or not MACsec is operational on this link.
ckn

string

Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational.

BundleOperationalStatus

Enums
BUNDLE_OPERATIONAL_STATUS_UP If bundleAggregationType is LACP: LACP is established and at least one link in the bundle has UP operational status. If bundleAggregationType is STATIC: all links in the bundle (typically just one) have UP operational status.
BUNDLE_OPERATIONAL_STATUS_DOWN If bundleAggregationType is LACP: LACP is not established and/or all links in the bundle have DOWN operational status. If bundleAggregationType is STATIC: one or more links in the bundle has DOWN operational status.

BundleAggregationType

Enums
BUNDLE_AGGREGATION_TYPE_LACP LACP is enabled.
BUNDLE_AGGREGATION_TYPE_STATIC LACP is disabled.