Set logging

Last Updated: Nov 13, 2017

You can enable or disable logging for a bucket through the console. You can store logs in the same logging-enabled bucket or a new bucket. For more information about the bucket logging format, see Set access logging.

Procedure

  1. Log on to the OSS console.

  2. On the left-side navigation pane, select a bucket from the bucket list to open the bucket overview page.

  3. Click the Basic Settings tab and find the Logs area.

  4. Click Edit, and then edit the logging settings.

    • If you do not want to store logs on OSS, close the Enable Log Storage switch.
    • If you want to store logs on OSS, do as follows:

      1. Open the Enable Log Storage switch.
      2. In the Log Storage Location drop-down box, select the name of a bucket to store the logs.

        Note: Only buckets of the same user and region can be selected.

      3. In the Log Prefix text box, use the default log prefix oss-access/, or click Custom to enter another prefix, that is, <TargetPrefix> in the following logging naming conventions.

  5. Click Save.

Logging naming conventions

The following is the naming conventions for the access log record:<TargetPrefix><SourceBucket>YYYY-MM-DD-HH-MM-SS-<UniqueString>

  • <TargetPrefix>: indicates the log prefix specified by the user.
  • <SourceBucket>: indicates the name of the source bucket.
  • YYYY-MM-DD-HH-MM-SS: indicates the time when the log is created. YYYY indicates the year, MM indicates the month, DD indicates the day, HH indicates the hour, MM indicates the minute, and SS indicates the second.
  • <UniqueString>: indicates the string generated by the OSS.

An example object name used to store OSS access logs is as follows:
MyLog-OSS-example2015-09-10-04-00-00-0000
In the preceding example, MyLog is the log prefix specified by the user, oss-example is the name of the source bucket, 2015-09-10-04-00-00 is the log creation time, and 0000 is the string generated by the OSS.

Thank you! We've received your feedback.