File Storage with Lustre Metrics
Metrics for the File Storage with Lustre service help you measure the performance, capacity, and health of a file system. You can use metrics data to diagnose and troubleshoot issues.
To view a default set of metrics charts in the Console, navigate to the file system that you're interested in, and then select Metrics. You also can use the Monitoring service to create custom queries.
You can enable logging for File Storage with Lustre resources. For more information, see Logging Overview.
Prerequisites
-
IAM policies: To monitor resources, you must be given the required type of access in a policy (IAM) written by an administrator. Policies are required for using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services and the resources being monitored. When you try to perform an action, you might get a message that you don't have permission or are unauthorized. Confirm with your administrator the type of access you've been granted and which compartment you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.
- The metrics listed on this page are automatically available for any resources you create. You don't need to enable monitoring on the resource to get these metrics.
Available Metrics
Metrics emitted by the File Storage with Lustre service are available in the oci_lustrefilesystem metric namespace and include the following dimensions:
-
resourceName: The name of the resource for which the metrics apply -
resourceId: The OCID of the resource for which the metric applies
The metrics listed in the following table are automatically available for any file system you create. You don't need to enable monitoring on the resource to get these metrics.
| Metric | Metric Display Name | Unit | Description | Dimensions |
|---|---|---|---|---|
FileSystemCapacity | Capacity | bytes | The capacity of the file system. | |
FileSystemInodeCapacity | Inode capacity | count | The inode capacity of the file system. | |
ReadThroughput | Bytes read | bytes | Bytes read from the file system per interval. | |
WriteThroughput | Bytes written | bytes | Bytes written to the file system per interval. | |
DataReadOperations | Read operations | operations | Read operations for the file system per interval. | |
DataWriteOperations | Write operations | operations | Write operations for the file system per interval. | |
MetadataOperations | Metadata operations | operations | Metadata operations for the file system per interval. | |
| FilesScannedForSync | Files Scanned For Sync | count | Number of Lustre files identified for export to the Object Storage bucket. | resourceIdresourceNamelinkID |
| FilesSynced | Files Synced | count | Number of Lustre flies successfully exported to Object Storage so far. | resourceIdresourceNamelinkID |
| FileDataScannedForSync | File Data Scanned For Sync | GB | Amount of data in Lustre files identified for export to Object Storage. | resourceIdresourceNamelinkID |
| FileDataSynced | File Data Synced | GB | Amount of data successfully exported from Lustre to Object Storage. | resourceIdresourceNamelinkID |
| FilesSkipped | Files Skipped With Error | count | Number of files on Lustre that weren't exported to Object Storage because of sync errors. | resourceIdresourceNamelinkID |
| ObjectsScannedForSync | Objects Scanned For Sync | count | Number of objects in Object Storage identified for import to the Lustre file system | resourceIdresourceNamelinkID |
| ObjectsSynced | Objects Synced | count | number of objects successfully imported from Object Storage to Lustre so far. | resourceIdresourceNamelinkID |
| ObjectDataScannedForSync | Object Data Scanned For Sync | GB | Amount of data from objects in Object Storage identified for import to Lustre | resourceIdresourceNamelinkID |
| ObjectDataSynced | Object Data Synced | GB | amount of data successfully imported from Object Storage to Lustre. | resourceIdresourceNamelinkID |
| ObjectsSkipped | Objects Skipped With Error | count | number of objects in Object Storage not imported to Lustre because of sync errors. | resourceIdresourceNamelinkID |
View Default Metric Charts
- Open the navigation menu and select Storage. Under Lustre, select File Systems with Lustre.
- Select the file system for which you want to view metrics.
- On the file system details page, select Metrics.
A default set of charts for the current file system is displayed.
For more information about monitoring metrics and using alarms, see Monitoring. For information about notifications for alarms, see Notifications.
Using the API
Use the following APIs for monitoring:
- Monitoring API for metrics and alarms
- Notifications API for notifications (used with alarms)
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.