本文介绍开启 Python SDK 的示例代码及日志示例内容。

日志格式 #

Python SDK 日志记录功能可以收集对 TOS 的各种操作日志，并将日志以文件形式存储在本地。日志格式如下所示。

<time><python file name><level><threadId><message>

开启 Python SDK 日志记录功能 #

以下代码展示了如何开启 Python SDK 日志记录功能。

# -*- coding: utf-8 -*-
import logging

import os
import tos

# 以下代码展示了 Python SDK 日志开启功能

# 完整的日志文件路径例如 /usr/local/TosClient.log
log_file_path = 'your fog file path'

# 通过 tos.set_logger 设置 TOS Python SDK 的日志级别、日志文件存储地址。
# file_path为完整的日志文件路径
# format_string为定义的日志格式
# level为日志级别，默认为INFO。
# 可在开发测试中将日志级别设置为logging.DEBUG
tos.set_logger(file_path=log_file_path, level=logging.INFO)

# 从环境变量获取 AK 和 SK 信息。
ak = os.getenv('TOS_ACCESS_KEY')
sk = os.getenv('TOS_SECRET_KEY')
endpoint = 'your endpoint'
region = 'your region'
bucket_name = 'your bucket name'
object_key = 'your object key'

# 创建 TosClientV2 对象，对桶和对象的操作都通过 TosClientV2 实现
client = tos.TosClientV2(ak, sk, endpoint, region)

# 创建bucket
client.create_bucket(bucket_name)

# 向bucket 中添加object
client.put_object(bucket_name, object_key, content='测试一下')

日志内容示例 #

使用默认日志格式时，日志内容如下。

2022-11-22 11:04:40,149 tos.utils [INFO] 4628305408 : after-request: create_multipart_upload exec httpCode: 200, requestId: 6109487c3c48944c637c3c48-ac133580-1oxJaS-CrMU-ccs-front-mtaz-c, usedTime: 0.19967167100000083 s
2022-11-22 11:04:40,903 tos.utils [INFO] 123145364279296 : after-request: upload_part exec httpCode: 200, requestId: 6109487c3c48946f637c3c48-ac133580-1oxJaS-UP-ccs-front-mtaz-c, usedTime: 0.7408098059999997 s
2022-11-22 11:05:05,600 tos.utils [INFO] 123145347489792 : after-request: upload_part exec httpCode: 200, requestId: 6109487c3c489456637c3c48-ac133580-1oxJaS-UP-ccs-front-mtaz-c, usedTime: 25.438498578 s
2022-11-22 11:05:05,665 tos.utils [INFO] 4628305408 : after-request: complete_multipart_upload exec httpCode: 200, requestId: 6109487c3c61a7a8637c3c61-ac133580-1oxJar-CoMU-ccs-front-mtaz-c, usedTime: 0.06059913000000705 s
2022-11-22 11:05:05,764 tos.utils [INFO] 4628305408 : after-request: get_object exec httpCode: 200, requestId: 6109487c3c61a7b1637c3c61-ac133580-1oxJar-GO-ccs-front-mtaz-c, usedTime: 0.05564314099999734 s