Staring with VMware Cloud Director 10.3.1, to stay informed when the transfer share is reaching its allocated capacity, you can monitor the use of the transfer share. You can configure notifications to appear before the disk space reaches maximum capacity.

To monitor the transfer folder metrics, you can use the /metrics?filter=name==disk_free_percent;dirname=transfer OpenAPI endpoint . For more information, see the VMware Cloud Director API documentation at www.code.vmware.com.

The monitoring is deactivated by default and you can activate it by using the cell management tool. You can configure notifications to appear when the disk space reaches the orange or red threshold of available capacity. For more information about advisories, see Create an Advisory Dashboard in the VMware Cloud Director Service Provider Admin Portal Guide.

Procedure

  1. Log in directly or by using an SSH client to the OS of any of the cells in the cluster as root.
  2. To enable transfer server storage monitoring, run the following command.
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n monitoring_transfer_folder_enabled -v true
  3. (Optional) To configure the advisories to appear when the available capacity reaches a threshold, run the following command.

    By default, VMware Cloud Director sets the orange threshold to 20% and the red threshold to 10% free space of the transfer share's total capacity.

    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n orange_threshold -v used_capacity_percentage
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n red_threshold -v used_capacity_percentage
  4. (Optional) To change the set of users that the advisories appear to, run the following command.

    The messages can appear to system administrators, the users within an organization, or the users in all organizations. By default, the notifications appear only to the system administrators. The value can be the organization ID or the site ID.

    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n transfer_folder_monitor_target_ID -v urn:vcloud:org:organization_ID
  5. (Optional) To configure when the advisories appear and their duration, run the following commands.
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n transfer_folder_monitor_start_date -v now() +number_of_days_to_delay
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n transfer_folder_monitor_end_date -v now() +number_of_days_to_delay

    By default, the notifications appear at the time of the event where the value is now() and disappear one day later where the value is now()+1.

What to do next

To deactivate the monitoring, run the following command.
/opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n monitoring_transfer_folder_enabled -v false