You can monitor the health, capacity, and performance of your FastConnect connection by using metrics, alarms, and notifications. For more information, see Monitoring and Notifications.
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.
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 granted the required type of access in a policy 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, contact the administrator to find out what type of access you were granted and which compartment you need to work in. For more information about user authorizations for monitoring, see IAM Policies.
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. See Building Metric Queries.
Each metric includes the following dimensions:
COMPONENT
Possible values are crossconnectgroup,
crossconnect, and virtualcircuit. If you
connect through an Oracle
partner, only the virtualcircuit component is
available.
RESOURCEID
The OCID of the resource (either a cross-connect
group, cross-connect, or virtual circuit).
RESOURCENAME
The name given to the resource.
Metric
Metric Display Name
Unit
Description
Dimensions
BitsReceived
Bits Received
Bits
Number of bits 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.
component
resourceId
resourceName
BitsSent
Bits Sent
Bits
Number of bits 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.
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.
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.
ConnectionState
Connection State
Binary (1 or 0)
The values are up (1) or down (0).
For a virtual circuit, 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).
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.
PacketsDiscarded
Packets Discarded
Packets
Number of packets discarded at the Oracle end of the
connection.
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.
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.
Ipv4BgpSessionState
IPv4 BGP Session State
Binary (1 or 0)
The values are up (1) or down (0). The status of the IPv4 BGP session
for a virtual circuit.
Ipv6BgpSessionState
IPv6 BGP Session State
Binary (1 or 0)
The values are up (1) or down (0). The status of the IPv6 BGP session
for a virtual circuit.
Using the Console 🔗
The instructions depend on which FastConnect connectivity model you use.
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.
Open the navigation menu and select Networking. Under Customer connectivity, select FastConnect.
Click the connection you're interested in.
View the metrics for the resource you're interested in:
For a cross-connect group: Under Resources, click Metrics. The default metrics charts are displayed on the resulting page.
For a virtual circuit:
Under Resources, click Virtual Circuits.
Click the virtual circuit you're interested in. If it's a private virtual circuit, the default metrics charts are displayed on the resulting page. If it's a public virtual circuit, click Metrics to view the charts.