tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
文档

创建日志主题

最后更新时间：2020-02-26 16:29:25

    功能描述

    本接口用于创建日志主题，返回新创建的日志主题的 ID。

    请求

    请求示例

    POST /topic HTTP/1.1
Host: <Region>.cls.tencentyun.com
Authorization: <AuthorizationString>
Content-Type: application/json

{
  "logset_id": "xxxxxx-xx-xx-xx-xxxxxxxx",
  "topic_name": "testname",
  "partition_count": "1",
  "path": "/data/nginx/log/access.log",
  "wild_path":"/data/nginx/log/**/access.log",
  "log_type": "delimiter_log",
  "extract_rule": {
      "time_key": "date",
      "time_format": "%Y-%m-%d %H:%M:%S",
      "delimiter": "|",
      "log_regex": ".*",
      "beginning_regex": "^",
      "keys": ["date","","content"],
      "filter_keys": [],
      "filter_regex": []
  }
}

    请求行

    POST /topic

    请求头

    除公共头部外，无特殊请求头部。

    请求参数

    字段名 类型 位置 是否必须 含义
    logset_id string body 是 日志主题归属的日志集的 ID
    topic_name string body 是 日志主题的名字
    partition_count int body 否 主题分区 partition个数，不传参默认创建1个，最大创建允许10个，分裂/合并操作会改变分区数量，整体上限50个
    path string body 否 旧版日志主题需要采集的日志路径，不采集无需设置
    wild_path string body 否 新版通配符日志采集路径，以/**/分隔文件目录和文件名，和旧版path只会存在一个
    log_type string body 否 采集的日志类型，json_log代表 json 格式日志，delimiter_log代表分隔符格式日志，minimalist_log代表单行全文格式，multiline_log代表多行日志，fullregex_log代表完整正则，默认为minimalist_log
    extract_rule JsonObject body 否 提取规则，如果设置了 extract_rule，则必须设置 log_type

    extract_rule 格式如下：

    字段名 类型 是否必须 含义
    time_key string 否 时间字段的 key 名字，time_key 和 time_format 必须成对出现
    time_format string 否 时间字段的格式，参考 C 语言的strftime函数对于时间的格式说明
    delimiter string 否 分隔符类型日志的分隔符，只有log_type为delimiter_log时有效
    log_regex string 否 整条日志匹配规则，只有log_type为fullregex_log时有效
    beginning_regex string 否 行首匹配规则，只有log_type为multiline_log时有效
    keys JsonArray（string） 否 提取的每个字段的 key 名字，为空的 key 代表丢弃这个字段，只有log_type为delimiter_log时有效，json_log的日志使用 json 本身的 key
    filter_keys JsonArray（string） 否 需要过滤日志的 key，最多5个
    filter_regex JsonArray（string） 否 上述字段 filter_keys 对应的值，个数与 filter_keys 相同，一一对应，采集匹配的日志

    响应

    响应示例

    HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 123

{"topic_id": "xxxx-xx-xx-xx-xxxxxxxx"}

    响应头

    除公共响应头部外，无特殊响应头部。

    响应参数

    字段名 类型 是否必须 含义
    topic_id string 是 日志主题的 ID

    错误码

    参见 错误码。

    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款