通过CreateConfig接口创建Logtail采集配置。
前提条件
您已完成以下操作：
开通日志服务。
初始化日志服务Python SDK。
参数说明
def create_logtail_config(self, project_name, config_detail):请求参数
参数 | 类型 | 是否必填 | 说明 |
project_name | String | 是 | Project名称：项目（Project）是日志服务的资源管理单元，是进行多用户隔离与访问控制的主要边界。更多信息，请参见管理Project。 |
config_detail | LogtailConfig | 是 | Logtail采集配置的信息。支持 本示例使用 |
SimpleFileConfigDetail参数说明
名称 | 类型 | 是否必填 | 说明 |
logstoreName | String | 是 | Logstore名称：Logstore是日志服务中日志数据的采集、存储和查询单元。更多信息，请参见管理Logstore。 |
configName | String | 是 | Logtail采集配置名称在Project中全局唯一，且创建后不可修改。更多信息，请参见什么是Logtail。 其命名规则如下：
|
logPath | String | 是 | 日志文件绝对路径。 |
filePattern | String | 是 | 日志文件名称。支持使用通配符 |
localStorage | bool | 否 | 是否开启本地缓存。
|
enableRawLog | bool | 否 | 是否上传原始日志。可选值如下：
|
topicFormat | String | 否 | Topic生成方式。可选值如下：
更多信息，请参见日志主题。 |
fileEncoding | String | 否 | 日志文件编码格式，取值为 |
maxDepth | int | 否 | 设置日志最大目录监控深度。取值范围：0~1000，0代表只监控本层目录。 |
preserve | bool | 否 | 如果一个日志文件在指定时间内没有任何更新，则认为该文件已超时。可选值如下：
|
preserveDepth | String | 否 | 当设置preserve为False时，需指定最大超时目录深度，取值范围：1~3。 |
filterKey | List | 否 | 用于过滤日志的字段。只有该字段的值满足filterRegex参数中设置的正则表达式时，对应的日志才会被采集。 |
filterRegex | String | 否 | 与filterKey对应的正则表达式。filterRegex中的元素个数和filterKey中的元素个数必须相同。 |
返回参数
返回参数请参见：CreateConfig - 创建Logtail采集配置。
示例代码
from aliyun.log import LogClient
from aliyun.log.logtail_config_detail import SimpleFileConfigDetail
import os
# 本示例从环境变量中获取AccessKey ID和AccessKey Secret
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')
# 日志服务的服务接入点
endpoint = "cn-hangzhou.log.aliyuncs.com"
client = LogClient(endpoint, access_key_id, access_key_secret)
project = "slsproject-1"
logstore = "logstore-1"
configName = logstore + "-stt1-logtail"
logPath = "/data/logs"
filePattern = "*.log"
# 创建简单文本采集配置
def main():
try:
config_detail = SimpleFileConfigDetail(logstore, configName, logPath, filePattern)
res = client.create_logtail_config(project, config_detail)
res.log_print()
except Exception as error:
print(error)
if __name__ == '__main__':
main()
示例返回结果
CreateLogtailConfigResponse:
headers: {'Server': 'AliyunSLS', 'Content-Length': '0', 'Connection': 'keep-alive', 'Access-Control-Allow-Origin': '*', 'Date': 'Fri, 22 Nov 2024 06:40:40 GMT', 'x-log-time': '1732257640', 'x-log-requestid': '67402768AA8C117B143D****'}
Process finished with exit code 0相关文档
管理Logtail采集配置的接口，请参见：
CreateConfig - 创建Logtail采集配置
GetConfig - 获取Logtail采集配置
DeleteConfig - 删除Logtail配置
UpdateConfig - 更新Logtail采集配置
ListConfig - 查询Logtail配置列表
更多示例代码，请参见Aliyun Log Python SDK on GitHub。