修改日志接入
功能介绍
修改日志接入
URI
PUT /v3/{project_id}/lts/access-config
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见:获取账号租户ID、项目资源集ID、日志组ID、日志流ID。 最小长度:32 最大长度:32 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token,获取方式请参见:获取用户Token 最小长度:1000 最大长度:2000 |
Content-Type |
是 |
String |
该字段填为:application/json;charset=UTF-8。 最小长度:30 最大长度:30 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
access_config_id |
是 |
String |
日志接入ID 最小长度:36 最大长度:36 |
access_config_detail |
否 |
AccessConfigDeatilUpdate object |
日志接入详细信息 |
host_group_info |
否 |
AccessConfigHostGroupIdList object |
日志接入主机组ID列表 |
access_config_tag |
否 |
Array of accessConfigTag objects |
标签信息。 |
log_split |
否 |
Boolean |
日志拆分 |
binary_collect |
否 |
Boolean |
二进制采集 |
cluster_id |
否 |
String |
CCE集群ID,CCE类型时,为必填 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
paths |
否 |
Array of strings |
日志采集路径列表 最小长度:1 最大长度:128 |
black_paths |
否 |
Array of strings |
日志采集黑名单路径 最小长度:1 最大长度:128 |
format |
否 |
AccessConfigFormatUpdate object |
日志格式。 |
windows_log_info |
否 |
日志接入采集Windows事件日志。当需要取消Windows日志时,只需传入一个空的windows_log_info字段。 |
|
stdout |
否 |
Boolean |
标准输出开关,仅CCE接入类型时使用 |
stderr |
否 |
Boolean |
标准输出开关标准错误开关,仅CCE接入类型时使用 |
pathType |
否 |
String |
CCE接入类型,仅CCE接入类型时使用 |
namespaceRegex |
否 |
String |
K8s Namespace正则匹配,仅CCE接入类型时使用 |
podNameRegex |
否 |
String |
K8s 容器名称正则匹配,仅CCE接入类型时使用 |
containerNameRegex |
否 |
String |
K8s 容器名称正则匹配,仅CCE接入类型时使用 |
includeLabels |
否 |
Map<String,String> |
容器 Label白名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
excludeLabels |
否 |
Map<String,String> |
容器 Label黑名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
includeEnvs |
否 |
Map<String,String> |
环境变量白名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
excludeEnvs |
否 |
Map<String,String> |
环境变量黑名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
logLabels |
否 |
Map<String,String> |
环境变量日志标签,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
logEnvs |
否 |
Map<String,String> |
环境变量日志标签,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
includeK8sLabels |
否 |
Map<String,String> |
K8s Label白名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
excludeK8sLabels |
否 |
Map<String,String> |
K8s Label黑名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
logK8s |
否 |
Map<String,String> |
K8s Label日志标签,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
single |
否 |
AccessConfigFormatSingle object |
日志接入格式单行日志 |
multi |
否 |
AccessConfigFormatMutil object |
日志接入格式多行日志 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
mode |
是 |
String |
单行日志。system:系统时间,wildcard:时间通配符。 |
value |
是 |
String |
日志时间。 当mode为”system”,则填入当前时间戳。 当mode为"wildcard",则时间通配符:用日志打印时间来标识一条日志数据,通过时间通配符来匹配日志,每条日志的行首显示日志的打印时间;如果日志中的时间格式为:2019-01-01 23:59:59,时间通配符应该填写为:YYYY-MM-DD hh:mm:ss;如果日志中的时间格式为:19-1-1 23:59:59,时间通配符应该填写为:YY-M-D hh:mm:ss 最小长度:1 最大长度:64 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
mode |
是 |
String |
单行日志。time:日志时间,regular:正则模式。 |
value |
是 |
String |
日志时间。当mode为"regular",则输入正则表达式当mode为"time",则时间通配符:用日志打印时间来标识一条日志数据,通过时间通配符来匹配日志,每条日志的行首显示日志的打印时间;如果日志中的时间格式为:2019-01-01 23:59:59,时间通配符应该填写为:YYYY-MM-DD hh:mm:ss;如果日志中的时间格式为:19-1-1 23:59:59,时间通配符应该填写为:YY-M-D hh:mm:ss 最小长度:1 最大长度:64 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
categorys |
否 |
Array of strings |
采集Windows事件日志类型。Application:应用系统,System:系统,Security:安全,Setup:启动 |
time_offset |
否 |
AccessConfigTimeOffset object |
日志接入偏移时间 |
event_level |
否 |
Array of strings |
事件等级。
|
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
access_config_id |
String |
日志接入ID |
access_config_name |
String |
日志接入名称 |
access_config_type |
String |
日志接入类型。AGENT:主机接入 |
create_time |
Long |
创建时间 |
access_config_detail |
AccessConfigDeatilResponse object |
日志接入详细信息 |
log_info |
AccessConfigQueryLogInfo object |
日志接入日志详情 |
host_group_info |
AccessConfigHostGroupIdList object |
日志接入主机组ID列表 |
access_config_tag |
Array of accessConfigTagResponse objects |
标签信息。 |
log_split |
Boolean |
日志拆分 |
binary_collect |
Boolean |
二进制收集 |
cluster_id |
String |
CCE集群ID |
参数 |
参数类型 |
描述 |
---|---|---|
paths |
Array of strings |
采集路径。 |
black_paths |
Array of strings |
采集路径黑名单。 |
format |
AccessConfigFormatCreate object |
日志格式。 |
windows_log_info |
日志接入采集Windows事件日志 |
|
stdout |
Boolean |
标准输出开关,仅CCE接入类型时使用 |
stderr |
Boolean |
标准输出开关标准错误开关,仅CCE接入类型时使用 |
pathType |
String |
CCE接入类型,仅CCE接入类型时使用 |
namespaceRegex |
String |
K8s Namespace正则匹配,仅CCE接入类型时使用 |
podNameRegex |
String |
K8s Pod正则匹配,仅CCE接入类型时使用 |
containerNameRegex |
String |
K8s 容器名称正则匹配,仅CCE接入类型时使用 |
includeLabels |
Map<String,String> |
容器 Label白名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
excludeLabels |
Map<String,String> |
容器 Label黑名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
includeEnvs |
Map<String,String> |
环境变量白名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
excludeEnvs |
Map<String,String> |
环境变量黑名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
logLabels |
Map<String,String> |
容器 Label日志标签,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
logEnvs |
Map<String,String> |
环境变量日志标签,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
includeK8sLabels |
Map<String,String> |
K8s Label白名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
excludeK8sLabels |
Map<String,String> |
K8s Label黑名单,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
logK8s |
Map<String,String> |
K8s Label日志标签,最多支持创建30个,keyname不支持重名,仅CCE接入类型时使用 |
参数 |
参数类型 |
描述 |
---|---|---|
mode |
String |
单行日志。system:系统时间,wildcard:时间通配符。 |
value |
String |
日志时间。当mode为”system”,则填入当前时间戳。当mode为"wildcard",则时间通配符:用日志打印时间来标识一条日志数据,通过时间通配符来匹配日志,每条日志的行首显示日志的打印时间;如果日志中的时间格式为:2019-01-01 23:59:59,时间通配符应该填写为:YYYY-MM-DD hh:mm:ss;如果日志中的时间格式为:19-1-1 23:59:59,时间通配符应该填写为:YY-M-D hh:mm:ss |
参数 |
参数类型 |
描述 |
---|---|---|
mode |
String |
单行日志。time:日志时间,regular:正则模式。 |
value |
String |
日志时间。当mode为"regular",则输入正则表达式当mode为"time",则时间通配符:用日志打印时间来标识一条日志数据,通过时间通配符来匹配日志,每条日志的行首显示日志的打印时间;如果日志中的时间格式为:2019-01-01 23:59:59,时间通配符应该填写为:YYYY-MM-DD hh:mm:ss;如果日志中的时间格式为:19-1-1 23:59:59,时间通配符应该填写为:YY-M-D hh:mm:ss |
参数 |
参数类型 |
描述 |
---|---|---|
categorys |
Array of strings |
采集Windows事件日志类型。
|
time_offset |
AccessConfigTimeOffset object |
首次采集时间偏移量 |
event_level |
Array of strings |
事件等级。
|
参数 |
参数类型 |
描述 |
---|---|---|
offset |
Long |
偏移时间。 当"unit"选择"day"时,范围为1~7天。 当"unit"选择"hour"时,范围为1~168小时。 当"unit"选择"sec"时,范围为1~604800秒。 |
unit |
String |
偏移时间单位。
|
参数 |
参数类型 |
描述 |
---|---|---|
log_group_id |
String |
日志组ID |
log_stream_id |
String |
日志流ID |
log_group_name |
String |
日志组名称 |
log_stream_name |
String |
日志流名称 |
log_group_name_alias |
String |
日志组别名 |
log_stream_name_alias |
String |
日志流别名 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
修改日志接入(ECS)
PUT https://{endpoint}/v3/{project_id}/lts/access-config { "access_config_id" : "ed90802a-8475-4702-955e-e3ee16a5dde9", "access_config_detail" : { "paths" : [ "/test/222", "/test/111" ], "black_paths" : [ ], "format" : { "multi" : { "mode" : "regular", "value" : "aaaa" } }, "windows_log_info" : { "categorys" : [ "Application", "System" ], "time_offset" : { "offset" : 7, "unit" : "day" }, "event_level" : [ "information", "warning", "error", "critical", "verbose" ] } }, "host_group_info" : { "host_group_id_list" : [ "de4dbed4-a3bc-4877-a7ee-096a2a63e036" ] }, "access_config_tag" : [ { "key" : "xxx", "value" : "xxx" }, { "key" : "xxx1", "value" : "xxx1" } ] }
响应示例
状态码:200
修改日志接入请求响应成功
{ "access_config_detail": { "black_paths": [ "/wjy/hei/tesxxx", "/wjy/hei/tesxxx" ], "format": { "single": { "mode": "wildcard", "value": "1111" } }, "paths": [ "/wjy/tesxxx" ], "windows_log_info": { "categorys": [ "System", "Application", "Security", "Setup" ], "event_level": [ "information", "warning", "error", "critical", "verbose" ], "time_offset": { "offset": 168, "unit": "hour" } } }, "access_config_id": "aa58d29e-21a9-4761-ba16-8cxxxxd", "access_config_name": "采集Wjy_xxxxt2", "access_config_tag": [ { "key": "xxx", "value": "xxx" }, { "key": "xxx1", "value": "xxx1" } ], "access_config_type": "AGENT", "create_time": 163504332654, "host_group_info": { "host_group_id_list": [ "de4dbed4-a3bc-4877-a7ee-09xxxxxx" ] }, "log_info": { "log_group_id": "9a7e2183-2d6d-4732-9axxxxx49e0", "log_group_name": "lts-groupxxxa", “log_group_name_alias”: "lts-groupxxxa", "log_stream_id": "c4de0538-53e6-41fd-b951-xxxx8d7", "log_stream_name": "lts-topixxx", “log_stream_name_alias”: "lts-topixxx" } }
状态码:400
非法请求 建议根据error_msg直接修改该请求。
{ "error_code" : "LTS.1807", "error_msg" : "Invalid access config id" }
状态码:500
表明服务端能被请求访问到,但是服务内部出错。
{ "error_code" : "LTS.0010", "error_msg" : "The system encountered an internal error" }
状态码
状态码 |
描述 |
---|---|
200 |
修改日志接入请求响应成功 |
400 |
非法请求 建议根据error_msg直接修改该请求。 |
500 |
表明服务端能被请求访问到,但是服务内部出错。 |
错误码
请参见错误码。