OCI File Storage

Overview

Oracle Cloud Infrastructure (OCI) File Storage is a fully managed, elastic, enterprise-grade storage service that enables servers and applications to access data through shared file systems.

This integration allows you to monitor and alert on File Storage status, throughput, and errors by collecting metrics and tags from the [oci_filestorage][1] namespace.

Setup

Installation

Once you set up the [Oracle Cloud Infrastructure][2] integration, ensure that any namespaces mentioned above are included in your [Connector Hub][3].

Data Collected

Metrics

oci.filestorage.file_system_read_average_latency_by_size
(gauge)
Read latency by size. Expressed as average read latency per second, grouped by size.
Shown as second
oci.filestorage.file_system_read_requests_by_size
(gauge)
Read requests by size. Expressed as operation per second, grouped by size.
Shown as operation
oci.filestorage.file_system_read_throughput
(count)
Read throughput for the file system. If the file system is exported through multiple mount targets, total throughput for all mount targets is displayed. Expressed as bytes read per second.
Shown as byte
oci.filestorage.file_system_usage
(gauge)
Total space utilization for a file system. Expressed as GiB consumed per second.
Shown as byte
oci.filestorage.file_system_write_average_latency_by_size
(gauge)
Write latency by size. Expressed as average write latency per second, grouped by size.
Shown as second
oci.filestorage.file_system_write_requests_by_size
(count)
Write requests by size. Expressed as operation per second, grouped by size.
Shown as operation
oci.filestorage.file_system_write_throughput
(count)
Write throughput for the file system. If the file system is exported through multiple mount targets, total throughput for all mount targets is displayed. Expressed as bytes written per second.
Shown as byte
oci.filestorage.kerberos_errors
(count)
Kerberos errors seen by the mount target while receiving IO from an NFS client. Expressed as a sum of errors per interval.
Shown as error
oci.filestorage.ldap_connection_errors
(count)
Connection failures between mount targets and the LDAP server for this outbound connector. Expressed as error count by error type per interval.
Shown as error
oci.filestorage.ldap_request_average_latency
(gauge)
Mount target to LDAP server request latency for this outbound connector. Expressed as mean latency, in seconds, by request type.
Shown as second
oci.filestorage.ldap_request_errors
(count)
LDAP query failures over an established connection between mount targets and the LDAP server for this outbound connector. Expressed as error count by error type per interval.
Shown as error
oci.filestorage.ldap_request_throughput
(count)
Requests from the mount target to the LDAP server through its outbound connector. Expressed as request type and outbound connector per interval.
Shown as request
oci.filestorage.metadata_iops
(gauge)
IOPs (Input/Output Operations Per Second) for the following NFS operations: CREATE, GETATTR, SETATTR, and REMOVE. Expressed as operations per second.
Shown as operation
oci.filestorage.metadata_request_average_latency
(gauge)
Average metadata request latency for the following NFS operations: CREATE, GETATTR, SETATTR, and REMOVE. Expressed as average latency per second, grouped by operation.
Shown as second
oci.filestorage.mount_target_connections
(count)
Number of client connections for the mount target. Expressed as total connection count at the interval.
Shown as connection
oci.filestorage.mount_target_health
(gauge)
Number of successfully executed NFS API requests. Expressed as a percentage of total requests per interval.
Shown as percent
oci.filestorage.mount_target_read_throughput
(count)
Read throughput for the mount target. If the mount target exports multiple file systems, total throughput for all file systems is displayed. Expressed as bytes read per interval.
Shown as byte
oci.filestorage.mount_target_write_throughput
(count)
Write throughput for the mount target. If the mount target exports multiple file systems, total throughput for all file systems is displayed. Expressed as bytes written per interval.
Shown as byte
oci.filestorage.replication_egress_throughput
(count)
Data that has been copied out of the source region. Only applicable for cross-region replication. Expressed as a sum of bytes written per interval.
Shown as byte
oci.filestorage.replication_recovery_point_age
(gauge)
Age of the last fully copied snapshot that was applied to the target file system. Or, how much older the data on the target file system is than the source file system. Expressed as time since the source snapshot was taken. Monitor this metric to ensure that the data on the target file system isn't older than your requirements allow (RPO).
Shown as time
oci.filestorage.replication_throughput
(count)
Throughput of the data transferred out of the source file system. Expressed as bytes read per interval.
Shown as byte

Service Checks

OCI File Storage does not include any service checks.

Events

OCI File Storage does not include any events.

Troubleshooting

Need help? Contact [Datadog support][5]. [1]: https://docs.oracle.com/en-us/iaas/Content/File/Reference/filemetrics.htm [2]: https://docs.datadoghq.com/integrations/oracle_cloud_infrastructure/ [3]: https://cloud.oracle.com/connector-hub/service-connectors [4]: https://github.com/DataDog/integrations-internal-core/blob/main/oci_file_storage/metadata.csv [5]: https://docs.datadoghq.com/help/