OCI File Storage monitoring
OCI File Storage is a managed network file system service in Oracle Cloud Infrastructure (OCI) that provides scalable, shared file storage for compute instances using NFS.
Overview
OCI File Storage monitoring in Site24x7 helps you track the performance and availability of file systems and their dependent components, such as mount targets, replication relationships, and authentication connectors. It provides visibility into key metrics like throughput, latency, IOPS, storage usage, and replication lag, enabling you to detect issues early, maintain application reliability, and meet replication SLAs across OCI environments.
Site24x7's integration with OCI File Storage provides monitoring for the following monitor types:
- File System: Tracks storage usage, throughput, latency, metadata, and quota violations.
- Mount Target: Monitors NFS connectivity, throughput, health, and authentication.
- Mount Target (FS): Provides per-mount target metrics scoped to a file system.
- File System Replication: Tracks replication throughput and lag from source.
- File System Replication Target: Monitors incoming replication and sync status.
- Outbound Connector: Tracks LDAP connector performance and errors.
When to monitor OCI File Storage
Monitor OCI File Storage when:
- Applications depend on shared file systems for data access.
- You need visibility into NFS performance and connections.
- Replication is configured for disaster recovery.
- LDAP or Kerberos authentication is used for access control.
- Storage growth needs to be tracked for capacity planning.
Benefits of Site24x7’s OCI File Storage integration
Site24x7's integration with OCI File Storage provides the following benefits:
- Monitor file system performance using throughput, latency, and IOPS.
- Analyze workload patterns using I/O-size-based metrics.
- Track metadata operations that affect performance.
- Ensure replication health and data protection.
- Detect authentication failures and connectivity issues.
- View all file storage components in one place.
Use cases
Here are a few use cases for OCI File Storage monitoring:
- A media streaming platform uses OCI File Storage to store shared assets across multiple compute instances. During high-traffic periods, users experience slow content loading. The operations team monitors read throughput and latency metrics and notices increased latency for large I/O sizes. Correlating this with throughput saturation, the team scales mount targets and optimizes data access, restoring performance before it impacts more users.
- An e-commerce platform uses cross-region replication to ensure data durability. During routine monitoring, the IT team observes an increase in recovery point age. This indicates replication lag. By analyzing replication throughput and network conditions, the team identifies bandwidth constraints and resolves the issue. This ensures that the recovery point objective remains within acceptable limits and prevents data loss during failover scenarios.
Setup and configuration
To get started with OCI File Storage monitoring:
- Site24x7 uses cross-tenancy access to monitor your resources using Site24x7's tenancy user. Log in to your Site24x7 account and create a specific policy to allow Site24x7 to view your resources without affecting your security.
- On the Integrate OCI Monitor page, select OCI File Storage from the Services to be discovered list.
Permissions
Ensure that Site24x7 receives the following permissions to monitor OCI File Storage:
- read file systems
- read mount targets
- read export sets
- read replications
- read outbound connectors
Polling frequency
Site24x7 queries OCI service-level APIs according to the set polling frequency (from once a minute to once a day) to collect metrics from an OCI File Storage monitor.
Supported metrics
The supported metrics for OCI File Storage monitors are provided below.
OCI File System
| Metric name | Description | Statistics | Unit |
|---|---|---|---|
| File System Usage | Total metered storage usage of the file system. | Average | Bytes |
| Read Throughput | Total read throughput. | Average | Bytes/sec |
| Write Throughput | Total write throughput. | Average | Bytes/sec |
| Read Requests | Total read request count across all I/O sizes. | Average | Count |
| Write Requests | Total write request count across all I/O sizes. | Average | Count |
| Read Requests (0B–8KiB) | Read requests for I/O size 0B–8KiB. | Average | Count |
| Read Requests (8KiB–64KiB) | Read requests for I/O size 8KiB–64KiB. | Average | Count |
| Read Requests (64KiB–1MiB) | Read requests for I/O size 64KiB–1MiB. | Average | Count |
| Write Requests (0B–8KiB) | Write requests for I/O size 0B–8KiB. | Average | Count |
| Write Requests (8KiB–64KiB) | Write requests for I/O size 8KiB–64KiB. | Average | Count |
| Write Requests (64KiB–1MiB) | Write requests for I/O size 64KiB–1MiB. | Average | Count |
| Read Latency | Average read latency across all I/O sizes. | Average | ms |
| Write Latency | Average write latency across all I/O sizes. | Average | ms |
| Read Latency (0B–8KiB) | Average read latency for I/O size 0B–8KiB. | Average | ms |
| Read Latency (8KiB–64KiB) | Average read latency for I/O size 8KiB–64KiB. | Average | ms |
| Read Latency (64KiB–1MiB) | Average read latency for I/O size 64KiB–1MiB. | Average | ms |
| Write Latency (0B–8KiB) | Average write latency for I/O size 0B–8KiB. | Average | ms |
| Write Latency (8KiB–64KiB) | Average write latency for I/O size 8KiB–64KiB. | Average | ms |
| Write Latency (64KiB–1MiB) | Average write latency for I/O size 64KiB–1MiB. | Average | ms |
| Metadata Request Avg Latency | Average latency for all metadata operations. | Average | ms |
| Metadata Latency (Create) | Average latency for metadata create operations. | Average | ms |
| Metadata Latency (Getattr) | Average latency for metadata getattr operations. | Average | ms |
| Metadata Latency (Setattr) | Average latency for metadata setattr operations. | Average | ms |
| Metadata Latency (Remove) | Average latency for metadata remove operations. | Average | ms |
| Metadata IOPS | Total metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Create) | Create metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Getattr) | Getattr metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Setattr) | Setattr metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Remove) | Remove metadata operations per second. | Average | Count/sec |
| Soft Quota Violations | Number of users exceeding soft quota limits. | Sum | Count |
| Hard Quota Violations | Number of users exceeding hard quota limits. | Sum | Count |
OCI Mount Target (FS)
| Metric name | Description | Statistics | Unit |
|---|---|---|---|
| File System Usage | Storage usage as seen through this mount target. | Average | Bytes |
| Read Throughput | Read throughput through this mount target. | Average | Bytes/sec |
| Write Throughput | Write throughput through this mount target. | Average | Bytes/sec |
| Read Requests | Total read request count. | Average | Count |
| Write Requests | Total write request count. | Average | Count |
| Read Requests (0B–8KiB) | Read requests for I/O size 0B–8KiB. | Average | Count |
| Read Requests (8KiB–64KiB) | Read requests for I/O size 8KiB–64KiB. | Average | Count |
| Read Requests (64KiB–1MiB) | Read requests for I/O size 64KiB–1MiB. | Average | Count |
| Write Requests (0B–8KiB) | Write requests for I/O size 0B–8KiB. | Average | Count |
| Write Requests (8KiB–64KiB) | Write requests for I/O size 8KiB–64KiB. | Average | Count |
| Write Requests (64KiB–1MiB) | Write requests for I/O size 64KiB–1MiB. | Average | Count |
| Read Latency | Average read latency. | Average | ms |
| Write Latency | Average write latency. | Average | ms |
| Read Latency (0B–8KiB) | Average read latency for I/O size 0B–8KiB. | Average | ms |
| Read Latency (8KiB–64KiB) | Average read latency for I/O size 8KiB–64KiB. | Average | ms |
| Read Latency (64KiB–1MiB) | Average read latency for I/O size 64KiB–1MiB. | Average | ms |
| Write Latency (0B–8KiB) | Average write latency for I/O size 0B–8KiB. | Average | ms |
| Write Latency (8KiB–64KiB) | Average write latency for I/O size 8KiB–64KiB. | Average | ms |
| Write Latency (64KiB–1MiB) | Average write latency for I/O size 64KiB–1MiB. | Average | ms |
| Metadata Request Avg Latency | Average latency for metadata operations. | Average | ms |
| Metadata Latency (Create) | Average latency for metadata create operations. | Average | ms |
| Metadata Latency (Getattr) | Average latency for metadata getattr operations. | Average | ms |
| Metadata Latency (Setattr) | Average latency for metadata setattr operations. | Average | ms |
| Metadata Latency (Remove) | Average latency for metadata remove operations. | Average | ms |
| Metadata IOPS | Total metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Create) | Create metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Getattr) | Getattr metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Setattr) | Setattr metadata operations per second. | Average | Count/sec |
| Metadata IOPS (Remove) | Remove metadata operations per second. | Average | Count/sec |
OCI Mount Target
| Metric name | Description | Statistics | Unit |
|---|---|---|---|
| Read Throughput | NFS read throughput through the mount target. | Sum | Bytes/sec |
| Write Throughput | NFS write throughput through the mount target. | Sum | Bytes/sec |
| Connections | Number of active NFS client connections. | Sum | Count |
| Health | Overall mount target health status. | Average | Percent |
| Health Success Rate | Percentage of successful health checks. | Average | Percent |
| Health Error Rate | Percentage of failed health checks. | Average | Percent |
| Kerberos Errors | Number of Kerberos authentication errors. | Sum | Count |
| LDAP Request Throughput | Number of LDAP requests processed per second. | Sum | Count/sec |
| LDAP Request Avg Latency | Average latency of LDAP requests. | Average | ms |
| LDAP Connection Errors | Number of LDAP connection errors. | Sum | Count |
| LDAP Request Errors | Number of failed LDAP requests. | Sum | Count |
| LDAP Trusted Certificate Expiry | Time remaining before the LDAP trusted certificate expires. | Average | Days |
OCI File System Replication
| Metric name | Description | Statistics | Unit |
|---|---|---|---|
| Replication Throughput | Data transfer rate for replication from source to target. | Average | Bytes/sec |
| Replication Egress Throughput | Egress bytes transferred during replication. | Sum | Bytes/sec |
| Recovery Point Age | Time since the last successful replication snapshot. Indicates how far behind the target is from the source. | Average | Seconds |
| Replication Recovery Point Age | Time since the last successful replication snapshot. Indicates how far behind the target is from the source. | Maximum | Seconds |
OCI File System Replication Target
| Metric name | Description | Statistics | Unit |
|---|---|---|---|
| Replication Throughput | Incoming data transfer rate received from the source file system. | Average | Bytes/sec |
| Recovery Point Age | Time since the last successful replication snapshot was applied. | Average/Maximum | Seconds |
Outbound Connector
| Metric name | Description | Statistics | Unit |
|---|---|---|---|
| LDAP Request Throughput | Number of LDAP requests processed per second by the outbound connector. | Sum | Count/sec |
| LDAP Request Avg Latency | Average latency of LDAP requests. | Average | ms |
| LDAP Connection Errors | Number of LDAP connection failures. | Sum | Count |
| LDAP Request Errors | Number of failed LDAP requests. | Sum | Count |
| LDAP Trusted Cert Expiry | Time remaining before the LDAP trusted certificate expires. | Average | Days |
Threshold configuration
To configure thresholds for an OCI File Storage monitor:
- Log in to your Site24x7 account and navigate to Admin > Configuration Profiles > Threshold and Availability.
- Click Add Threshold Profile.
- Select the applicable monitor type from the Monitor Type drop-down menu. The applicable monitor types are: File System, Hidden Mount Target, Mount Target, File System Replication, File System Replication Target, or Outbound Connector. The supported metrics are displayed in the Threshold Configuration section. You can set threshold values for all the metrics mentioned above.
- Click Save.
Status propagation
Status propagation helps simplify alert management by consolidating alerts from related OCI File Storage resources. Instead of generating separate alerts for every child monitor, Site24x7 automatically propagates the status of child resources to their parent monitor. This provides a clearer view of the root cause while reducing duplicate notifications.
When status propagation is enabled:
- Alerts for child monitors, including Hidden Mount Targets, File System Replications, File System Replication Targets, and Clone File Systems, are disabled by default.
- Status changes detected in child monitors are propagated to their parent monitor, allowing you to focus on a single alert instead of multiple related alerts.
- If you want child monitors to generate their own alerts, edit the associated threshold profile and set Skip Alert to No.
For example, if a Hidden Mount Target monitor associated with a Mount Target monitor experiences connectivity issues, Site24x7 raises a single alert for the Mount Target monitor instead of generating separate alerts for both the parent and child monitors. This helps reduce alert fatigue and makes it easier to identify and troubleshoot the underlying issue.
Organize OCI File Storage using monitor groups
Monitor groups in Site24x7 help you organize OCI File Storage resources based on applications, business units, environments, or availability domains, making it easier to monitor related resources from a single view. You can group file systems, mount targets, replication monitors, and outbound connectors that belong to the same workload to quickly understand their health and dependencies.
For example, if an application uses multiple file systems with dedicated mount targets and cross region replication, you can add all related monitors to a single monitor group. This enables your team to identify the impact of a file system performance issue or replication failure across the entire application instead of investigating individual resources. Monitor groups also simplify alert management by allowing notifications to be configured at the group level.
Plan storage growth with capacity planning
Capacity planning in Site24x7 helps you analyze historical storage usage trends and forecast future capacity requirements for OCI File Storage resources. By monitoring metrics such as file system usage, read and write throughput, and IOPS over time, you can identify growth patterns and plan storage expansion before capacity limits affect application performance.
For example, if a production file system consistently shows increasing storage usage each month, capacity planning can help estimate when it will reach its quota or available capacity. This enables you to expand storage, optimize data usage, or archive inactive data proactively, reducing the risk of storage exhaustion, application downtime, and unexpected infrastructure costs.
Licensing
Each OCI File Storage component consumes monitor licenses as follows:
- OCI File System: One basic monitor license
- Mount Target: One basic monitor license
- Mount Target (FS): 0.2 basic monitor license
- File System Replication: Free
- File System Replication Target: Free
- Outbound Connector: 0.2 basic monitor license
Viewing OCI File Storage data
To monitor your OCI File Storage environment, log in to your Site24x7 account and navigate to Cloud > OCI > OCI File Storage.
Monitor data
OCI File System
Summary
The Summary tab provides an overview of the file system's health and performance. View the events timeline along with key metrics such as storage usage, read and write throughput, IOPS, latency, and metadata operations to quickly assess overall performance, identify trends, and detect potential issues.
Mount Target (FS)
The Mount Target (FS) tab displays all mount target monitors associated with the selected OCI file system. The tab provides an availability summary showing the total number of mount targets and their current health status, including Up, Down, Critical, Trouble, and Suspended monitors. It also lists each associated mount target along with its storage usage, read throughput, and write throughput, allowing you to monitor mount target performance and quickly identify connectivity or throughput issues affecting access to the file system. From this tab, you can also configure threshold profiles for the associated mount target monitors.
Replication
The Replication tab displays all replication monitors where the selected file system acts as the source. Use this tab to monitor replication throughput, recovery point age, and overall replication health to ensure disaster recovery objectives are met.
Replication Target
The Replication Target tab displays all File System Replication Target monitors where the selected file system is configured as the replication destination. This tab is available only when one or more replication targets are configured for the file system. Use this tab to monitor incoming replication throughput, track recovery point age, and verify that data synchronization is occurring as expected.
Clones
The Clones tab displays all clone file systems created from the selected file system. It provides an availability summary showing the total number of clone file systems and their health status. You can also view key metrics for each clone, including storage usage, read and write request counts, and metadata IOPS to monitor clone activity and performance. This is a read-only view, and threshold configuration is not supported from this tab.
Zia Forecast
The Zia Forecast tab displays the forecast chart with future points of a performance metric (measurement of resource usage) based on historical time series data. Historical data, of up to 30 days, is used to predict what your metric usage will be in the next seven days.
Exports
The Exports tab displays all file system exports associated with the selected OCI file system. View details such as the Export ID, associated File System ID, and Creation Time. This tab helps you verify export configurations, review the availability of exported file systems, and ensure that NFS exports are configured correctly for client access.
Snapshots
The Snapshots tab displays all snapshots available for the selected OCI file system. View details such as the snapshot Display Name, Snapshot ID, and Creation Time. This tab helps you verify snapshot availability, distinguish between manually created, replication-based, and policy-based snapshots; monitor snapshot creation history; and ensure snapshots are being generated as expected for backup and recovery.
Configuration Details
The Configuration Details tab displays the complete configuration of the file system, including its availability domain, life cycle state, metered storage, creation time, clone details, encryption settings, replication configuration, snapshot policies, logging configuration, and resource locks. Use this tab to review the file system's setup and management settings.
Outages
The Outages tab provides details on an outage's Start Time, End Time, Duration, and Comments, if any.
Notes
The Notes tab provides details like Resource ID, Region, Monitor Licensing Category, and much more. The Threshold and Availability Profile and the Notification Profile can be set according to the user and viewed in this tab.
Log Report
The Log Report tab provides a consolidated report of the OCI File System monitor's log status, which can be downloaded as a CSV file.
Alert Logs
The Alert Logs tab displays a chronological list of all triggered alerts related to the File System monitor. This tab helps you trace alert history and severity to assess issues and validate threshold settings.
OCI Mount Target
Summary
The Summary tab provides an overview of the mount target's health and performance. View key metrics including read and write throughput, active NFS client connections, IOPS, NFS health request count, and success or error rates. When Kerberos is enabled, Kerberos authentication error counts are shown. When LDAP is enabled, LDAP request throughput, request latency, connection errors, request errors, and LDAP trusted certificate expiry countdown are shown.
Mount Target (FS)
The Mount Target (FS) tab displays the associated Mount Target (FS) monitors, linked to the selected stand-alone mount target through the same export set. Use this tab to view the relationship between the stand-alone mount target and its corresponding file system mount target monitor. This is a read only view, and threshold configuration is not supported from this tab.
Security
The Security tab displays the security-related configuration and access controls associated with this mount target, including Kerberos and LDAP settings that govern authentication and directory service access.
Exports
The Exports tab lists all NFS exports configured on this mount target's export set, showing export path and file system associations. Use this tab to verify which file systems are exported through this mount target and confirm NFS client access configuration.
Configuration Details
The Configuration Details tab displays the complete configuration of the mount target, including its availability domain, subnet, IP addresses, supported NFS versions, export configuration, Kerberos authentication settings, LDAP configuration, and resource locks. Use this tab to review the mount target's network and security settings.
Outages
The Outages tab provides details on an outage's Start Time, End Time, Duration, and Comments, if any.
Notes
The Notes tab provides details like Resource ID, Region, Monitor Licensing Category, and much more. The Threshold and Availability Profile and the Notification Profile can be set according to the user and viewed in this tab.
Log Report
The Log Report tab provides a consolidated report of the Mount Target monitor's log status, which can be downloaded as a CSV file.
Alert Logs
The Alert Logs tab displays a chronological list of all triggered alerts related to the Mount Target monitor. This tab helps you trace alert history and severity to assess issues and validate threshold settings.
Mount Target (FS)
Summary
The Summary tab provides an overview of the Mount Target (FS) monitor's health and performance. View key metrics such as storage usage, read and write throughput, read and write requests, latency by I/O size, and metadata latency and IOPS to monitor file system activity, analyze workload patterns, and identify performance issues.
Configuration Details
The Configuration Details tab displays the complete configuration of the mount target, including its availability domain, subnet, IP addresses, supported NFS versions, export configuration, Kerberos authentication settings, LDAP configuration, and resource locks. Use this tab to review the mount target's network and security settings.
Outages
The Outages tab provides details on an outage's Start Time, End Time, Duration, and Comments, if any.
Notes
The Notes tab provides details like Resource ID, Region, Monitor Licensing Category, and much more. The Threshold and Availability Profile and the Notification Profile can be set according to the user and viewed in this tab.
Log Report
The Log Report tab provides a consolidated report of the Mount Target (FS) monitor's log status, which can be downloaded as a CSV file.
Alert Logs
The Alert Logs tab displays a chronological list of all triggered alerts related to the Mount Target (FS) monitor. This tab helps you trace alert history and severity to assess issues and validate threshold settings.
File System Replication
Summary
The Summary tab provides an overview of the replication monitor's health and performance. View key metrics such as replication throughput, egress bytes, and recovery point age, along with lag trend charts to monitor replication activity and identify synchronization delays.
Configuration
The Configuration tab displays the replication configuration, including the source and target file systems, replication interval, current delta synchronization status, and resource locks. Use this tab to review the replication setup and verify that the replication relationship is configured correctly.
Outages
The Outages tab provides details on an outage's Start Time, End Time, Duration, and Comments, if any.
Notes
The Notes tab provides details like Resource ID, Region, Monitor Licensing Category, and much more. The Threshold and Availability Profile and the Notification Profile can be set according to the user and viewed in this tab.
Log Report
The Log Report tab provides a consolidated report of the File System Replication monitor's log status, which can be downloaded as a CSV file.
Alert Logs
The Alert Logs tab displays a chronological list of all triggered alerts related to the File System Replication monitor. This tab helps you trace alert history and severity to assess issues and validate threshold settings.
File System Replication Target
Summary
The Summary tab provides an overview of the replication target's health and synchronization status. View key metrics such as incoming replication throughput and recovery point age to monitor data synchronization and identify replication delays that could impact recovery readiness.
Configuration
The Configuration tab displays the replication target configuration, including the associated source replication, target file system, and the current replication state. Use this tab to review the replication relationship and verify the status of the target file system.
Outages
The Outages tab provides details on an outage's Start Time, End Time, Duration, and Comments, if any.
Notes
The Notes tab provides details like Resource ID, Region, Monitor Licensing Category, and much more. The Threshold and Availability Profile and the Notification Profile can be set according to the user and viewed in this tab.
Log Report
The Log Report tab provides a consolidated report of the File System Replication Target monitor's log status, which can be downloaded as a CSV file.
Alert Logs
The Alert Logs tab displays a chronological list of all triggered alerts related to the File System Replication Target monitor. This tab helps you trace alert history and severity to assess issues and validate threshold settings.
Outbound Connector
Summary
The Summary tab provides an overview of the outbound connector's health and LDAP operation performance. View key metrics such as LDAP request throughput, request latency, connection errors, request errors, and certificate expiry countdown to monitor authentication services and quickly identify connectivity or performance issues.
Configuration
The Configuration tab displays the outbound connector configuration, including the connector type, LDAP server endpoints, bind distinguished name, and the associated mount targets. Use this tab to review the connector settings and verify the LDAP configuration used for authentication and directory services.
Outages
The Outages tab provides details on an outage's Start Time, End Time, Duration, and Comments, if any.
Notes
The Notes tab provides details like Resource ID, Region, Monitor Licensing Category, and much more. The Threshold and Availability Profile and the Notification Profile can be set according to the user and viewed in this tab.
Log Report
The Log Report tab provides a consolidated report of the Outbound Connector monitor's log status, which can be downloaded as a CSV file.
Alert Logs
The Alert Logs tab displays a chronological list of all triggered alerts related to the Outbound Connector monitor. This tab helps you trace alert history and severity to assess issues and validate threshold settings.
-
On this page
- Overview
- When to monitor OCI File Storage
- Benefits of Site24x7’s OCI File Storage integration
- Use cases
- Setup and configuration
- Permissions
- Polling frequency
- Supported metrics
- Threshold configuration
- Status propagation
- Organize OCI File Storage using monitor groups
- Plan storage growth with capacity planning
- Licensing
- Viewing OCI File Storage data
- Monitor data