Bucket Logs
With bucket logs, you can record all activities at the bucket level.
When you configure bucket logging, you define a target bucket that stores the log files.
Later, whenever you add, modify, or delete an object,
VMware Cloud Director Object Storage Extension
records the action in
a log file. To write bucket logs,
VMware Cloud Director Object Storage Extension
uses
a dedicated log delivery account named System Logger. The log delivery account is a
subject to the usual access control restrictions. When you configure bucket logging,
VMware Cloud Director Object Storage Extension
grants Write of Bucket
and
Read of ACL
permissions on the target bucket to the System
Logger account. You can interact with log files the same way you interact with other objects in
VMware Cloud Director Object Storage Extension
. You can preview log files directly in VMware Cloud Director Object Storage Extension
, or
you can download the logs locally.If
VMware Cloud Director Object Storage Extension
uses the ECS
storage platform, bucket logging is impossible.
The ECS
storage platform does not support
bucket logging. If you use
Cloudian HyperStore
, you
can work with bucket logs. Activate Bucket Logging
To activate logging for a bucket, select a target bucket that stores the log files
and optionally share the log files with other users.
To activate bucket logging, verify
that you have the required set of rights.
If you are an ... | You can ... |
---|---|
organization administrator | manage the logging configuration of buckets that users in your
organization own. |
organization user | manage the logging configuration of your own buckets. |
- Log in to theVMware Cloud Director tenant portal.
- In the primary left navigation panel, underMore, selectObject Storage.
- In theBucketspane, click the name of the bucket that you want to edit.
- ClickProperties.
- In theLoggingcard, click the text.
- Enter the logging configuration details and clickSave.
- Select the target bucket in which you want to store the log files.VMware Cloud Director Object Storage ExtensiongrantsWrite of BucketandRead of ACLpermissions on the target bucket to the log delivery account named System Logger.
- Enter a prefix for the log files.
- To save the log files to a folder in the target bucket, select thePrefix as a foldercheck box.
- Share the log files with other users.
- To share the log files with users within your tenant organization, use the toggle buttons in theTenant Usersrow.
- To share the log files with authenticated users within all tenant organizations, use the toggle buttons in theAuthenticated Usersrow.
- To share the log files with all users, use the toggle buttons in thePublicrow.
- To share the log files with specific users within your organization, click theAdd Userbutton, select the users with whom you want to share the log files, and use the toggle buttons in the corresponding row.
Whenever an object is added or
modified in the logging source bucket,
VMware Cloud Director Object Storage Extension
creates and adds a bucket log object
to the logging target bucket. The owner of the log is the System Logger
account.