查询日志接入
功能介绍
查询日志接入列表
URI
POST /v3/{project_id}/lts/access-config-list
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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_name_list |
是 |
Array of strings |
接入配置名称列表 最小长度:1 最大长度:64 |
host_group_name_list |
是 |
Array of strings |
主机组名称列表 最小长度:1 最大长度:64 |
log_group_name_list |
是 |
Array of strings |
日志组名称列表 最小长度:1 最大长度:64 |
log_stream_name_list |
是 |
Array of strings |
日志流名称列表 最小长度:1 最大长度:64 |
access_config_tag_list |
否 |
Array of accessConfigTag objects |
接入配置标签,最多添加Key值不能重复的20个标签 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
result |
Array of AccessConfigInfo objects |
日志接入列表 |
total |
Long |
日志接入总数 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
错误描述 |
请求示例
查询日志接入信息,根据传入的Body体进行过滤。
POST https://{endpoint}/v3/{project_id}/lts/access-config-list { "access_config_name_list" : [ "采xx2", "22x", "2x", "采集Wjxxxx" ], "host_group_name_list" : [ "wwxx" ], "log_group_name_list" : [ "lts-grxx", "lts-xx", "lts-gxx" ], "log_stream_name_list" : [ "lts-topixx", "lts-txx" ], "access_config_tag_list" : [ { "key" : "xxx", "value" : "xxx" }, { "key" : "xxx1", "value" : "xxx1" } ] }
响应示例
状态码:200
查询日志接入列表请求响应成功
{ "result" : [ { "access_config_detail" : { "containerNameRegex" : "my", "excludeEnvs" : { "h" : "8" }, "excludeK8sLabels" : { "e" : "5" }, "excludeLabels" : { "b" : "2" }, "format" : { "single" : { "mode" : "system", "value" : "1678969382000" } }, "includeEnvs" : { "g" : "7" }, "includeK8sLabels" : { "d30" : "4" }, "includeLabels" : { "a" : "1" }, "logEnvs" : { "i" : "9" }, "logK8s" : { "f" : "6" }, "logLabels" : { "c" : "3" }, "namespaceRegex" : "default", "pathType" : "container_stdout", "paths" : [ ], "podNameRegex" : "abc", "stderr" : false, "stdout" : true }, "access_config_id" : "c3152f88-8b06-4f7f-bbbe-129512f49f87", "access_config_name" : "myapinew322", "access_config_tag" : [ { "key" : "my01", "value" : "001" }, { "key" : "my02", "value" : "002" } ], "access_config_type" : "K8S_CCE", "binary_collect" : false, "create_time" : 1684467787996, "host_group_info" : { "host_group_id_list" : [ "12b0bbd1-4eda-456b-a641-647aa66bdeab" ] }, "log_info" : { "log_group_id" : "9575cb24-290c-478e-a5db-88d6d1dc513b", "log_group_name" : "my-group", "log_stream_id" : "3581bee9-8698-476e-a0ba-b0f310ed99cf", "log_stream_name" : "lts-topic-api" }, "log_split" : false }, { "access_config_detail" : { "containerNameRegex" : "my", "excludeEnvs" : { "h" : "8" }, "excludeK8sLabels" : { "e" : "5" }, "excludeLabels" : { "b" : "2" }, "format" : { "single" : { "mode" : "system", "value" : "1678969382000" } }, "includeEnvs" : { "g" : "7" }, "includeK8sLabels" : { "d10" : "4", "d" : "4", "d12" : "4", "d11" : "4", "d14" : "4", "d13" : "4", "d16" : "4", "d15" : "4", "d18" : "4", "d17" : "4", "d1" : "4", "d2" : "4", "d3" : "4", "d4" : "4", "d5" : "4", "d6" : "4", "d7" : "4", "d8" : "4", "d9" : "4" }, "includeLabels" : { "a" : "1" }, "logEnvs" : { "i" : "9" }, "logK8s" : { "f" : "6" }, "logLabels" : { "c" : "3" }, "namespaceRegex" : "default", "pathType" : "container_stdout", "paths" : [ ], "podNameRegex" : "abc", "stderr" : false, "stdout" : true }, "access_config_id" : "550cd738-7b16-4724-9c59-aba61bf16528", "access_config_name" : "myapinew32", "access_config_tag" : [ { "key" : "my01", "value" : "001" }, { "key" : "my02", "value" : "002" } ], "access_config_type" : "K8S_CCE", "binary_collect" : false, "create_time" : 1684463134956, "host_group_info" : { "host_group_id_list" : [ "12b0bbd1-4eda-456b-a641-647aa66bdeab" ] }, "log_info" : { "log_group_id" : "9575cb24-290c-478e-a5db-88d6d1dc513b", "log_group_name" : "my-group", "log_group_name_alias" : "my-group", "log_stream_id" : "3581bee9-8698-476e-a0ba-b0f310ed99cf", "log_stream_name" : "lts-topic-api", "log_stream_name_alias" : "lts-topic-api" }, "log_split" : false } ], "total" : 2 }
状态码:400
非法请求 建议根据error_msg直接修改该请求。
{ "error_code" : "LTS.1807", "error_msg" : "Invalid access config name" }
状态码:500
表明服务端能被请求访问到,但是服务内部出错。
{ "error_code" : "LTS.0010", "error_msg" : "The system encountered an internal error" }
状态码
状态码 |
描述 |
---|---|
200 |
查询日志接入列表请求响应成功 |
400 |
非法请求 建议根据error_msg直接修改该请求。 |
500 |
表明服务端能被请求访问到,但是服务内部出错。 |
错误码
请参见错误码。