Monitoring file share health states, lifecycle status, and events
By using the console, the CLI, or the API, you can check on the status and health states of the file shares.
Replication sync health
Replication is an asynchronous operation, which is not instantaneous. The system queries the last sync status every 15 minutes. The result shows the data of the last replication that completed, such as start and end date, and the transferred data volume.
You can see information about the last replication operation when you view the details of either the source or the replica share. For more information, see View details of a file share in the UI.
You can see information about the last replication operation when you list the details of either the source or the replica share. For more information, see View details of a file share from the CLI.
You can programmatically retrieve the last sync details by calling the /shares
method in the VPC API. Look for the latest_sync
section in
the API response to see when the replication started (started_at
), when it ended (completed_at
), and how much data was transferred (data_transferred
). For more information, see View a single file share with the API.
When the amount of data to be transferred exceeds the amount of data that can be transferred during the replication window with the normal transfer rate, the replication process can't complete and the replication status becomes degraded
.
If this situation occurs, try adjusting the rate of change on the file share and the replication frequency.
Activity tracking events
You can use IBM Cloud® Activity Tracker Event Routing to configure how to route auditing events. Auditing events are critical data for security operations and a key element for meeting compliance requirements. Such events are triggered when you create, modify, or delete a file share. Activity tracker events are also triggered when you establish and use file share replication. For more information, see Activity tracking events for IBM Cloud VPC.
Logging for file share service
After you provision IBM Cloud Logs Routing to add log management capabilities to your IBM Cloud® architecture, you can enable platform logs to view and analyze logs of the File Storage for VPC service. When replication occurs, the file service
generates a regional-file.00002I
log message, which includes information about when the replication occurred, and how much data was transferred. For more information, see Logging for VPC.