Oracle Cloud Infrastructure Documentation

FastConnect Metrics

You can monitor the health, capacity, and performance of your FastConnect connection by using metrics, alarms, and notifications. For more information, see Monitoring Overview and Notifications Overview.

This topic describes the metrics emitted by the metric namespace oci_fastconnect.

Resources: cross-connect groups, virtual circuits

Overview of Metrics: oci_fastconnect

Metrics are available for multiple resources in the FastConnect connection. The metrics help you determine quickly whether your FastConnect connection is up, how much data is flowing over the connection, and whether packets are being dropped for unexpected errors.

FastConnect offers different connectivity models:

  • Connect with an Oracle provider: Metrics are available for virtual circuits in the connection.
  • Connect with a third-party provider: Metrics are available for the cross-connect group (LAG) and virtual circuits in the connection. Metrics for cross-connects will be available in a future release.
  • Colocate with Oracle: Metrics are available for the cross-connect group (LAG) and virtual circuits in the connection. Metrics for cross-connects will be available in a future release.

A cross-connect group (LAG) contains one or more cross-connects. If there are multiple and one goes down, the cross-connect group stays up, but the group might experience a lower overall bandwidth.

Required IAM Policy

To monitor resources, you must be given the required type of access in a An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.

Available Metrics: oci_fastconnect

The metrics listed in the following table are automatically available for each virtual circuit or cross-connect group that you create. You do not need to enable monitoring to get these metrics.

You also can use the Monitoring service to create custom queries.

Each metric includes the following dimensions: 

component
Possible values are crossconnectgroup and virtualcircuit. If you connect through an Oracle provider, only the virtualcircuit component is available.
resourceId
The An Oracle-assigned unique ID called an Oracle Cloud Identifier (OCID). This ID is included as part of the resource's information in both the Console and API. of the resource (either a cross-connect group or virtual circuit).
Metric Metric Display Name Unit Description Dimensions

ConnectionState

Connection State

Binary (1 or 0)

The values are up (1) or down (0).

For a virtual circuit, this is the operational state of the virtual circuit's interface.

For a cross-connect group, this reflects the overall operational state of the cross-connects that make up the cross-connect group (LAG). If at least one of the cross-connects is up, this value is up (1). If all the cross-connects in the group are down, this value is down (0).

component

resourceId

PacketsReceived

Packets Received

Packets

Number of packets received on the FastConnect interface at the Oracle end of the connection.

For a cross-connect group (LAG), the value is the sum across all cross-connects in the group.

BytesReceived

Bytes Received

Bytes

Number of bytes received on the FastConnect interface at the Oracle end of the connection.

For a cross-connect group (LAG), the value is the sum across all cross-connects in the group.

PacketsSent

Packets Sent

Packets

Number of packets sent from the FastConnect interface at the Oracle end of the connection.

For a cross-connect group (LAG), the value is the sum across all cross-connects in the group.

BytesSent

Bytes Sent

Bytes

Number of bytes sent from the FastConnect interface at the Oracle end of the connection.

For a cross-connect group (LAG), the value is the sum across all cross-connects in the group.

PacketsError

Packets with Errors

Packets

Number of packets dropped at the Oracle end of the connection. Dropped packets indicate a misconfiguration in some part of the overall system. Check if there's been a change to the configuration of your VCN, the virtual circuit, or your CPE.

For a cross-connect group (LAG), the value is the sum across all cross-connects in the group.

Using the Console

The instructions depend on which FastConnect connectivity model you use.

If You Use an Oracle Provider

To view default metric charts for a single FastConnect connection
To view default metric charts for all FastConnect connections in a compartment

If You Use a Third-Party Provider or Colocate with Oracle

In this situation, you manage both the physical connection (cross-connects) and logical connection (virtual circuit).

For the physical connection, metrics are available for the cross-connect group (LAG), but not the individual cross-connects. If you are using only a single cross-connect with no cross-connect group, then no metrics are available for the physical connection.

For the logical connection, metrics are available for each virtual circuit.

To view default metric charts for a single FastConnect connection
To view default metric charts for all FastConnect connections in a compartment

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use the following APIs for monitoring: