金山云-文档中心-日志转存（logging）

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

常用工具

工具汇总

KS3Util命令行工具

桶操作

日志转存（logging）

最近更新时间：2025-06-20 17:30:15



访问对象存储KS3的过程中会产生大量的访问日志，您可以通过日志转存功能将这些日志按照固定命名规则，以小时为单位生成日志文件写入您指定的桶。您可以通过logging命令开启、查询、关闭桶的日志转存配置。

以下示例均以Linux为例。

开启日志转存

如果桶此前未开启过日志转存，则使用该命令将为桶开启日志转存。如果桶此前已开启日志转存，则使用该命令将直接覆盖已有的日志转存配置。

开启或修改日志转存配置的命令格式及示例如下：

命令格式

./ks3util logging --method put ks3://bucketname ks3://destbucket/[prefix]

参数说明

参数	说明
bucketname	生成日志的源桶名称。
destbucket	存储日志文件的目标桶名称。
prefix	日志文件存储的目录。如果指定此项，则日志文件将保存在目标桶的指定目录下。如果不指定此项，则日志文件将保存在目标桶的根目录下。

1. 生成日志的源桶和存储日志的目标桶可以相同也可以不同，但是必须位于同一账号下的相同地域。除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

2. 开启日志转存需具备ks3:PutBucketLogging权限。

使用示例

将源桶samplebucket1产生的日志文件保存至目标桶samplebucket2的根目录下。
```
./ks3util logging --method put ks3://samplebucket1 ks3://samplebucket2
```
以下输出结果表明已为源桶samplebucket1开启日志转存。
```
0.016021(s) elapsed
```
将源桶samplebucket1产生的日志文件保存至目标桶samplebucket2的根目录下的子目录destdir下。
```
./ks3util logging --method put ks3://samplebucket1 ks3://samplebucket2/destdir
```
以下输出结果表明已为源桶samplebucket1开启日志转存。
```
0.016021(s) elapsed
```

查看日志转存配置

命令格式

./ks3util logging --method get ks3://bucketname [local_xml_file]

参数说明

参数	说明
bucketname	待获取日志转存配置的桶名称。
local_xml_file	存放日志转存配置的本地文件名称，例如`localfile.xml`。如果未指定此参数，则日志转存配置将直接输出到屏幕。

1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

2. 查看日志转存配置需具备ks3:GetBucketLogging权限。

使用示例

获取桶samplebucket的日志转存配置，并将配置结果写入本地文件localfile.xml。
```
./ks3util logging --method get ks3://samplebucket localfile.xml
```
以下输出结果表明已成功获取日志转存配置。
```
0.299514(s) elapsed
```

关闭日志转存设置

在您关闭日志转存功能前，KS3的日志文件会一直生成。请结合Lifecycle规则及时清理不再需要的日志文件，以减少您的存储费用。

命令格式

./ks3util logging --method delete ks3://bucketname

参数说明

参数	说明
bucketname	要关闭日志转存功能的桶名称。

1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

2. 关闭日志转存设置需具备ks3:PutBucketLogging权限。

使用示例

关闭桶samplebucket的日志转存功能。
```
./ks3util logging --method delete ks3://samplebucket
```
以下输出结果表明已成功关闭samplebucket的日志转存功能。
```
0.299514(s) elapsed
```

文档导读

上一篇：桶空间策略（bucket-policy）

下一篇：桶跨域资源共享（cors）

纯净模式常规模式

纯净模式

点击可全屏预览文档内容