华为云用户手册

url_parse 解析URL的组成部分。 函数格式 url_parse(url, scheme="", allow_fragments=true) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的URL。 scheme String 否 网络协议，默认为空字符。仅在URL中未指定网络协议时，返回结果中的scheme字段才会使用此处设置的值。 allow_fragments Boolean 否 是否解析URL中的fragment部分。 true（默认值）：解析URL中的fragment部分，返回结果中的fragment字段为具体值。 false：不解析URL中的fragment部分，返回结果中的fragment字段为空字符串。 返回结果 返回解析后的JSON数据，具体参数说明如下表所示。 字段 说明 scheme 网络协议 netloc 网络位置 path 分层路径标识 query 查询组件 fragment 片段标识符 函数示例 示例1：使用默认参数，返回URL的各个组成部分。 测试数据 { "content":"https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib" } 加工规则 e_set("url",url_parse(v("content"))) 加工结果 content:https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib url:{ "scheme": "https", "netloc": "username:username@example.com:8083", "path": "/hello/asdah/", "params"："type=docx", "query": "filename=python3.docx", "fragment": "urllib", } 示例2：设置allow_fragments为false，返回结果中的fragment参数值为空。 测试数据 { "content":"https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib" } 加工规则 e_set("url",url_parse(v("content"),allow_fragments=false)) 加工结果 content:https://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib url:{ "scheme": "https", "netloc": "username:username@example.com:8083", "path": "/hello/asdah/", "params": "type=docx", "query": "filename=python3.docx", "fragment": "", } 示例3：设置scheme为https，allow_fragments为false，返回结果中scheme参数值为https，fragment参数值为空。 测试数据 { "content":"//username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib" } 加工规则 e_set("url",url_parse(v("content"),scheme="https", allow_fragments=false)) 加工结果 content://username:username@example.com:8083/hello/asdah/;type=docx?filename=python3.docx#urllib url:{ "scheme": "https", "netloc": "username:username@example.com:8083", "path": "/hello/asdah/", "params": "type=docx", "query": "filename=python3.docx", "fragment": "", }

函数列表 函数 说明 ua_parse_device 解析User-Agent中的设备信息。 ua_parse_os 解析User-Agent中的操作系统信息。 ua_parse_agent 解析User-Agent中的浏览器信息。 ua_parse_all 解析User-Agent中所有信息。 url_parse 解析URL的组成部分。 url_parse_qs 解析URL中查询字符串包含的参数。 User-Agent解析函数会剔除解析结果为None的字段，例如解析的设备数据为{'brand': None, 'family': 'Other', 'model': None}，则brand字段和model字段将被剔除，最终的解析结果为{'family': 'Other'}。

ua_parse_all 解析User-Agent中的所有信息。 函数格式 ua_parse_all(value) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的User-Agent字符串。 返回结果 返回JSON类型的数据集。 函数示例 测试数据 { "http_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36" } 加工规则 e_set("new_column",ua_parse_all(v("http_user_agent"))) 加工结果 http_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36 new_column: { "user_agent": { "family": "Chrome", "major": "192", "minor": "168", "patch": "0" }, "os": { "family": "Mac OS X", "major": "10", "minor": "9", "patch": "4" }, "device": { "family": "Mac", "brand": "Apple", "model": "Mac" } }

ua_parse_device 解析User-Agent中的设备信息。 函数格式 ua_parse_device(value) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的User-Agent字符串。 返回结果 返回JSON类型的数据集。 函数示例 测试数据 { "http_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36" } 加工规则 e_set("new_column",ua_parse_device(v("http_user_agent"))) 加工结果 http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36 new_column:{"family":"Mac","brand":"Apple","model":"Mac"}

ua_parse_agent 解析User-Agent中的浏览器信息。 函数格式 ua_parse_agent(value) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的User-Agent字符串。 返回结果 返回JSON类型的数据集。 函数示例 测试数据 { "http_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36" } 加工规则 e_set("new_column",ua_parse_agent(v("http_user_agent"))) 加工结果 http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36 new_column:{'family': 'Chrome', 'major': '192', 'minor': '168', 'patch': '0'

ua_parse_os 解析User-Agent中的操作系统信息。 函数格式 ua_parse_os(value) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的User-Agent字符串。 返回结果 返回JSON类型的数据集。 函数示例 测试数据 { "http_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36" } 加工规则 e_set("new_column",ua_parse_os(v("http_user_agent"))) 加工结果 http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36 new_column:{'family': 'Mac OS X', 'major': '10', 'minor': '9', 'patch': '4'}

概述 字段提取检查与覆盖模式，介绍字段提取模式mode参数的不同取值以及说明。请参考DSL加工（邀测）创建加工任务。 表1 参数说明 参数值 说明 fill 当目标字段不存在或者值为空时，设置目标字段。 fill-auto 当新值非空，且目标字段不存在或者值为空时，设置目标字段。 add 当目标字段不存在时，设置目标字段。 add-auto 当新值非空，且目标字段不存在时，设置目标字段。 overwrite 总是设置目标字段。 overwrite-auto 当新值非空，设置目标字段。 父主题： DSL数据加工语法（邀测）

解析方式介绍 云日志 服务支持两种日志结构化解析方式：云端结构化解析和ICAgent结构化解析，且一个日志流只能配置一种结构化方式，例如选择云端结构化解析后，不能再选择ICAgent结构化解析，需要删除后，才能重新选择。更多信息请参考图1。 若用户在日志接入的时候没有配置结构化解析，可以单独给目标日志流配置ICAgent结构化解析或云端结构化解析。 ICAgent结构化解析是在采集侧做结构化，支持插件组合解析，单个日志流的多个采集配置支持不同结构化解析规则，推荐使用ICAgent结构化解析的方式，更多内容请参考ICAgent结构化解析规则说明。 云端结构化解析是通过不同的日志提取方式将日志流中的日志进行结构化，云端结构化解析会消耗LTS服务端算力，未来会按照日志大小收取日志加工流量费用。 图1 不同解析方式

LTS SDK接入错误码 当您使用LTS SDK报错时，请参见表1进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 参数类错误（LTS.00XX） LTS.0001 %@ is null. 参数%@为空。 请设置非空的参数后重试。 LTS.0002 %@ is invalid. 参数%@的类型、格式无效。 请设置有效的参数后重试。 LTS.0003 The length of %@ exceeds the maximum value of %@. 参数%@的长度超过了最大值%@。 请修改参数长度后重试。 LTS.0004 The value of %@ must be between %@ and %@. 参数%@的值必须在%@-%@之间。 请修改参数值后重试。 LTS.0006 %@ doesn't match pattern. 参数%@不匹配正则表达式。 请设置符合正则表达式的参数后重试。 LTS.0007 Invalid configuration parameters. 无效的配置参数。 请设置正确的配置项参数后重试。 LTS.0009 Unsupported region. 上报日志不支持该地区。 请使用下列有效区域：cn-north-4。 集成类错误（LTS.01XX） LTS.0100 The LTSSDK is not initialized. SDK未初始化。 请设置符合规则的配置参数，正确初始化SDK。 LTS.0102 The LTSSDK requires %@ or higher. SDK要求%@及以上操作系统。 请根据提示调整最低操作系统版本。 LTS.0103 Open database failed, code=%@. 打开数据库失败。 请根据sqlite3 error code查询具体情况。 LTS.0104 Create database table failed, code=%@, error=%@. 创建数据表失败。 请根据sqlite3 error code查询具体情况。 LTS.0105 Insert into database failed, code=%@, error=%@. 插入数据失败。 请根据sqlite3 error code查询具体情况。 LTS.0106 Delete from database failed, code=%@, error=%@. 删除数据失败。 请根据sqlite3 error code查询具体情况。 LTS.0107 Select from database failed, code=%@, error=%@. 查询数据失败。 请根据sqlite3 error code查询具体情况。 LTS.0108 Close database failed, code=%@. 关闭数据库失败。 请根据sqlite3 error code查询具体情况。 LTS.0109 Reduce database size failed, code=%@, error=%@. 减小数据库大小失败。 请根据sqlite3 error code查询具体情况。 LTS.0110 Begin transaction failed, code=%@, error=%@. 开启事务失败。 请根据sqlite3 error code查询具体情况。 LTS.0111 Commit transaction failed, code=%@, error=%@. 提交事务失败。 请根据sqlite3 error code查询具体情况。 LTS.0112 The count of database records exceeds the maximum value of %@，will delete %@ records before inserting. 数据库达到最大日志条数限制。 将自动删除适量老日志，再插入新日志。 LTS.0113 Add column(%@) to database failed, code=%d, error=%s. 添加数据库表字段失败。 请根据sqlite3 error code查询具体情况。 LTS.0114 Update column(%@) to database failed, code=%d, error=%s. 更新数据库表字段失败。 请根据sqlite3 error code查询具体情况。 系统类错误（LTS.02XX） LTS.0201 Request signature failed. 网络请求签名失败。 请检查region和设备时间（时区）是否正确。 LTS.0202 Write to file failed. 写入文件失败。 请检查文件写权限。 LTS.0203 No file read and write permissions. 无文件读写权限。 请授权文件/目录读写权限。 网络类错误 （LTS.03XX） LTS.0300 Request failed，response code=%@，error=%@. 请求发送失败。 请参考API参考中的错误码。 父主题： 使用SDK接入LTS

设置多账号日志汇聚任务 使用管理账号或者委托管理员账号登录管理控制台，选择“云日志服务 LTS”进入日志管理页面。 在日志应用下方，单击“多账号日志汇聚中心”。 在多账号日志汇聚配置页面，开启日志接收状态，左侧选择某个成员账号，右侧勾选对应的源日志组/日志流，支持自定义目标日志组/日志流的名称。 若不需要使用日志汇聚配置功能时，可以关闭日志接收状态，则所有汇聚配置都会失效，源日志流停止汇聚到目标日志流上。 支持创建日志流的数量不超过总数量。更多信息请参考基础资源限制。 设置完成后，单击“确定”，该账号汇聚配置创建中，预计5分钟左右创建完成，请稍后刷新查看配置。 目标日志流初始化时默认采用源账号日志流的索引配置和结构化配置，配置成功后，若源账号日志流修改索引/结构化配置则不会同步到目标日志流。 删除源账号的日志组/日志流不会对目标账号的日志组/日志流造成影响。 取消勾选日志组/日志流并成功下发配置后，该日志组/日志流将不再继续汇聚。

参数获取方式 区域表 区 域名 称 RegionName 华北-北京二 cn-north-2 华北-北京四 cn-north-4 华北-北京一 cn-north-1 华东-上海二 cn-east-2 华东-上海一 cn-east-3 华南-广州 cn-south-1 华南-深圳 cn-south-2 西南-贵阳一 cn-southwest-2 亚太-新加坡 ap-southeast-3 日志组ID：登录云日志服务页面，选择“日志管理”，鼠标悬浮在日志组名称上，可查看日志组名称和日志组ID。 日志流ID：单击日志组名称对应的按钮，鼠标悬浮在日志流名称上，可查看日志流名称和日志流ID。

配置参数说明 LogConsumerConfig中配置参数说明： startTimeNs（消费开始时间）和endTimeNs（消费结束时间），这里的时间指的是服务端时间。 API消费保证最终一致性，即您可以获取到这条日志流的全部内容，但由于时间为服务端时间，所以在获取日志流的过程中，可能导致获取到的日志数量跟LTS页面查询的日志数量不一致。 表1 配置参数说明 参数名称 描述 类型 是否需要填写 默认值 regionName 云日志服务的区域 String 必填 - projectId 华为云账号的项目ID（project id） String 必填 - logGroupId LTS的日志组ID String 必填 - logStreamId LTS的日志流ID String 必填 - accessKeyId 华为云账号的AK String 必填 - accessKeySecret 华为云账号的SK String 必填 - startTimeNs 消费开始时间，纳秒值 Long 必填 - endTimeNs 消费结束时间，纳秒值 Long 选填 - batchSize 每批次消费数量，可选范围[10, 1000] Integer 选填 -

查看地图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“ 日志分析 ”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用地图展示查询数据。在通用配置下方，参考表1配置参数。 图1 地图 表1 地图参数说明表 参数 说明 地图类型 区域定位：设置地图显示的区域范围，包含中国省级地图和世界地图两种。 省份 地图类型为中国省级地图，该字段为具体省份。例如浙江省 国家 地图类型为世界地图，该字段为具体国家。例如中国 数值列 选择用于展示数值的字段。 图表名称字号 设置图表名称的字号大小。

查看数字折线图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用数字折线图展示查询数据。在通用配置下方，参考表1配置参数。 图1 数字折线图 表1 数字折线图参数说明 类别 参数 说明 查询分析设置 X轴数据 支持数字或字符串数据。 Y轴数据 支持数字或字符串数据，可以选择多个数据。 图表样式 连接方式 设置线图显示格式，可选择直线或曲线。 主体设置 图表名称字号 设置图表名称的字号大小。 数据格式 将数据按照指定格式进行显示。 数值字号 显示值的字号，取值范围为12px~80px。 数值单位 显示值的单位。 单位字号 显示值单位的字号，取值范围为12px~50px。 小数点位数 设置显示数值小数点位数。 背景配置 背景色 图表的背景颜色，支持深色或浅色。

查看数字图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用数字图展示查询数据。在通用配置下方，参考表1配置参数。 图1 数字图 表1 数字图参数说明 类别 参数 说明 查询分析设置 数值列 支持数字或字符串数据。 同比数据 选择待对比的字段，在图表中显示该字段对应的值。 主体设置 图表名称字号 设置图表名称的字号大小。 格式化 将数据按照指定格式进行显示。 数值字号 显示值的字号，取值范围为12px~80px。 数值单位 显示值的单位 单位字号 显示值单位的字号，取值范围为12px~50px。 小数点位数 设置显示数值小数点位数。 添加对比值 开启后，显示待对比字段对应的值。 对比值格式化 将待对比数据按照指定格式进行显示。 对比值字号 待对比值的字号，取值范围为12px~50px。 对比值单位 待对比值的单位。 对比值单位字号 显示待对比值单位的字号，取值范围为12px~50px。 描述 对显示的数值及对比值趋势的描述，显示在数值下方。 背景配置 背景色 图表的背景颜色，支持深色或浅色。

查看饼图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用饼图展示查询数据。在通用配置下方，参考表1配置参数。 图1 饼图 表1 饼图参数说明 类别 参数 说明 标准配置 格式化 在下拉框选择K,Mil,Bil、1000000或Byte,KB,MB等格式，将Y轴按照指定格式进行显示。 单位 自定义配置Y轴的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 饼图配置 饼图类型 包括饼图、环图和南丁格尔玫瑰图。 饼图 饼图是一种用于展示各部分组成在整体中所占百分比的图形。‌它通过将一个圆形划分为不同的扇区，‌每个扇区的面积（‌或弧长和圆心角）‌大小对应所表示的数据的比例，‌从而直观地展示出各部分与整体之间的关系。‌ 环图 环图本质上是将饼图中心挖空，相比于饼图来说有如下优点： 在原有构成的基础上增加了总数显示，展示了更多的信息。 两个饼图直接进行比较是非常不直观的，两个环图间可以通过环状条长度进行简单的对比。 南丁格尔玫瑰图 南丁格尔玫瑰图本质上并不是环图，而是在极坐标系下画出来的柱状图，每一个分类数据被圆弧平分，使用圆弧的半径长短表示数据的大小，相比于饼图来说有如下优点： 饼图适用于不超过10条的分类数据，南丁格尔玫瑰图则适用于分类较多的场景（10-30条数据）。 由于半径和面积是成平方的关系，南丁格尔玫瑰图放大了各个分类数据之间值的差异，尤其适合对比大小相近的数值。 由于圆形有周期的特性，南丁格尔玫瑰图也适用于表示一个周期的时间概念，比如星期、月份。 是否显示刻度 开启后，显示饼图上的文本标签，可用于说明图形的一些数据信息，比如值，名称等。 刻度文本格式 可配置为分类、百分比、分类：百分比或分类：数值（百分比）。 标签位置 开启是否显示刻度后，可配置此参数，调整标签在图表中的位置。 查询分析设置 数据 分类数据对应的数值。 第一层数据 类目 分类数据。 展示数量 显示分类数据的个数。 排序方式 升序或降序。 其余归为其他 开启后，除了展示的数据，其余归为其他方式展示。 添加分层 单击添加分层，设置第二层数据，每层数据包括类目、展示数量、排序方式、其余归为其他。 图例配置 隐藏图例 开启后，可以隐藏图例和图例内容的显示。 图例内容 选择显示值和百分比，可勾选多个。 图例位置 图例在图表中的位置，选择图表顶部或图表右边。 图形配置 外半径 指定饼图外半径值。取值范围为40~100 。 内半径 指定饼图内半径值。取值范围为0~100。 上边距 坐标轴距离图表上边界距离。 下边距 坐标轴距离图表下边界距离。 左边距 坐标轴距离图表左边界距离。 右边距 坐标轴距离图表右边界距离。

查看表格 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 日志下方默认使用表格展示日志数据查询结果，在通用配置下方，参考表1配置参数。 表1 表格参数说明 类别 参数 说明 标准配置 格式化 将表格数据按照指定格式进行显示。 单位 自定义配置表格数据的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 查询分析设置 隐藏字段 选择目标字段，将该字段在表格中隐藏。 表格配置 每页显示 每页显示的数据条数。 显示总数 显示表格数据的总条目数。 列配置 对齐方式 表格数据的对齐方式，支持左对齐，右对齐以及居中。 开启搜索 开启后，即可对表格列数据进行搜索功能。 开启排序 开启后，即可对表格列数据进行排序功能。 字体大小 表格字体的大小，取值范围为12px~24px 。

统计图表类型 支持使用表格、柱状图、折线图等图表类型展示不同场景数据，详细请参考表1。 表1 图表类型 图表类型 使用场景 表格 表格是最常见的数据展示类型，通过对数据结构化的整理，实现数据的对比与统计。大多数场景均适用。 柱状图 柱状图描述的是分类数据，直观表现每一个分类项的大小对比关系。统计近一天各错误码类型出现的次数等分类统计场景适用。 折线图 折线图需要统计数据具备时序字段，依据时间顺序组织与聚合指标。可直观反映指标随时间的变化趋势。 饼图 饼图描述的是不同分类的占比情况，通过扇区大小来衡量各分类项的占比情况。错误码占比情况分析等占比统计场景适用。 数字图 数字图描述的是单个指标，一般选择具备有业务价值的关键性指标。统计天、周、月PV、UV等单指标场景适用。 数字折线图 折线图和数字图的组合。折线图用于表示数据趋势和变化的，数字图则展示关键性指标。在一些需要同时显示趋势和关键数据点的场合适用。 地图 地图通过图形的位置来表现数据的地理位置，通常来展示数据在不同地理区域上的分布情况。攻击IP地理分布等地理位置统计场景适用。 漏斗图 漏斗图适用于单流向单路径的业务流程，对各环节进行统计并用梯形面积表示某个环节业务量与上一个环节之间的差异。

添加过滤器 登录云日志服务控制台，在左侧导航栏中选择“仪表盘”，选择待操作的仪表盘。 单击仪表盘名称进入详情页。 单击，在“过滤器”页面中，参考添加日志仪表盘过滤器配置过滤器的相关参数。 不支持过滤数值型的字段。 表1 添加过滤器参数 参数 说明 过滤器名称 仅支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。 查询方式 过滤器选中的条件与已有图表查询条件组合方式。支持AND和NOT两种方式，默认为AND。 Key值 配置需要过滤的字段。仅支持输入英文、数字、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾，且不能是纯数字。 别名 Key值的别名，用于区分不同字段。仅支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点开头、下划线开头或以小数点结尾。 静态列表项 设置Key值对应的Value，多次单击“添加静态列表项”可添加多个Value。 单击“添加静态列表项”可添加Value，需配置如下参数： 列表项名称：需要过滤的Key值对应的Value字段名称。仅支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。 别名：Value的别名。 默认选中：开启“默认选中”，可直接对添加的Value进行过滤选中。 操作：单击删除添加的Value。 添加动态列表项 动态列表项为对应查询和分析语句的查询结果，在不同的时间范围，查询结果是动态变化的。 关闭“添加动态列表项”，无法设置查询结果的动态变化。 开启“添加动态列表项”，通过添加动态列表项显示查询结果的动态变化，即为Key值配置动态Value。需配置如下参数： 日志组：选择待查询的日志组。 日志流：选择待查询的日志流。 SQL引擎：支持管道符版本和非管道符版本。管道符版本的SQL查询默认语法为* | select *，非管道符版本的SQL查询默认语法为select * 动态列表来源：支持字段模糊匹配和SQL查询。 字段模糊匹配：选择当前日志流中配置的结构化字段。 SQL查询：输入SQL查询语句。单击“查询”，可预览动态列表项。 设置完成后，单击“确定”即可完成过滤器的添加。

设置采集开关 登录云日志服务控制台。 左侧导航选择“配置中心”，单击“ICAgent采集开关”。 ICAgent采集开关是用来控制ICAgent是否对日志数据进行采集。 “ICAgent采集开关”默认打开，当您不需要采集日志时，通过关闭“ICAgent采集开关”停止日志采集，以减少资源占用。 “ICAgent采集开关”关闭后，ICAgent会停止采集日志，且在 应用运维管理 AOM控制台的“日志采集开关”也会同步关闭。 采集Syslog日志到 AOM 用来控制ICAgent是否采集Syslog日志到AOM1.0。开关关闭后，ICAgent将不会采集Syslog日志到AOM1.0，此功能仅支持5.12.182以上版本的ICAgent。 采集容器标准输出到AOM。选择CCE集群，开启或关闭应用到该集群。开关关闭后，ICAgent将不会采集标准输出日志到AOM，此功能仅支持5.12.133以上版本的ICAgent。建议使用云容器引擎CCE应用日志接入LTS直接采集容器标准输出到LTS，不推荐采集到AOM。 ICAgent诊断开关用来控制是否开启采集诊断功能。开关开启后ICAgent运行日志将上报到日志组/日志流lts-system/lts-icagent-statistics，然后您可以使用采集诊断功能查看ICAgent运行状态，及时发现异常情况，此功能仅支持5.12.196及以上版本的ICAgent。详细请参考采集诊断仪表盘模板。

查看漏斗图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用漏斗图展示查询数据。在通用配置下方，参考表1配置参数。 图1 漏斗图 表1 漏斗图参数说明 参数 说明 系列名称 漏斗图的名称。 数值列 选择数值字段，某个字段对应的数值越大，在越上面。 隐藏图例 开启后，可以隐藏漏斗图上方的字段名显示。

查看折线图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用折线图展示查询数据。在通用配置下方，参考表1配置参数。 图1 折线图 表1 折线图参数说明 类别 参数 说明 标准配置 格式化 在下拉框选择K,Mil,Bil、1000000或Byte,KB,MB等格式，将Y轴按照指定格式进行显示。 单位 自定义配置Y轴的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 查询分析设置 X轴数据 支持数字或字符串数据。 Y轴数据 支持数字或字符串数据，可以选择多个数据。 维度列 请从下拉列表中选择，一般为有序数据类别。 趋势对比 当X轴为时间数据时，且不设置维度列时，可开启该按钮。 开启后，设置比较对象时间，时间小于等于24小时。设置完成后，将当前时间的数据与对象时间数据进行比较。 图例配置 隐藏图例 开启后，可以隐藏图例和对比值的显示。 图例位置 选择图表顶部或图表右边。 对比数值 选择显示最大值、最小值、平均值、求和值等，可勾选多个。 图形配置 连接方式 设置线图显示格式，可选择直线或曲线。 线宽 折线的线宽。 是否显示点 开启该功能后，显示折线的连接点。 上边距 坐标轴距离图表上边界距离。 下边距 坐标轴距离图表下边界距离。 左边距 坐标轴距离图表左边界距离。 右边距 坐标轴距离图表右边界距离。 Tooltip配置 排序方式 提示框配置，当Y轴数据选择多个时，可对其进行排序显示。 X轴 显示X轴 开启后，显示X轴数据。 X轴名称 设置X轴名称。 Y轴 显示Y轴 开启后，显示Y轴数据。 Y轴名称 设置Y轴名称。 Y轴位置 设置Y轴位置，左边或者右边。

查看柱状图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用柱状图展示查询数据。在通用配置下方，参考表1配置参数。 图1 柱状图 表1 柱状图参数说明 类别 参数 说明 标准配置 格式化 将Y轴按照指定格式进行显示。 单位 自定义配置Y轴的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 柱配置 方向 选择基础柱状图或横向柱状图。 柱宽度 设置柱宽度。 是否显示值 开启后，显示各个条形体对应的数值。 值字体大小 设置各个条形体对应的数值字体大小 是否堆叠 开启后，将堆叠显示Y轴数据。 查询分析设置 X轴数据 支持数字或字符串数据。 Y轴数据 支持数字或字符串数据，可以选择多个数据。 图例配置 隐藏图例 开启后，可以隐藏图例和对比值的显示。 图例位置 图例在图表中的位置，选择图表顶部或图表右边。 对比数值 选择显示最大值、最小值、平均值、求和值等，可勾选多个。 图形配置 上边距 坐标轴距离图表上边界距离。 下边距 坐标轴距离图表下边界距离。 左边距 坐标轴距离图表左边界距离。 右边距 坐标轴距离图表右边界距离。 Tooltip配置 不排序、升序、降序 提示框配置，当Y轴数据选择多个时，可对其进行排序显示。 X轴 显示X轴 开启后，显示X轴数据。 X轴名称 设置X轴名称。 Y轴 显示Y轴 开启后，显示Y轴数据。 Y轴名称 设置Y轴名称。 Y轴位置 设置Y轴位置，左边或者右边。

查看告警 登录云日志服务控制台。 左侧导航选择“日志告警”。 默认显示“告警列表”页面，在该页面默认显示30分钟（相对）的所有告警列表及其趋势图。 输入查询条件后进行搜索，页面会展示该条件下的所有告警信息及这些告警的趋势图，具体查询条件如下： 在页面上方搜索框中可根据日志组、日志流、告警级别、规则名称进行搜索。 设置时间范围，默认时间范围为30分钟（相对）。 时间范围有三种方式，分别是相对时间、整点时间和自定义。您可以根据自己的实际需求，选择时间范围。 相对时间：表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31，设置相对时间1小时，表示查询18:20:31~19:20:31的日志数据。 整点时间：表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31，设置整点时间1小时，表示查询18:00:00~19:00:00的日志数据。 自定义：表示查询指定时间范围的日志数据。 设置搜索条件后，单击，查找在已设时间范围内满足搜索条件的告警。 查询的告警默认显示在“活动告警”页签下，将鼠标放在目标告警所在行中的“告警详情”可查看告警详情。单击告警列表中对应的“名称”，界面右侧弹出该告警的详细信息。 告警故障已经解除时，可单击列表中告警所在行后的删除按钮对该告警进行清除，被执行清除操作后的告警将会显示在“历史告警”页签。 针对已设置好的搜索条件，告警列表默认需要手动刷新，如需设置自动刷新可单击告警界面右上角，在弹出的下拉列表中选择“30秒自动刷新”、“1分钟自动刷新”或“5分钟自动刷新”，若在设置自动刷新后需要手动刷新，也可在下拉列表重新选择“手动刷新”。

示例流程 图1 给用户授权LTS权限流程 登录 统一身份认证 服务 IAM 控制台。在IAM控制台创建用户组，并授予云日志服务操作权限“LTS FullAccess”。详细操作请参考创建用户组并授权。 在IAM控制台创建用户，并将其加入步骤1中创建的用户组。详细操作请参考创建用户并加入用户组。 使用新创建的用户登录控制台，切换至授权区域，进入云日志服务控制台可以正常操作并使用LTS。详细操作请参考用户登录并验证权限。

参数获取方法 区域表 表2 区域表 区域名称 RegionName 华北-北京二 cn-north-2 华北-北京四 cn-north-4 华北-北京一 cn-north-1 华东-上海二 cn-east-2 华东-上海一 cn-east-3 华南-广州 cn-south-1 华南-深圳 cn-south-2 西南-贵阳一 cn-southwest-2 亚太-新加坡 ap-southeast-3 日志组ID：在云日志服务控制台，选择“日志管理”，鼠标悬浮在日志组名称上，可查看日志组名称和日志组ID。 日志流ID：单击日志组名称对应的按钮，鼠标悬浮在日志流名称上，可查看日志流名称和日志流ID。

产品功能 在使用 云日志服务LTS 之前，建议您先通过表1了解LTS提供的主要功能。 表1 产品功能 功能 说明 端云全场景日志接入 支持40+云服务、主机/容器、移动端、跨云、多语言SDK、多账号汇聚，满足全场景客户丰富的日志接入需求。 实时采集日志 云日志服务提供实时日志采集功能，采集到的日志数据可以在云日志控制台以简单有序的方式展示、方便快捷的方式进行查询，并且可以长期存储。 采集到日志数据按照结构化和非结构化进行分析。结构化日志是通过规则将日志流中的日志进行处理，提取出来有固定格式或者相似度高的日志内容做结构化的分类。 海量日志存储搜索 对采集的日志数据，可以通过关键字查询、模糊查询等方式简单快速地进行查询。 SQL统计和可视化图表 LTS提供多种开箱即用的日志仪表盘模板，用户接入日志后即可快速分析。 将日志分析的结果使用可视化图表呈现出来，支持表格、折线图、饼图、柱状图、地图等统计图表，或将统计图表汇聚在仪表盘上统一呈现，方便运营分析。 日志监控与日志告警 支持对存储在云日志服务中的日志数据进行关键词统计或SQL统计，通过在一定时间段内日志中关键字出现次数，实时监控服务运行状态；支持自定义告警内容，支持短信/邮件/企业微信/钉钉/HTTP多渠道通知。 日志转储 主机和云服务的日志数据上报至云日志服务后，支持自定义存储时间。超出存储时间的日志数据将会被自动删除，对于需要长期存储的日志数据（日志持久化），云日志服务提供转储功能，可以将日志转储至 对象存储服务 （OBS）中长期保存。日志转储基于复制的转储机制，在LTS设置的存储时间内转储至OBS的日志，不会在LTS被删除。 同时LTS还支持转储DWS/DIS/ DLI /DMS，让用户实现日志数据便捷在云服务间流转，快速构建水平解决方案。 日志消费与加工 LTS提供DSL日志加工的能力，内置200＋函数，可以实现一站式日志规整、富化、脱敏、过滤、分裂等功能；另外结合定时SQL统计，可以对数据实现聚合统计。 支持用户使用SDK消费LTS日志，可以获取全量日志数据，可以作为流计算的数据源（SDK消费功能邀测中，暂未开放）。

初始化Rainbow SDK 代码如下： package com.huawei.demo.serviceb.config; import javax.sql.DataSource; import org.mybatis.spring.SqlSessionFactoryBean; import org.mybatis.spring.mapper.MapperScannerConfigurer; import org.springframework.context.EnvironmentAware; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.DependsOn; import org.springframework.context.annotation.Import; import org.springframework.core.Ordered; import org.springframework.core.annotation.Order; import org.springframework.core.env.Environment; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.jdbc.datasource.DataSourceTransactionManager; import org.springframework.transaction.support.TransactionTemplate; import com.huawei.nuwa.map.client.NuwaMapClient; import com.huawei.nuwa.map.spring.boot.autoconfigure.NuwaCloudMapAutoConfiguration; import com.huawei.rainbow.jdbc.DbGroupDataSource; import com.huawei.wisesecurity.sts.springboot.security.configuration.StsEncryptablePropertiesConfiguration; /** * Rainbow启动 */ @Configuration @Order(Ordered.HIGHEST_PRECEDENCE) @Import(value = {NuwaCloudMapAutoConfiguration.class, StsEncryptablePropertiesConfiguration.class}) public class ApplicationAutoConfig implements EnvironmentAware { private Environment environment; /** * Rainbow需要依赖STS和Cloud Map启动，创建dataSource * * @param client NuwaMapClient值对象 * @return DataSource 初始化完成的数据源数据源 */ @Bean @DependsOn({"stsBootStrap"}) public DataSource createDataSource(NuwaMapClient client) { DbGroupDataSource dataSource = new DbGroupDataSource(); dataSource.setUseSts(true); dataSource.setAppName(environment.getProperty("wiseDba.appName")); dataSource.setDbGroupKey(environment.getProperty("wiseDba.groupKey")); dataSource.setDbName(environment.getProperty("wiseDba.dbName")); dataSource.init(); return dataSource; } /** * 事务管理创建 * * @param dataSource 数据源 * @return DataSourceTransactionManager 事务管理 */ @Bean public DataSourceTransactionManager createTransaction(DataSource dataSource) { DataSourceTransactionManager transaction = new DataSourceTransactionManager(); transaction.setDataSource(dataSource); return transaction; } @Bean public JdbcTemplate createJdbcTemplate(DataSource dataSource) { return new JdbcTemplate(dataSource); } @Bean("sqlSessionFactoryBean") public SqlSessionFactoryBean createMybatisSqlSessionFactoryBean(DataSource dataSource) { SqlSessionFactoryBean sessionFactoryBean = new SqlSessionFactoryBean(); sessionFactoryBean.setDataSource(dataSource); // 数据源配置项 org.apache.ibatis.session.Configuration configuration = new org.apache.ibatis.session.Configuration(); // 允许jdbc自动生成主键 configuration.setUseGeneratedKeys(true); // 使用列标签代替列名 configuration.setUseColumnLabel(true); // 打开下划线命名自动转换为驼峰命名开关 configuration.setMapUnderscoreToCamelCase(true); sessionFactoryBean.setConfiguration(configuration); return sessionFactoryBean; } @Bean public TransactionTemplate createTransactionTemplate(DataSourceTransactionManager dataSourceTransactionManager) { TransactionTemplate template = new TransactionTemplate(); template.setTransactionManager(dataSourceTransactionManager); return template; } @Bean public MapperScannerConfigurer createMapperScannerConfigurer() { MapperScannerConfigurer configurer = new MapperScannerConfigurer(); configurer.setBasePackage("com.huawei.demo"); configurer.setSqlSessionFactoryBeanName("sqlSessionFactoryBean"); return configurer; } @Override public void setEnvironment(Environment environment) { this.environment = environment;

配置Rainbow 修改Rainbow SDK配置，切换SDK数据源，新增Cloud Map配置、STS配置，配置如下： nuwa: sts: serverDomain: 10.33.102.162:8080 configPath: certs/WiseCloudNuwaService/WiseCloudNuwaCloudMapAdminService/WiseCloudNuwaCloudMapAdminService.ini enable: true cloudmap: serverAddr: http://10.33.113.125:8080 namespaceName: cn_dev_default rainbow: db0: datasource: beanName: rainbowDs dataSourceName: xxxx //与运维中心WiseDBA服务SDK配置界面的值保持一致 appName: xxx //业务的服务名 dbGroupKey: xxx //实例名称 dbName: xxxxx //Schema名称 connectionProperties: characterEncoding=utf8;connectTimeout=10000;socketTimeout=10000;autoReconnect=true;useUnicode=true;serverTimezone=Asia/Shanghai useSts: true mybatis: base-package: com.huawei.nuwa.map.demo.consumer.middleware.dao mapper-locations: classpath:mapper/rainbow/*.xml

实践概述 代码开发完成后，每次上线前都需要先在Jenkins上打包成镜像包或Jar包，再将镜像包上传到SWR镜像仓库或者将Jar包上传到OBS对象存储，然后再使用ServiceStage升级组件版本配置。该流程较为繁琐，频繁发版本测试导致开发和运维效率低、用户体验差。 如果您的代码在GitLab上管理，使用ServiceStage进行应用托管并且已经部署了组件，则可以通过使用GitLab对接Jenkins自动构建打包，升级已经部署在ServiceStage上的组件版本配置。 本实践通过输出在Jenkins构建打包完成之后自动升级组件的shell脚本，实现了代码合入后自动构建打包并在ServiceStage上滚动升级组件。 父主题： 使用GitLab对接Jenkins自动构建并滚动升级部署到ServiceStage的组件