Oracle Cloud Infrastructure

Monitor health and performance of the Oracle Cloud Infrastructure.

Extension

Free trial

Product information
Release notes

Overview

This extension monitors basics of the Oracle Cloud Infrastructure.

This is intended for users, who:
Want to monitor foundation of their Oracle Cloud Infrastructure, including:

Compute resources
Cloud networking resources
Site-to-Site VPN
Load Balancing
Block storage
Object storage
Filesystem storage
API gateway
OCI serverless functions

This extension does not cover every single service available on Oracle Cloud.
This extension focuses on basic Oracle Cloud Infrastructure services and does not look to monitor Oracle SaaS offerings like e.g. CX, HCM, ERP, SCM, EPM and alike.

Are you looking to extend OCI services visibility to all service available on Oracle Cloud? Look here: Any OCI service metric and log ingestion can be set up leveraging Oracle Connector Hub and push-based ingest. Look for this technology hub tile for instructions how to do it and limitations that come with it.

In brief: push-based ingest requires you to set up ingest functions in OCI and doesn't provide analysis screens for ingested metrics, but it can cover any service metrics. More at Oracle Connector Hub signals ingest

Use cases

This extension enables you to:

Monitor health and performance of the Oracle Cloud Infrastructure
focusing on compute, storage and networking foundation of the infrastructure.

Get started

This extension is executed by the ActiveGate (remote monitoring). You need to have an ActiveGate provisioned in your environment and networking set up so the ActiveGate can connect to the subject OCI tenant you are about to monitor.

To start, activate the extension in your environment using the in-product Hub. Then provide your OCI monitoring endpoint whereabouts. You will need to provide:

Compartment ID
Tenancy
User
Fingerprint
Region
Path location of a PEM key file which extension will use to sign OCI monitoring API requests

for each endpoint you are about to monitor on your OCI.

The User account provided in the configuration must also have enough permissions to read metrics. At least METRIC_READ and METRIC_INSPECT permissions are required, as found at [Permissions Required for Each API Operation](https://docs.oracle.com/en-us/iaas/Content/Identity/Reference/monitoringpolicyreference.htm#Details.

The PEM key file will need to be placed on any ActiveGate that is running the extension, in a location that is accessible to the extension. The recommended default location for the PEM file is:

Linux:

<CONFIG>/remotepluginmodule/agent/conf/certificates/
(default: /var/lib/dynatrace/remotepluginmodule/agent/conf/certificates/)

Windows:

%PROGRAMDATA%\dynatrace\remotepluginmodule\agent\conf\certificates

Note: Because the configuration requires the Compartment ID & region, a new endpoint or monitoring configuration will need to be created to monitor a new region or compartment.

Refer to Oracle documentation for details on how to set up the monitoring endpoint access:

Import Tags

To import tags from OCI, two additional configuration options are required:

Dynatrace environment ID
API Token with Entities.Read and Entities.Write scopes.

Refer to the documentation for creating an API token with the correct scopes.

Details

This extension is built on top of the Extension Framework 2.0 and delivers:

Metrics retrieved from the OCI APIs (extension internally uses Python to connect to the OCI APIs)
A Dashboard
Topology definitions
Unified Analysis screens

Metrics collected:

Compute resources usage and performance
Load balancers and network load balancers usage and performance
Virtual cloud networks usage and performance
Site-to-Site VPN usage and performance
Block storage volumes usage and performance
Object storage volumes usage and performance
Filesystem storage volumes usage and performance
API gateway usage and performance
Serverless OCI functions usage, performance and errors

Compatibility information

OCI API access from ActiveGate is required

Q&A

Q: Can this extension ingest metrics from other OCI services not explicitly listed here?

A: No. This extension is designed to understand specific services metrics and topology, and present their signals on dashboards and predefined analysis screens. Ingesting metrics from other services can be set up leveraging Oracle Connector Hub and push-based ingest. Look for Oracle Connector Hub signals ingest technology support on the Dynatrace Hub.

Q: What OCI API endpoints is this extension connecting to?

A: OCI performance counters are available though a number of different endpoints, whose specific URLs reflect specific monitored services and regions in which those services run. Oracle published the list of API reference endpoints here.

None of these URLs needs to be provided in the extension configuration. Oracle SDK builds those URLs using input the extension requires (Compartment ID, Tenancy, Region) and specific service it monitors (compute, load balancer, VCN, VPN and so on - they are listed above). Oracle SDK libraries are embedded in this extension distribution.

Q: What permissions are required on the OCI side for the extension to work?

Permissions required are METRIC_READ and METRIC_INSPECT found at Permissions Required for Each API Operation.

Q: What is the DDU Consumption of this extension?

A: The formula for DDU consumption of the extension will be published at a later date. For now, when estimating consumption of this Preview version of the extension, take into account the numbers of:

10 metrics per cloud:oci:compute_instance
 4 metrics per cloud:oci:instance_pool
27 metrics per cloud:oci:load_balancer
 9 metrics per cloud:oci:network_load_balancer
12 metrics per cloud:oci:vcn
 6 metrics per cloud:oci:vpn
 5 metrics per cloud:oci:block_volume
10 metrics per cloud:oci:file_system
 2 metrics per cloud:oci:object_store
12 metrics per cloud:oci:api_gateway
 2 metrics per cloud:oci:function

and aggregate these for all OCI tenants you plan to monitor. This way you arrive at the number of metric points that monitoring will bring every monitoring interval.

Metric to DDU consumption multiplier is:

number of metrics * 525.6 DDUs/year

DDU cost above does not include any possible Log events or Custom events triggered by the extension. For more information on this, please visit the DDU log event cost and DDU custom event cost pages.

Subscribe to new releases

Copy to clipboard

Extension content

Content typeNumber of items included

generic type

screen entities lists

screen chart groups

dashboards

metric metadata

108

screen layout

generic relationship

list screen layout

Feature sets

Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.

Feature setsNumber of metrics included

Metric name	Metric key	Description	Unit
Ingress Packets Dropped by Security List	cloud.oci.vcn.ingress.packets.dropped.sl	Packets received from the network, destined for the VNIC, dropped due to security rule violations.	Count
Egress Packets Dropped by Security List	cloud.oci.vcn.egress.packets.dropped.sl	Packets sent by the VNIC, destined for the network, dropped due to security rule violations.	Count
Packets from Network	cloud.oci.vcn.packets.from.network	Packets received at the VNIC from the network, after drops.	Count
Packets to Network	cloud.oci.vcn.packets.to.network	Packets sent from the VNIC to the network, before drops.	Count
Bytes from Network	cloud.oci.vcn.bytes.from.network	Bytes received at the VNIC from the network, after drops.	Byte
Bytes to Network	cloud.oci.vcn.bytes.to.network	Bytes sent from the VNIC to the network, before drops.	Byte
Throttled Ingress Packets	cloud.oci.vcn.throttled.ingress.packets	Packets sent from the VNIC, destined for the network, dropped due to throttling.	Count
Throttled Egress Packets	cloud.oci.vcn.throttled.egress.packets	Packets received from the network, destined for the VNIC, dropped due to throttling.	Count
Ingress Packets Dropped by Full Connection Tracking Table	cloud.oci.vcn.ingress.packets.dropped.fctt	Packets received from the network, destined for the VNIC, dropped due to full connection tracking table.	Count
Egress Packets Dropped by Full Connection Tracking Table	cloud.oci.vcn.egress.packets.dropped.fctt	Packets sent from the VNIC, destined for the network, dropped due to full connection tracking table.	Count
Connection Tracking Table Utilization	cloud.oci.vcn.ctt.util	Total utilization percentage (0-100%) of the connection tracking table.	Percent
Connection Tracking Table Full	cloud.oci.vcn.ctt.full	Boolean (0/false, 1/true) that indicates the connection tracking table is full.	State

Metric name	Metric key	Description	Unit
Inbound Requests	cloud.oci.load_balancer.http.requests	The number of incoming client requests to the backend set.	Count
Active Connections	cloud.oci.load_balancer.active.connections	The number of active connections.	Count
Active SSL Connections	cloud.oci.load_balancer.active.ssl.connections	The number of active SSL connections.	Count
Bytes Received	cloud.oci.load_balancer.bytes.received	The number of bytes received by the load balancer.	Byte
Bytes Sent	cloud.oci.load_balancer.bytes.sent	The number of bytes sent by the load balancer.	Byte
Accepted Connections	cloud.oci.load_balancer.accepted.connections	The number of connections accepted by the load balancer.	Count
Handled Connections	cloud.oci.load_balancer.handled.connections	The number of connections handled by the load balancer.	Count
Failed SSL Handshakes	cloud.oci.load_balancer.failed.ssl.handshake	The number of failed SSL handshakes.	Count
Accepted SSL Handshakes	cloud.oci.load_balancer.accepted.ssl.handshake	The number of accepted SSL handshakes.	Count
Failed Client SSL Cert Verifications	cloud.oci.load_balancer.failed.ssl.client.cert.verify	The number of failed client SSL certificate verifications.	Count
Peak Bandwidth	cloud.oci.load_balancer.peak.bandwidth	Maximum bits per second bandwidth used during the specified interval.	MegaBytePerSecond

Metric name	Metric key	Description	Unit
DRG Packet Drops	cloud.oci.dynamic_routing_gateway.packet_drops	The number of packets sent from the DRG attachment and dropped by the DRG.	Count

Metric name	Metric key	Description	Unit
Volume Read Throughput	cloud.oci.block_volume.read.throughput	Read throughput, expressed as bytes read per interval.	Byte
Volume Write Throughput	cloud.oci.block_volume.write.throughput	Write throughput, expressed as bytes written per interval.	Byte
Volume Read Operations	cloud.oci.block_volume.read.ops	Activity level from I/O reads, expressed as reads per interval.	Count
Volume Write Operations	cloud.oci.block_volume.write.ops	Activity level from I/O writes, expressed as writes per interval.	Count
Volume Throttled Operations	cloud.oci.block_volume.throttled.ops	Total sum of all the I/O operations that were throttled during a given time interval.	Count

Metric name	Metric key	Description	Unit
Read Throughput	cloud.oci.filesystem.read.throughput	File System Read Throughput	Count
Write Throughput	cloud.oci.filesystem.write.throughput	File System Write Throughput	Count
Read Requests	cloud.oci.filesystem.read.requests	File System Read Requests	Count
Write Requests	cloud.oci.filesystem.write.requests	File System Write Requests	Count
Read Latency	cloud.oci.filesystem.read.latency	File System Read Latency	Count
Write Latency	cloud.oci.filesystem.write.latency	File System Write Latency	Count
Metadata Read Latency	cloud.oci.filesystem.metadata.read.latency	File System Metadata Read Latency	Count
Metadata Write Latency	cloud.oci.filesystem.metadata.write.latency	File System Metadata Write Latency	Count
Metadata IOPS	cloud.oci.filesystem.metadata.iops	File System Metadata IOPS	Count
Usage	cloud.oci.filesystem.usage	File System Usage	Count

Metric name	Metric key	Description	Unit
FastConnect Bits Received	cloud.oci.fast_connect.bits_received	Number of bits received on the FastConnect interface at the Oracle end of the connection.	Bit
FastConnect Bits Sent	cloud.oci.fast_connect.bits_sent	Number of bits sent from the FastConnect interface at the Oracle end of the connection.	Bit
FastConnect Connection State	cloud.oci.fast_connect.connection_state	The values are up (1) or down (0).	Count
FastConnect Error Packets	cloud.oci.fast_connect.packets_error	Number of packets dropped due to errors at the Oracle end of the connection.	Count
FastConnect Discard Packets	cloud.oci.fast_connect.packets_discarded	Number of packets discarded at the Oracle end of the connection.	Count
FastConnect Ipv4 BGP Session State	cloud.oci.fast_connect.packets_bgp_session_state	The values are up (1) or down (0).	Count

Metric name	Metric key	Description	Unit
Processed Bytes	cloud.oci.network_load_balancer.processed.bytes	The total number of bytes processed by the network load balancer, including TCP/IP headers.	Byte
Processed Packets	cloud.oci.network_load_balancer.processed.packets	The total number of packets processed by the network load balancer.	Count
Ingress Packets Dropped by Security List	cloud.oci.network_load_balancer.ingress.packets.dropped	The packets received from the network, destined for the network load balancer, dropped because of security rule violations.	Count
Egress Packets Dropped by Security List	cloud.oci.network_load_balancer.egress.packets.dropped	The packets sent by the network load balancer, destined for the network, dropped because of security rule violations.	Count
Healthy Backends	cloud.oci.network_load_balancer.healthy.backends	The number of healthy backend servers present in the network load balancer.	Count
Unhealthy Backends	cloud.oci.network_load_balancer.unhealthy.backends	The number of unhealthy backend servers present in the network load balancer.	Count
New Connections	cloud.oci.network_load_balancer.new.connections	The total number of new connections established between client and a backend server.	Count
New TCP Connections	cloud.oci.network_load_balancer.new.connections.tcp	The total number of new TCP connections established between client and a backend server.	Count
New UDP Connections	cloud.oci.network_load_balancer.new.connections.udp	The total number of new UDP connections established between client and a backend server.	Count

Metric name	Metric key	Description	Unit
-	cloud.oci.function.function_invocation_count	-	-
Function Duration	cloud.oci.function.function_execution_duration	Total function execution duration	MilliSecond
-	cloud.oci.function.function_error_response_count	-	-
-	cloud.oci.function.function_throttled_response_count	-	-

Metric name	Metric key	Description	Unit
Instance Pool Size	cloud.oci.instance_pool.size	Number of instances in the pool.	Count
Instances Provisioning	cloud.oci.instance_pool.provisioning	Number of instances in the pool that are provisioning.	Count
Instances Running	cloud.oci.instance_pool.running	Number of running instances in the pool.	Count
Instances Terminated	cloud.oci.instance_pool.terminated	Number of instances in the pool that are terminating or terminated.	Count

Metric name	Metric key	Description	Unit
Bucket Size	cloud.oci.object_store.size	Total size of objects in a bucket	Byte
Number of Objects	cloud.oci.object_store.count.gauge	Total number of objects in a bucket	Count

Metric name	Metric key	Description	Unit
CPU Utilization	cloud.oci.compute.cpu.util	Activity level from CPU, expressed as a percentage of total time.	Percent
Disk Read Bytes	cloud.oci.compute.disk.read.bytes	Read Throughput, expressed as bytes read per interval.	Byte
Disk Write Bytes	cloud.oci.compute.disk.write.bytes	Write throughput, expressed as bytes written per interval.	Byte
Disk Read I/O	cloud.oci.compute.disk.read.io	Activity level from I/O reads, expressed as reads per interval.	Count
Disk Write I/O	cloud.oci.compute.disk.write.io	Activity level from I/O writes, expressed as writes per interval.	Count
Load Average	cloud.oci.compute.load	Average system load.	Count
Memory Allocation Stalls	cloud.oci.compute.memory.allocation.stalls	Number of times page reclaim was called directly.	Count
Memory Utilization	cloud.oci.compute.memory.util	Space currently in use, measured by pagtes, expressed as a percentage of used pages.	Percent
Network Receive Bytes	cloud.oci.compute.network.receive.bytes	Network receipt throughput, expressed as bytes received.	Byte
Network Transmit Bytes	cloud.oci.compute.network.transmit.bytes	Network transmission throughput, expressed as bytes transmitted.	Bytes

Metric name	Metric key	Description	Unit
IPSec Tunnel State	cloud.oci.vpn.tunnel_state	Whether the tunnel is up (1) or down (0).	State
Packets Received	cloud.oci.vpn.packets_received	Number of packets received at the Oracle end of the connection	Count
Bytes Received	cloud.oci.vpn.bytes_received	Number of bytes received at the Oracle end of the connection	Byte
Packets Sent	cloud.oci.vpn.packets_sent	Number of packets sent from the Oracle end of the connection	Count
Bytes Sent	cloud.oci.vpn.bytes_sent	Number of bytes sent from the Oracle end of the connection	Byte
Packets with Errors	cloud.oci.vpn.packets_error	Number of packets dropped at the Oracle end of the connection	Count

Metric name	Metric key	Description	Unit
API Requests	cloud.oci.api_gateway.http_requests	Number of incoming API client requests to the API gateway	Count
API Responses	cloud.oci.api_gateway.http_responses	Number of http responses that the API gateway has sent back	Count
Bytes Sent	cloud.oci.api_gateway.bytes_sent	Number of bytes sent by the API gateway to API clients	Byte
Bytes Received	cloud.oci.api_gateway.bytes_received	Number of bytes received by the API gateway from API clients	Byte
Gateway Latency	cloud.oci.api_gateway.latency	Average time that it takes for a request to be processed and its response to be sent	Second
Internal Latency	cloud.oci.api_gateway.internal_latency	Time spent internally in the API gateway to process the request	Second
Backend Latency	cloud.oci.api_gateway.integration_latency	Time between the API gateway sending a request to the back-end service and receiving a response from the back-end service	Second
Backend Responses	cloud.oci.api_gateway.backend_http_responses	Count of the HTTP responses returned by the back-end services	Count
Usage Plan Requests	cloud.oci.api_gateway.usage_plan_requests	Number of requests to a given entitlement	Count
Subscriber Requests	cloud.oci.api_gateway.subscriber_requests	Number of requests made by a subscriber	Count
Subscriber Quota Proportion Used	cloud.oci.api_gateway.subscriber_quota_proportion_used	Proportion of an entitlement's quota that has been consumed by a subscriber	Count
Subscriber Rate Limit Proportion Used	cloud.oci.api_gateway.subscriber_rate_limit_proportion_used	Proportion of an entitlement's rate limit that has been consumed by a subscriber	Count

Metric name	Metric key	Description	Unit
Backend Servers	cloud.oci.load_balancer.backend.servers	The number of backend servers in the backend set.	Count
Unhealthy Backend Servers	cloud.oci.load_balancer.unhealthy.backend.servers	The number of unhealthy backend servers in the backend set.	Count
HTTP Responses	cloud.oci.load_balancer.http.responses	The number of HTTP responses received.	Count
Average HTTP Response Time	cloud.oci.load_balancer.response.time.http	Average response time of backend servers, HTTP only.	MilliSecond
Average TCP Response Time	cloud.oci.load_balancer.response.time.tcp	Average time to the first byte of response from backend servers, TCP only.	MilliSecond
Backend Timeouts	cloud.oci.load_balancer.backend.timeouts	The number of timeouts across all backend servers.	Count
Keep-alive Connections	cloud.oci.load_balancer.keepalive.connections	The number of keep-alive connections.	Count
Closed Connections	cloud.oci.load_balancer.closed.connections	The number of connections closed between the load balancer and backend servers.	Count
Invalid Header Responses	cloud.oci.load_balancer.invalid.header.responses	The number of invalid header responses across all backend servers.	Count
HTTP 200 Responses	cloud.oci.load_balancer.http.responses.200	The number of HTTP 200 responses received.	Count
HTTP 2xx Responses	cloud.oci.load_balancer.http.responses.2xx	The number of HTTP 2xx responses received.	Count
HTTP 3xx Responses	cloud.oci.load_balancer.http.responses.3xx	The number of HTTP 3xx responses received.	Count
HTTP 4xx Responses	cloud.oci.load_balancer.http.responses.4xx	The number of HTTP 4xx responses received.	Count
HTTP 5xx Responses	cloud.oci.load_balancer.http.responses.5xx	The number of HTTP 5xx responses received.	Count
HTTP 502 Responses	cloud.oci.load_balancer.http.responses.502	The number of HTTP 502 responses received.	Count
HTTP 504 Responses	cloud.oci.load_balancer.http.responses.504	The number of HTTP 504 responses received.	Count

Related to Oracle Cloud Infrastructure

Oracle Cloud

Oracle Cloud performance monitoring and optimization.

Full version history

To have more information on how to install the downloaded package, please follow the instructions on this page.

ReleaseDate

Full version history

New features:

Support for Dynamic Routing Gateway service (DRG)
Support for Fast Connect service

Full version history

Patch level change:

Recompiled for compatibility with ActiveGate running RHEL 7.9.

Full version history

Patch level changes:

Added metric descriptions and sourceEntityTypes
Added function metadata tagging
Update Dynatrace API calls to use configured communication URL

Full version history

Added more OCI services monitoring:

API gateway
Serverless functions

Marking the 1.0 release.

Full version history

First GA release. We look for your feedback, through Community, on both the extension focus, scope and documentation.

Full version history

Basics of the basics release - for preview.

4 Results

Found in 'All' filtered by:

Oracle Exadata

Monitor Oracle Exadata systems for performance, usage and availability

Extension

oracle
database
exadata

Oracle Database

Observe, analyze and optimize the usage, health and performance of your database

Extension

oracle
database
full-stack
log-analytics
logs
monitoring
performance