Service Gateway Metrics
You can monitor the health, capacity, and performance of your service gateways by using metrics, alarms, and notifications.
For more information, see Monitoring and Notifications.
This topic describes the metrics emitted by the metric namespace oci_service_gateway
.
Resources: Service gateways
Overview of Metrics: oci_service_gateway
A service gateway is used to enable on-premises hosts or VCN hosts to privately access Oracle services (such as Object Storage and Autonomous Database) without exposing the resources to the public internet.
The available metrics help you determine quickly if your service gateway is up, how much data is flowing through the gateway, and if packets are being dropped for unexpected errors.
- Traffic to and from the service gateway: Per-gateway traffic levels (packets and bytes), which can help you identify meaningful increases or decreases in traffic coming in and out of the gateway.
- Packets dropped: Per-gateway drops (dropped packets), which can help you identify changes in traffic caused by issues such as gateway misconfiguration or unrecognized packet protocol.
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_service_gateway
The metrics listed in the following table are automatically available for each service gateway 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 one or more of the following dimensions:
- RESOURCEID
- The OCID of the service gateway.
- DROPTYPE
- The type of packet drop:
Metric | Metric Display Name | Unit | Description | Dimensions |
---|---|---|---|---|
packetsToService
|
Packets to Service |
Packets |
The number of packets successfully sent from the service gateway toward Oracle services. |
resourceId
|
packetsFromService
|
Packets from Service |
Packets |
The number of packets successfully sent from the service gateway toward customer instances. |
|
bytesToService
|
Bytes to Service |
Bytes |
The number of bytes successfully sent from the service gateway toward Oracle services. |
|
bytesFromService
|
Bytes from Service |
Bytes |
The number of bytes successfully sent from the service gateway toward customer instances. |
|
sgwDropsFromService
|
Packet Drops from Service |
Packets |
The number of packets dropped while sending packets from the service gateway toward customer instances. |
|
sgwDropsToService
|
Packet Drops to Service |
Packets |
The number of packets dropped while sending packets from the service gateway toward Oracle services. |
|
Using the Console
- Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.
- In Compartment, select the compartment you're interested in.
- For Metric Namespace, select oci_service_gateway.
- The Service Metrics page dynamically updates the page to show charts for each metric emitted by the selected metric namespace.
By default, the charts show a separate line for each resource in the compartment.
Using the API
For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.
- Monitoring API for metrics and alarms
- Notifications API for notifications (used with alarms)