云服务器内容精选

  • 管理接入规则 您可以在“接入LTS”界面对已添加的接入规则进行搜索、查看、编辑和删除。 搜索 单击搜索框,选择搜索维度,如选择“工作负载”,然后继续选择该维度下的可选项。如未选择搜索维度,直接输入搜索关键字,则默认按照接入规则名称搜索。 图1 选择搜索维度 查看 在规则列表中可查看已创建的接入规则的集群名称、命名空间等信息。单击搜索框右上方的,自定义列表项的展示。单击“接入日志组”列的日志组名称,可以跳转到LTS控制台的日志组详情。 编辑 单击“操作”列的“编辑”,可以编辑该接入规则。修改接入规则的影响请参见修改映射。 删除 单击“操作”列的“删除”,可以删除该接入规则。勾选多个规则名称前的复选框,单击“批量删除”,可批量删除接入规则。 删除接入规则或删除映射日志流不可恢复,请您谨慎操作。删除接入规则的影响请参见删除映射。
  • 管理接入规则 您可以在“接入LTS”界面对已添加的接入规则进行搜索、查看、编辑和删除。 搜索 单击搜索框,选择搜索维度,如选择“工作负载”,然后继续选择该维度下的可选项。如未选择搜索维度,直接输入搜索关键字,则默认按照接入规则名称搜索。 图1 选择搜索维度 查看 在规则列表中可查看已创建的接入规则的集群名称、命名空间等信息。单击搜索框右上方的,自定义列表项的展示。单击“接入日志组”列的日志组名称,可以跳转到LTS控制台的日志组详情。 编辑 单击“操作”列的“编辑”,可以编辑该接入规则。修改接入规则的影响请参见修改映射。 删除 单击“操作”列的“删除”,可以删除该接入规则。勾选多个规则名称前的复选框,单击“批量删除”,可批量删除接入规则。 删除接入规则或删除映射日志流不可恢复,请您谨慎操作。删除接入规则的影响请参见删除映射。
  • 响应示例 状态码: 200 请求响应成功, 成功更新接入配置 [ { "project_id" : "", "rule_id" : "", "rule_info" : { "cluster_id" : "", "cluster_name" : "", "container_name" : "", "deployments" : [ "" ], "files" : [ { "file_name" : "", "log_stream_info" : { "target_log_group_id" : "", "target_log_group_name" : "", "target_log_stream_id" : "", "target_log_stream_name" : "" } } ], "namespace" : "" }, "rule_name" : "" } ] 状态码: 400 BadRequest。非法请求。 建议根据error_msg直接修改该请求,不要重试该请求。 { "errorCode" : "LTS.0014", "errorMessage" : "Operation DB failed" } 状态码: 401 AuthFailed。鉴权失败, 请确认token后再次请求 。 { "error_code" : "LTS.0414", "error_msg" : "Invalid token" } 状态码: 403 Forbidden。请求被拒绝访问。返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 { "error_code" : "LTS.0003", "error_msg" : "parse_token_failed" } 状态码: 500 InternalServerError。 表明服务端能被请求访问到,但是服务内部出错。 { "error_code" : "LTS.0102", "error_msg" : "ServiceUnavailable." }
  • 请求示例 修改接入规则 PUT https://{endpoint}/v2/{project_id}/lts/aom-mapping { "rule_id" : "", "rule_name" : "abcde", "project_id" : "2a473356cca5487f8373be891bffc1cf", "rule_info" : { "cluster_id" : "4fae3587-0202-11eb-9ba9-0255ac100b02", "cluster_name" : "testdiskrate", "deployments" : [ "__ALL_DEPLOYMENTS__" ], "namespace" : "default", "container_name" : "container-0", "files" : [ { "file_name" : "__ALL_FILES__", "log_stream_info" : { "target_log_group_id" : "8c9dcda6-d048-43a7-989b-c76c34b0ac85", "target_log_group_name" : "lts-group-wb28", "target_log_stream_id" : "2c228bd1-cbf1-41fb-b563-0ca2769202b2", "target_log_stream_name" : "mysql" } } ] } }
  • 状态码 状态码 描述 200 请求响应成功, 成功更新接入配置 400 BadRequest。非法请求。 建议根据error_msg直接修改该请求,不要重试该请求。 401 AuthFailed。鉴权失败, 请确认token后再次请求 。 403 Forbidden。请求被拒绝访问。返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 500 InternalServerError。 表明服务端能被请求访问到,但是服务内部出错。 503 ServiceUnavailable。 被请求的服务无效,服务不可用。
  • 响应参数 状态码: 200 表7 响应Body参数 参数 参数类型 描述 project_id String 项目id rule_name String 接入规则名称 rule_id String 接入规则id rule_info UpdateAomMappingRuleInfoRespBody object 接入规则详情 表8 UpdateAomMappingRuleInfoRespBody 参数 参数类型 描述 cluster_id String 集群ID。 cluster_name String 集群名称。 deployments Array of strings 工作负载(选全部工作负载使用“ALL_DEPLOYMENTS”)。 说明: 自动映射时需要罗列出每个工作负载。 namespace String 命名空间。 files Array of UpdateAomMappingfilesInfos objects 日志详细(全部日志使用“ALL_FILES”)。 container_name String 容器名称 deployments_prefix String 可选择的自定义日志流前缀 表9 UpdateAomMappingfilesInfos 参数 参数类型 描述 file_name String 路径名称。 匹配规则:^/[A-Za-z0-9.*_/-]+|stdout.log| 最多两个** log_stream_info UpdateAomMappingLogStreamInfos object 日志流信息日志详细。 表10 UpdateAomMappingLogStreamInfos 参数 参数类型 描述 target_log_group_id String 日志组ID。日志组ID不为空时,必须有效。 缺省值:None 最小长度:36 最大长度:36 target_log_group_name String 日志组名称。日志组名称与ID不能同时为空。 最小长度:1 最大长度:64 target_log_stream_id String 日志流ID。日志流ID不为空时,必须有效。 缺省值:None 最小长度:36 最大长度:36 target_log_stream_name String 日志流名称。日志流名称与ID不能同时为空。 最小长度:1 最大长度:64 状态码: 400 表11 响应Body参数 参数 参数类型 描述 code String 错误码。 枚举值: LTS.0742 LTS.0743 LTS.0014 LTS.0740 LTS.0744 LTS.0746 details String 调用失败响应信息描述。 枚举值: AOM mapping rule log group id does not exist Operation DB failed AOM mapping rule name already exists AOM mapping rule param validate error AOM mapping rule log stream id does not exist AOM mapping rule log stream name already exist in another log group 状态码: 401 表12 响应Body参数 参数 参数类型 描述 massage Massage401 object 接口调用信息。 表13 Massage401 参数 参数类型 描述 code String 错误码。 枚举值: LTS.0001 details String 调用失败响应信息描述。 枚举值: project verify error 状态码: 403 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码。 枚举值: LTS.0403 error_msg String 调用失败响应信息描述。 枚举值: Invalid projectId 状态码: 500 表15 响应Body参数 参数 参数类型 描述 error_code String 错误码。 枚举值: LTS.0403 error_msg String 调用失败响应信息描述。 枚举值: Invalid projectId
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token,获取方式请参见:获取用户Token 缺省值:None 最小长度:1000 最大长度:2000 Content-Type 是 String 该字段填为:application/json;charset=UTF-8。 缺省值:None 最小长度:30 最大长度:30 表3 请求Body参数 参数 是否必选 参数类型 描述 rule_id 是 String 接入规则id 缺省值:None 最小长度:36 最大长度:36 project_id 是 String 项目id 缺省值:None 最小长度:32 最大长度:32 rule_name 是 String 接入规则名称 缺省值:None 最小长度:1 最大长度:100 rule_info 是 UpdateAomMappingRuleInfo object 接入规则详情 表4 UpdateAomMappingRuleInfo 参数 是否必选 参数类型 描述 cluster_id 是 String 集群ID。 cluster_name 是 String 集群名称。 deployments 是 Array of strings 工作负载(选全部工作负载使用“ALL_DEPLOYMENTS”)。 说明: 自动映射时需要罗列出每个工作负载。 namespace 是 String 命名空间。 files 是 Array of AomMappingfilesInfo objects 日志详细(全部日志使用“ALL_FILES”)。 container_name 否 String 容器名称 deployments_prefix 否 String 可选择的自定义日志流前缀 表5 AomMappingfilesInfo 参数 是否必选 参数类型 描述 file_name 是 String 路径名,匹配规则:^/[A-Za-z0-9.*_/-]+|stdout.log|最多两个** log_stream_info 是 UpdateAomMappingLogStreamInfo object 日志流信息日志详细。 表6 UpdateAomMappingLogStreamInfo 参数 是否必选 参数类型 描述 target_log_group_id 是 String 日志组ID。日志组ID不为空时,必须有效。 缺省值:None 最小长度:36 最大长度:36 target_log_group_name 是 String 日志组名称。日志组名称与ID不能同时为空。 最小长度:1 最大长度:64 target_log_stream_id 是 String 日志流ID。日志流ID不为空时,必须有效。 缺省值:None 最小长度:36 最大长度:36 target_log_stream_name 是 String 日志流名称。日志流名称与ID不能同时为空。 最小长度:1 最大长度:64
  • 什么是映射 AOM中的日志实际上是以一个日志流的形式在LTS中存在(如图1中的AOM日志流所示),AOM可以查询已配置采集路径的原始日志,但当前AOM的日志流无法在LTS控制台查看。您可以通过在AOM控制台添加接入规则来创建映射,映射创建后,即可通过LTS查看和分析AOM日志。 图1 未创建映射 创建日志流A并创建接入规则后,即已创建AOM至LTS的映射,最新的AOM日志将上报至日志流A,AOM可以查看映射前后所有的日志数据,日志流A不会复制或移动原AOM日志流中的历史数据,如图2所示。 图2 已创建映射
  • 响应参数 状态码为 200 时: 表4 响应Body参数列表 参数 参数类型 描述 [数组元素] Array of AomMappingRuleResp objects - 表5 [数组元素] 参数 参数类型 描述 project_id string 项目id rule_name string 接入规则名称 rule_id string 接入规则id rule_info rule_info object 接入规则详情 表6 [数组元素].rule_info 参数 参数类型 描述 cluster_id string 集群id cluster_name string 集群名称 deployments Array of strings 工作负载 namespace string 命名空间 container_name string 容器名称 files Array of AomMappingfilesInfo objects 接入规则详情 deployments_prefix string 可选择的自定义日志流前缀 表7 [数组元素].rule_info.files 参数 参数类型 描述 file_name string 路径名 log_stream_info log_stream_info object 接入规则详情 表8 [数组元素].rule_info.files.log_stream_info 参数 参数类型 描述 target_log_group_id string 日志组id target_log_group_name string 目标日志组名称 target_log_stream_id string 日志流id target_log_stream_name string 目标日志流名称 状态码为 400 时: 表9 响应Body参数 参数 参数类型 描述 code String 错误码。 枚举值: LTS.0014 details String 调用失败响应信息描述。 枚举值: Operation DB failed 状态码为 401 时: 表10 响应Body参数 参数 参数类型 描述 code String 错误码。 枚举值: LTS.0001 details String 调用失败响应信息描述。 枚举值: project verify error 状态码为 403 时: 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 枚举值: LTS.0403 error_msg String 调用失败响应信息描述。 枚举值: Invalid projectId 状态码为 500 时: 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 枚举值: LTS.0403 error_msg String 调用失败响应信息描述。
  • 响应示例 状态码为 200 时: [{ "project_id": "", "rule_id": "", "rule_info": { "cluster_id": "", "cluster_name": "", "container_name": "", "deployments": [ "" ], "files": [ { "file_name": "", "log_stream_info": { "target_log_group_id": "", "target_log_group_name": "", "target_log_stream_id": "", "target_log_stream_name": "" } } ], "namespace": "" }, "rule_name": "" }, { "project_id": "", "rule_id": "", "rule_info": { "cluster_id": "", "cluster_name": "", "container_name": "", "deployments": [ "" ], "files": [ { "file_name": "", "log_stream_info": { "target_log_group_id": "", "target_log_group_name": "", "target_log_stream_id": "", "target_log_stream_name": "" } } ], "namespace": "" }, "rule_name": "" }] 状态码为 400 时: BadRequest。非法请求。 建议根据error_msg直接修改该请求,不要重试该请求。 { "errorCode": "LTS.0014", "errorMessage": "Operation DB failed"} 状态码为 401 时: AuthFailed。鉴权失败, 请确认token后再次请求 。 { "error_code" : "LTS.0414", "error_msg" : "Invalid token" } 状态码为 403 时: Forbidden。 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 {"error_code": "LTS.0003","error_msg": "parse_token_failed"} 状态码为 500 时: InternalServerError。 表明服务端能被请求访问到,但是服务内部出错。 { "error_code" : "LTS.0102", "error_msg" : "ServiceUnavailable." }
  • 状态码 状态码 描述 200 请求响应成功, 成功获取所有接入配置。 400 BadRequest。非法请求。 建议根据error_msg直接修改该请求,不要重试该请求。 401 AuthFailed。鉴权失败, 请确认token后再次请求 。 403 Forbidden。 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 500 InternalServerError。 表明服务端能被请求访问到,但是服务内部出错。 503 ServiceUnavailable。 被请求的服务无效, 服务不可用。
  • URI GET /v2/{project_id}/lts/aom-mapping 表1 路径参数 名称 是否必选 参数类型 说明 project_id 是 String 项目ID,获取方式请参见:获取帐号ID、项目ID、日志组ID、日志流ID。 缺省值:None 最小长度:32 最大长度:32 表2 Query参数 名称 是否必选 参数类型 说明 log_group_name 否 String 日志组名称 最小长度:1 最大长度:64 log_stream_name 否 String 日志流名称 最小长度:1 最大长度:64