华为云用户手册

操作步骤 云日志服务接入方式为API网关 APIG时，按照如下操作完成接入配置。 选择日志流 单击“所属日志组”后的目标框，在下拉列表中选择具体的日志组，若没有所需的日志组，单击“所属日志组”目标框后的“新建”，在弹出的创建日志组页面创建新的日志组。 单击“所属日志流”后的目标框，在下拉列表中选择具体的日志流，若没有所需的日志流，单击“所属日志流”目标框后的“新建”，在弹出的创建日志流页面创建新的日志流。 单击“下一步”：APIG配置。 APIG配置 单击“前往APIG配置”。 在APIG控制台，选择API分析下的“日志分析”。 单击“配置访问日志”链接。 在弹出的配置访问日志页面中，选择对应的日志组和日志流。 APIG里具体的操作请参见日志分析。 日志流配置 表1 日志流配置参数表 参数 说明 自动对日志流进行结构化配置和索引配置 开启该按钮，自动对日志流进行结构化配置和索引配置。日志流结构化配置为APIG系统模板；索引配置为所有APIG解析出来的字段打开快速分析按钮。配置结构化和索引后，才能对APIG日志进行SQL分析，并提供可视化图表。 自动为日志流添加标签：log_type=apig_layer_access 开启该按钮，自动为日志流添加标签（log_type=apig_layer_access）后，APIG仪表盘模板才能匹配该日志流。 自动为日志流创建仪表盘 开启该按钮，自动为日志流创建APIG仪表盘。 完成

响应示例 状态码： 200 日志上报成功。 { "errorCode": "SVCSTG.ALS.200.200", "errorMessage": "Report success.", "result": null} 状态码： 401 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 { "errorCode" : "SVCSTG.ALS.403.105", "errorMessage" : "Project id is invalid.", "result": null}

请求示例 POST https://{接入点IP:8102}/v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents/high-accuracy{"contents": [{"log_time_ns": "1586850540000000000","log": "Fri Feb 15 15:48:04 UTC 2019"},{"log_time_ns": "1586850540000000001","log": "Sat Apri 18 16:04:04 UTC 2019"}],"labels": {"user_tag": "string"}}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM获取的用户Token，获取方式请参见：获取用户Token。 缺省值：None 最小长度：1000 最大长度：2000 Content-Type 是 String 该字段填为：application/json;charset=UTF-8。 缺省值：None 最小长度：30 最大长度：30 Content-Encoding 否 String 日志压缩格式 枚举值： gzip snappy 表3 请求Body参数 参数 是否必选 参数类型 描述 contents 是 Array of LogContents 包含上报时间戳的日志内容列表。 labels 是 Object 用户自定义tag。 tenant_project_id 否 String 租户ID。 表4 LogContents 参数 是否必选 参数类型 描述 log_time_ns 是 Long 日志数据采集时间，UTC时间（纳秒）。 说明： 采集时间需在日志存储时间范围之内，否则上报日志会被删除。比如日志组的日志存储时间是7天，则此参数不应早于当前时间的7天前。 log 是 String 日志内容。

URI POST /v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents/high-accuracy 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方式请参见：获取帐号ID、项目ID、日志组ID、日志流ID。 缺省值：None 最小长度：32 最大长度：32 log_group_id 是 String 日志组ID，获取方式请参见：获取帐号ID、项目ID、日志组ID、日志流ID。 缺省值：None 最小长度：36 最大长度：36 log_stream_id 是 String 日志流ID，获取方式请参见：获取帐号ID、项目ID、日志组ID、日志流ID。 缺省值：None 最小长度：36 最大长度：36 注：每个logstream写入速率最大不能超过100MB/S，超过此规格可能会导致日志丢失。

查看日志接入 在云日志服务管理控制台，单击“日志接入”，或在完成主机接入成功后单击“返回接入配置列表”，进入日志接入页面。 在接入配置列表中显示已配置完成的接入配置，单击接入配置名称可进入详情页面，查看该接入配置详细信息。 单击所属日志组或所属日志流，可以进入对应日志组列表或日志流页面查看详细。 修改日志接入：单击需修改接入配置所在行操作列的，参考日志接入的操作步骤进行修改。 删除日志接入：单击需删除接入配置所在行操作列的，或者勾选需删除的接入配置，单击页面左上方“批量删除”，可以对多个配置进行批量删除。

采集配置 在使用主机接入完成日志接入时，在第3步采集配置的具体配置如下： 图1 采集配置 采集配置名称：自定义采集配置名称，长度范围为1到64个字符，只支持输入英文、数字、中文、中划线、下划线以及小数点，且不能以小数点、下划线开头或以小数点结尾。 导入旧版配置：采集配置名称输入框后的“导入旧版配置”可以将旧版主机接入配置导入到新版日志接入中。 路径配置：添加您需要收集的日志路径，LTS将按照配置的路径进行日志采集。 采集路径支持递归路径，**表示递归5层目录。 示例：采集路径配置为 /var/logs/**/a.log，日志匹配如下： /var/logs/1/a.log /var/logs/1/2/a.log/var/logs/1/2/3/a.log/var/logs/1/2/3/4/a.log/var/logs/1/2/3/4/5/a.log 以上示例中的/1/2/3/4/5/，表示/var/logs目录中，往里递归的5个目录层级，在这5个目录层级中只要存在a.log，都能进行日志匹配。 采集路径中只能出现一次**，不能出现两个及以上。正确示例：/var/logs/**/a.log；错误示例：/opt/test/**/log/**。 采集路径中第一个层级不允许为**（避免误采集系统文件），错误示例：/**/test。 采集路径支持模糊匹配，匹配目录或文件名中的任何字符。 如果配置了C:\windows\system32类似的日志采集路径，但无法采集日志，请尝试打开WAF物理防火墙后重新配置。 示例1：采集路径配置为 /var/logs/*/a.log，表示/var/logs/目录下，任何一个目录中存在a.log，都能进行日志匹配，例如： /var/logs/1/a.log /var/logs/2/a.log 示例2：采集路径配置为 /var/logs/service-*/a.log，日志匹配示例： /var/logs/service-1/a.log /var/logs/service-2/a.log 示例3：采集路径配置为 /var/logs/service/a*.log，日志匹配示例： /var/logs/service/a1.log /var/logs/service/a2.log 采集路径如果配置的是目录，示例：/var/logs/，则只采集目录下后缀为“.log”、“.trace”和“.out”的文件。 如果配置的是文件名，则直接采集对应文件，只支持内容是文本格式的文件。可以通过file -i 文件名命令，查询文件格式。 请注意您的敏感信息是否在收集范围内。 当主机选择“Windows主机”时，如需采集系统日志，需要在“采集配置”环节，开启“采集Windows事件日志”。 windows事件日志采集不能重复配置，即相同主机下，即使跨日志组和日志流，也只能配置一次。 LTS暂不支持采集PostgreSQL（数据库）实例的日志，目前只支持采集安装在ECS（主机）实例的日志。 日志采集路径不能重复配置，即相同主机的同一个日志采集路径不能重复配置，否则可能会导致日志采集异常。 相同主机的同一个日志采集路径，如果在AOM进行了配置，则不能在LTS重复配置。 配置采集的文件最后修改时间和当前时间差如果已超过12小时，则不会采集。 设置采集黑名单：LTS支持对日志进行过滤采集，即通过设置黑名单，在采集时过滤指定的目录或文件。指定按目录过滤，可过滤掉该目录下的所有文件。 目录和文件名支持完全匹配，也支持模糊匹配，具体可参考路径配置内容进行设置。 当设置的黑名单与配置的采集路径重复或者有重合时，优先过滤掉黑名单设置的文件。 采集Windows事件日志：当选择Windows主机采集日志时，需要开启“采集Windows事件日志”，并且可以设置“日志类型”、“首次采集时间偏移量”、“事件等级”来过滤采集您所需要的日志内容。 日志格式、日志时间具体说明如下： 表1 日志采集信息 名称 说明 日志格式 单行日志：采集的日志文件中，如果您希望每一行日志在LTS界面中都显示为一条单独的日志数据，则选择单行日志。 多行日志：采集的日志中包含像java异常的日志，如果您希望多行异常的日志显示为一条日志，正常的日志则每一行都显示为一条单独的日志数据，则选择多行日志，方便您查看日志并且定位问题。 日志时间 系统时间：表示系统当前时间，默认为日志采集时间，每条日志的行首显示日志的采集时间。 说明： 日志采集时间：ICAgent采集日志，并且发送到云日志服务的时间。 日志打印时间：系统产生并打印日志的时间。ICAgent采集日志并发送日志到云日志平台的频率为1秒钟。 采集日志时间限制：系统时间的前后24小时内。 时间通配符：用日志打印时间来标识一条日志数据，通过时间通配符来匹配日志，每条日志的行首显示日志的打印时间。 如果日志中的时间格式为：2019-01-01 23:59:59，时间通配符应该填写为：YYYY-MM-DD hh:mm:ss。 如果日志中的时间格式为：19-1-1 23:59:59，时间通配符应该填写为：YY-M-D hh:mm:ss。 说明： 如果日志中不存在年份信息，则云日志会自动补齐年份数据为当前年份数据。 填写示例： YY - year (19) YYYY - year (2019) M - month (1) MM - month (01) D - day (1) DD - day (01) hh - hours (23) mm - minutes (59) ss - seconds (59) hpm - hours (03PM)h:mmpm - hours:minutes (03:04PM)h:mm:sspm - hours:minutes:seconds (03:04:05PM) hh:mm:ss ZZZZ (16:05:06 +0100) hh:mm:ss ZZZ (16:05:06 CET) hh:mm:ss ZZ (16:05:06 +01:00) 分行模式 日志格式选择多行日志时，需要选择分行模式，分行模式选择“日志时间”时，是以时间通配符来划分多行日志；当选择“正则模式”时，则以正则表达式划分多行日志。 正则表达式 此配置是用来标识一条日志数据的正则表达式。日志格式选择“多行日志”格式后且“分行模式”已选择“正则模式”后需要设置。 时间通配和正则表达式均是从每行日志的开头进行严格匹配，如果匹配不上，则会默认使用系统时间上报，这样可能会和文件内容中的时间不一致。如果没有特殊需求，建议使用单行日志-系统时间模式即可。

操作步骤 按照如下操作完成接入配置。 选择日志流 单击“所属日志组”后的目标框，在下拉列表中选择具体的日志组，若没有所需的日志组，单击“所属日志组”目标框后的“新建”，在弹出的创建日志组页面创建新的日志组。 单击“所属日志流”后的目标框，在下拉列表中选择具体的日志流，若没有所需的日志流，单击“所属日志流”目标框后的“新建”，在弹出的创建日志流页面创建新的日志流。 单击“下一步：选择主机组”。 选择主机组 在主机组列表中选择一个或多个需要采集日志的主机组，若没有所需的主机组，单击列表左上方“新建”，在弹出的新建主机组页面创建新的主机组，具体可参考创建主机组（IP地址）。 主机组可以为空，可以在接入配置设置完成后对主机组进行设置。 在“主机管理 > 主机组”页面对主机组和接入配置进行关联。 在接入配置详情中对主机组和接入配置进行关联。 单击“下一步：采集配置”。 采集配置 对主机日志采集设置具体的采集规则，具体可参考采集配置。 设置完成后单击“提交”。 完成 接入成功，可以单击“返回接入配置列表”查看日志接入，也可单击“查看日志流”查看该日志流下的采集日志。

采集配置 在使用CCE接入完成日志接入时，在第4步采集配置的具体配置如下： 基本信息：自定义采集配置名称，长度范围为1到64个字符，只支持输入英文、数字、中文、中划线、下划线以及小数点，且不能以小数点、下划线开头或以小数点结尾。 数据源配置：选择数据源类型，进行对应的数据源配置。 容器标准输出：采集集群内指定容器日志，仅支持Stderr和Stdout的日志。 被匹配上的容器的标准输出会采集到指定的日志流，原先采集到的AOM的标准输出会停止采集。 容器标准输出不能重复配置，即使跨日志组和日志流，也只能配置一次。 容器文件路径：采集集群内指定容器内的文件路径日志。 节点文件路径：采集集群内指定节点路径的文件。 采集路径不能重复配置，即同一个主机下的同一路径，即使跨日志组和日志流，也只能配置一次。 表1 类型 参数配置 容器标准输出 采集容器标准输出（stdout）和采集容器标准错误（stderr）。两者必须得有一个是开启状态。 容器文件路径 路径配置：添加您需要收集的日志路径，LTS将按照配置的路径进行日志采集。 说明： 当CCE集群的工作负载中，已配置容器的挂载路径时，此时路径配置里添加的路径将无效。须将CCE集群页面中的挂载路径删除后，该配置才有效。 采集路径不能重复配置，即同一个主机下的同一路径，即使跨日志组和日志流，也只能配置一次。 设置采集黑名单：LTS支持对日志进行过滤采集，即通过设置黑名单，在采集时过滤指定的目录或文件。指定按目录过滤，可过滤掉该目录下的所有文件。 节点文件路径 路径配置：添加您需要收集的日志路径，LTS将按照配置的路径进行日志采集。 说明： 采集路径不能重复配置，即同一个主机下的同一路径，即使跨日志组和日志流，也只能配置一次。 设置采集黑名单：LTS支持对日志进行过滤采集，即通过设置黑名单，在采集时过滤指定的目录或文件。指定按目录过滤，可过滤掉该目录下的所有文件。 K8s匹配规则：当数据源类型选择容器标准输出和容器文件路径时，设置K8s匹配规则，非必选项。 表2 K8s匹配规则 参数名称 参数说明 K8s Namespace正则匹配 通过Namespace名称指定采集的容器，支持正则匹配。 说明： 采集名称符合正则规则的Namespace的日志，为空时采集所有Namespace的日志。 K8s Pod正则匹配 通过Pod名称指定待采集的容器，支持正则匹配。 说明： 采集名称符合正则规则的Pod的日志，为空时采集所有Pod的日志。 K8s容器名称正则匹配 通过容器名称指定待采集的容器（Kubernetes容器名称是定义在spec.containers中），支持正则匹配。 说明： 采集名称符合正则规则的容器的日志，为空时采集所有容器的日志。 容器Label白名单 通过容器Label白名单指定待采集的容器。如果您要设置容器Label白名单，那么LabelKey必填，LabelValue可选填。 说明： 如果LabelValue为空，则容器Label中包含LabelKey的容器都匹配；如果LabelValue不为空，则容器Label中包含LabelKey=LabelValue的容器才匹配；多个白名单之间为或关系，即只要容器Label满足任一白名单即可被匹配。 容器Label黑名单 通过容器Label黑名单排除不采集的容器。如果您要设置容器Label黑名单，那么LabelKey必填，LabelValue可选填。 说明： 如果LabelValue为空，则容器Label中包含LabelKey的容器都被排除；如果LabelValue不为空，则容器Label中包含LabelKey=LabelValue的容器才会被排除；多个黑名单之间为或关系，即只要容器Label满足任一黑名单即可被排除。 容器Label日志标签 设置容器Label日志标签后，日志服务将在日志中新增容器Label相关字段。 说明： 设置容器 Label日志标签后，lts将在日志中新增相关字段。例如设置LabelKey为app，设置LabelValue为app_alias，当容器中包含app=lts时，将在日志中添加的内容{app_alias：lts}。 环境变量白名单 用于指定待采集的容器。如果您要设置环境变量白名单，那么Label Key必填，Label Value可选填。 说明： 如果环境变量Value为空，则容器环境变量中包含环境变量Key的容器都匹配；如果环境变量Value不为空，则容器环境变量中包含环境变量Key=环境变量Value的容器才被匹配；多个白名单之间为或关系，即只要容器的环境变量满足任一键值对即可被匹配。 环境变量黑名单 用于排除不采集的容器。如果您要设置环境变量黑名单，那么Label Key必填，Label Value可选填。 说明： 如果环境变量Value为空，则容器环境变量中包含环境变量Key的容器都将被排除；如果环境变量Value不为空，则容器环境变量中包含环境变量Key=环境变量Value的容器才会被排除；多个黑名单之间为或关系，即只要容器的环境变量满足任一键值对即可被排除。 环境变量日志标签 设置环境变量日志标签后，日志服务将在日志中新增环境变量相关字段。 说明： 设置环境变量日志标签后，lts将在日志中新增相关字段，例如设置环境变量Key为app，设置环境变量Value为app_alias，当容器中包含环境变量app=lts时，将在日志中添加的内容为{app_alias：lts}。 高级配置：日志格式、日志时间具体说明如下： 表3 日志采集信息 名称 说明 日志格式 单行日志：采集的日志文件中，如果您希望每一行日志在LTS界面中都显示为一条单独的日志数据，则选择单行日志。 多行日志：采集的日志中包含像java异常的日志，如果您希望多行异常的日志显示为一条日志，正常的日志则每一行都显示为一条单独的日志数据，则选择多行日志，方便您查看日志并且定位问题。 日志时间 系统时间：表示系统当前时间，默认为日志采集时间，每条日志的行首显示日志的采集时间。 说明： 日志采集时间：ICAgent采集日志，并且发送到云日志服务的时间。 日志打印时间：系统产生并打印日志的时间。ICAgent采集日志并发送日志到云日志平台的频率为1秒钟。 采集日志时间限制：系统时间的前后24小时内。 时间通配符：用日志打印时间来标识一条日志数据，通过时间通配符来匹配日志，每条日志的行首显示日志的打印时间。 如果日志中的时间格式为：2019-01-01 23:59:59，时间通配符应该填写为：YYYY-MM-DD hh:mm:ss。 如果日志中的时间格式为：19-1-1 23:59:59，时间通配符应该填写为：YY-M-D hh:mm:ss。 说明： 如果日志中不存在年份信息，则云日志会自动补齐年份数据为当前年份数据。 填写示例： YY - year (19) YYYY - year (2019) M - month (1) MM - month (01) D - day (1) DD - day (01) hh - hours (23) mm - minutes (59) ss - seconds (59) hpm - hours (03PM)h:mmpm - hours:minutes (03:04PM)h:mm:sspm - hours:minutes:seconds (03:04:05PM) hh:mm:ss ZZZZ (16:05:06 +0100) hh:mm:ss ZZZ (16:05:06 CET) hh:mm:ss ZZ (16:05:06 +01:00) 分行模式 日志格式选择多行日志时，需要选择分行模式，分行模式选择“日志时间”时，是以时间通配符来划分多行日志；当选择“正则模式”时，则以正则表达式划分多行日志。 正则表达式 此配置是用来标识一条日志数据的正则表达式。日志格式选择“多行日志”格式后且“分行模式”已选择“正则模式”后需要设置。 日志拆分 云日志服务支持对日志进行拆分，默认为关闭状态。 当日志大小超过500KB时，开启日志拆分按钮，则单条日志会被拆分为多条采集。例如：日志大小为600KB，被拆分为2条日志采集，第一条500KB，第二条100KB。 当日志大小超过500KB时，未开启日志拆分按钮，则单条日志大小限制不超过500KB，超过限制部分会被截断丢弃。 采集二进制文件 云日志服务支持采集二进制文件，默认为关闭状态。 您可以通过命令（file -i 文件名）查看文件类型，如果包含charset=binary，那么该日志文件就是二进制文件。 当日志的文件类型为二进制时，开启采集二进制文件按钮，则对接入的二进制文件日志进行采集，但仅支持UTF8编码的字符串，非UFT8编码的字符在LTS控制台页面会显示乱码。 当日志的文件类型为二进制时，未开启采集二进制文件按钮，则对接入的二进制文件日志停止采集，开启后即可进行采集。 时间通配和正则表达式均是从每行日志的开头进行严格匹配，如果匹配不上，则会默认使用系统时间上报，这样可能会和文件内容中的时间不一致。如果没有特殊需求，建议使用单行日志-系统时间模式即可。

操作步骤 云日志服务接入方式选择CCE接入时，按照如下操作完成接入配置。 选择日志流 有两种采集方式：采集到自定义日志流和采集到集中日志流，您可以根据实际情况选择采集方式。 采集到自定义日志流 单击“所属日志组”后的目标框，在下拉列表中选择具体的日志组，若没有所需的日志组，单击“所属日志组”目标框后的“新建”，在弹出的创建日志组页面创建新的日志组。 单击“所属日志流”后的目标框，在下拉列表中选择具体的日志流，若没有所需的日志流，单击“所属日志流”目标框后的“新建”，在弹出的创建日志流页面创建新的日志流。 单击“下一步：安装日志采集组件”。 采集到集中日志流 集中采集日志到一个固定的日志流。CCE集群默认有四种采集日志流，目前仅支持三种，分别为标准输出/错误stdout-{ClusterID}、节点文件hostfile-{ClusterID}和容器文件containerfile-{ClusterID}。日志流名称会根据ClusterID自动命名，例如：集群ID为Cluster01，则标准输出/错误日志流为stdout-Cluster01。 在一个CCE集群下只能创建三条采集日志流，即三种日志流（标准输出/错误stdout-{ClusterID}、节点文件hostfile-{ClusterID}和容器文件containerfile-{ClusterID}），如果某个日志组下，已创建某种采集日志流，则不会在其他日志组或当前日志组下再创建该日志流。 单击“CCE集群”后的目标框，在下拉列表中选择具体的集群。 单击“所属日志组”后的目标框，在下拉列表中选择具体的日志组，若没有所需的日志组，单击“所属日志组”目标框后的“新建”，在弹出的创建日志组页面创建新的日志组。 单击“下一步：安装日志采集组件” 安装日志采集组件 云容器引擎（CCE）日志采集组件安装方式： 1. 登录云日志服务管理控制台 2. 在控制台左侧导航栏中，单击“主机管理” 3. 在主机管理页面中，单击“主机>CCE集群”，并选择需要升级的CCE集群 4. 单击“升级ICAgent”按钮 5. 在升级提示弹框中单击“确认” CCE集群里的主机必须安装日志采集组件，否则将无法配置CCE接入。 若您的CCE集群已经安装ICAgent日志组件，请单击“确认安装完毕”。 选择主机组 在主机组列表中选择一个或多个需要采集日志的主机组，若没有所需的主机组，单击列表左上方“新建”，在弹出的新建主机组页面创建新的主机组，具体可参考创建主机组（自定义标识）。 主机组可以为空，可以在接入配置设置完成后对主机组进行设置。 在“主机管理 > 主机组”页面对主机组和接入配置进行关联。 在接入配置详情中对主机组和接入配置进行关联。 单击“下一步：采集配置”。 采集配置 设置具体的采集规则，具体可参考采集配置。 设置完成后单击“提交”。 完成

使用限制 目前不支持ServiceStage托管场景。 支持容器引擎为Docker的CCE集群节点。详情请查看云容器引擎（CCE）。 不支持使用Containerd作为容器引擎的集群节点。 不支持CCE的Turbo集群。 容器内的日志目录如果已挂载到主机目录上，将无法通过CCE接入LTS进行日志采集。 Docker存储驱动限制：容器文件日志采集目前仅支持overlay2存储驱动，不支持devicemapper作为存储驱动的节点。查看存储驱动类型，请使用如下命令： docker info | grep "Storage Driver" 如果选择日志流时，采集方式为采集到集中日志流时，则必须已购买CCE集群。

概述 云日志服务提供实时日志采集功能，支持云服务、API/SDK接入等多种日志采集方式，采集日志后，日志数据可以在云日志控制台以简单有序的方式展示、方便快捷的方式进行查询。 云服务接入：云日志服务支持多个云服务日志接入，您可以选择不同云服务查看相应的日志接入方式。 自建软件接入：将主机待采集日志的路径配置到日志流中，ICAgent将按照日志采集规则采集日志至云日志服务。 API/SDK接入：云日志服务API/SDK/提供了一系列上报日志方法，您可以查看使用API/SDK/将日志接入云日志服务的方式。 其他：即跨账号接入。通过创建委托，将委托账号的日志流映射到被委托方账号，即就是将委托账号的日志流映射到当前云日志服务账号的日志流下。 单击名称，可以跳转到接入日志配置页面。例如：单击“云主机 ECS - 文本日志”会跳转到主机接入配置页面。 单击名称对应的，可以跳转到对应的资料页面。

我的收藏 我的收藏展示您收藏的日志流。 您可以通过云日志服务提供的收藏功能个性化定制属于自己的收藏日志流列表，方便您直接、快速的定位到常用的日志流。 以日志组lts-test为例，收藏日志组lts-test下某个日志流的操作步骤如下： 登录云服务日志控制台 在日志组列表区域，单击日志组lts-test对应的按钮，选择待收藏的日志流。 单击日志流右侧图标，可收藏日志流。 取消已收藏的日志流，有两种方式： 在日志流列表中，单击待取消收藏的日志流对应的，即可取消收藏。 在我的收藏中，鼠标悬浮待取消收藏的日志流，单击，即可取消收藏

资源详情 资源详情按照读写流量、索引流量和最新存储量三种方式，分别展示其Top100的日志组/日志流，默认按照最新存储量的Top100显示，单位为GB。您可根据自己的实际情况，选择读写流量、索引流量或最新存储量任一方式，进行Top100的日志组/日志流资源统计。 新创建的日志组/日志流，需间隔至少1小时才能进行资源统计。 单击Top100中的日志组名称，可查询该日志组下的日志流资源统计。 单击按钮，可下载日志组资源统计和日志流资源统计。 下载的日志组资源统计和日志流资源统计文件为.CSV格式。 资源详情可选择时间范围统计，时间范围有近3天、近1周、近15天、近1月以及自定义时间段。 当时间范围选择自定义时间段时， 仅根据自定义小时的整点数进行统计。 根据选择的时间范围，展示每日存储量（GB）、每日索引流量（GB）和每日读写流量（GB）的数据。 有两种展示方式： 表格 柱状图

操作步骤 日志服务接入方式选择跨账号接入时，按照如下操作完成接入配置。 选择委托 配置相关参数，请参见表1，完成后，单击“下一步：日志流映射”。 表1 委托参数配置 参数 说明 委托名称 填写委托人在IAM中创建的委托名称。委托人帐号可通过创建委托将资源管理权限委托给其他帐号。 委托人账号名称 填写委托人帐号名称，以验证委托关系。 日志流映射 在日志流映射页面，配置接入规则，有两种方式：自动配置和手动配置。 自动配置 在日志流映射页面，单击“自动配置”。 在弹出的自动配置页面中，配置相关参数信息，完成后，单击“确定”。 表2 自动配置接入规则 参数 说明 规则名称前缀 填写规则名称前缀，自动配置将使用您配置的规则名称前缀，产生多条接入规则。 只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。可不填写，默认规则名称前缀为rule。 从委托账号中选择您希望接入的日志组/日志流 选择希望接入的日志组/日志流，最多支持选择20条。 通过自动配置的接入规则，被委托方中的目标日志组、目标日志流名称默认同委托方中源日志组、源日志流名称保持一致，也支持手动修改。 单击“预览”，查看预览结果。 预览结果有两种： 将创建新的目标日志流：被委托方中新建的目标日志组/日志流。 接入已存在的目标日志流：被委托方中已存在的目标日志组/日志流。 预览报错情况如下： 源日志流xxx，已配置为目标日志流 目标日志流xxx，已配置为源日志流 目标日志流xxx，已存在于其它日志组 目标日志流xxx，存在于不同目标日志组 规则名称重复 源日志流xxx，已存在映射关系 日志组/日志流超过最大创建条数 当提示以上报错时，须删除日志流对应的接入规则。 预览完成后，单击“提交”。 手动配置 在日志流映射页面，单击“添加规则”。 表3 参数 说明 规则名称 默认为rule_xxx，也可根据您的需要进行自主命名。 只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。 委托方 源日志组 委托方的日志组，在原有的日志组中进行选择。 源日志流 委托方的日志流，在原有的日志流中进行选择。 被委托方 目标日志组 被委托方的日志组，可在原有的日志组中进行选择或直接输入名称进行新建日志组。 目标日志流 被委托方的日志流，可在原有的日志流中进行选择或直接输入名称进行新建日志流。 单击“预览”，查看预览结果。 预览结果有两种： 将创建新的目标日志流：被委托方中新建的目标日志组/日志流。 接入已存在的目标日志流：被委托方中已存在的目标日志组/日志流。 预览报错情况有五种： 源日志流xxx，已配置为目标日志流 目标日志流xxx，已配置为源日志流 目标日志流xxx，已存在于其它日志组 目标日志流xxx，存在于不同目标日志组 规则名称重复 源日志流xxx，已存在映射关系 日志组/日志流超过最大创建条数 当提示以上报错时，须删除日志流对应的接入规则。 预览完成后，单击“提交”，等待创建日志接入成功。 完成 当接入多个日志流时，单击“返回接入配置列表”可查看日志接入列表。 当接入单个日志流时，单击“返回接入配置列表”可查看日志接入列表；单击“查看日志流”可查看已接入的日志详情。 配置完成后，数据将会在1小时内完成同步，请您耐心等待。

主机组 用户可以在主机组界面对标签进行增删改查，操作主机组标签仅对当前主机组有效。 在云日志服务管理控制台，选择左侧的“主机管理”。 在主机管理页面，单击主机组所在行“操作”列的。 在弹出标签管理页面填写标签键和标签值后单击“添加”，会将填写的键值按照“标签键=标签值”的形式显示在页面下方显示框中，如下图所示。 如需添加多个标签可重复该步骤。 如需删除标签可单击标签管理界面显示框中待删除标签后的。 标签键长度不能超过128个字符；标签值长度不能超过255个字符。 标签键名称不可重复。 单击“确定”，完成对该主机组的标签管理。 在主机管理页面，主机组列表的“标签”列可以查看主机组已添加的普通标签。

日志流 用户可以在日志流界面对标签进行增删改查，操作日志流标签仅对当前流有效。 在云日志服务管理控制台，选择左侧的“日志管理”。 在日志管理页面，单击日志组列表下日志组名称对应的按钮。 在日志流列表中，将鼠标悬浮在日志流的“标签”列单击。 在弹出标签管理页面填写标签键和标签值后单击“添加”，会将填写的键值按照“标签键=标签值”的形式显示在页面下方显示框中，如下图所示。 如需添加多个标签可重复该步骤。 如需删除标签可单击标签管理界面显示框中待删除标签后的。 标签键长度不能超过128个字符；标签值长度不能超过255个字符。 标签键名称不可重复。 单击“确定”，完成对该日志流的标签管理。 在日志流列表的“标签”列可以查看该日志流下的系统标签和已添加的普通标签。

日志组 用户可以在日志组界面对标签进行增删改查，操作日志组标签会将标签同步至该日志组下所有日志流。 在云日志服务管理控制台，选择左侧的“日志管理”。 在日志管理页面，日志组列表中，将鼠标悬浮在“标签”列单击。 在弹出标签管理页面填写标签键和标签值后单击“添加”，会将填写的键值按照“标签键=标签值”的形式显示在页面下方显示框中，如下图所示。 如需添加多个标签可重复该步骤。 如需删除标签可单击标签管理界面显示框中待删除标签后的。 标签键长度不能超过128个字符；标签值长度不能超过255个字符。 标签键名称不可重复。 单击“确定”，完成对该日志组的标签管理。 在日志管理页面，日志组列表的“标签”列可以查看日志组已添加的普通标签。

授权IAM用户使用LTS 图1 给用户授权LTS 权限流程 创建用户组并授权 在IAM控制台创建用户组，并给用户组授予云日志服务操作权限：“LTS Administrator”。 选择“LTS Administrator”，由于该策略有依赖，除了勾选LTS Administrator外，还需要在同项目中勾选依赖的策略：Tenant Guest、以及“全局区域 对象存储服务项目”中勾选依赖的策略：Tenant Administrator。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，验证LTS的只读权限。

参数获取方法 日志组ID：登录云日志服务页面，选择日志管理，日志组名称下面的ID即为日志组ID。 日志流ID：单击日志组名称，跳转至日志流列表，日志流名称下面的ID即为日志流ID。 项目ID/ProjectID：请参见“我的凭证 > API凭证”。 访问密钥access key（AK）/secret access key（SK），请参见“我的凭证 > 访问密钥 ”。 上报日志地址：不同服务不同区域的上报地址不同，请联系华为工程师。 IAM 鉴权地址如下表所示： 区域名称 区域 终端节点（Endpoint） 协议类型 global global iam.myhuaweicloud.com HTTPS 华北-北京二 cn-north-2 iam.cn-north-2.myhuaweicloud.com HTTPS 华北-北京四 cn-north-4 iam.cn-north-4.myhuaweicloud.com HTTPS 华北-北京一 cn-north-1 iam.cn-north-1.myhuaweicloud.com HTTPS 华东-上海二 cn-east-2 iam.cn-east-2.myhuaweicloud.com HTTPS 华东-上海一 cn-east-3 iam.cn-east-3.myhuaweicloud.com HTTPS 华南-广州 cn-south-1 iam.cn-south-1.myhuaweicloud.com HTTPS 华南-深圳 cn-south-2 iam.cn-south-2.myhuaweicloud.com HTTPS 西南-贵阳一 cn-southwest-2 iam.cn-southwest-2.myhuaweicloud.com HTTPS

配置参数说明 ClientConfig类方法参数介绍： 参数名称 参数说明 对应方法 取值举例 accessKey 华为云租户的访问密钥access key setAccessKey QINDZD28DSEZExxxxxxx secretKey 华为云租户访问密钥secret key setSecretKey abc0WGkdXlhX40Z7R4dFsuK384ZhIIdFaxxxxxxx projectId 当前租户的项目ID setProjectId 1c06fc5dc0814a4da1594a9adxxxxxxx region 租户所在的Region信息 setRegion cn-east-3 isCompression 是否开启日志压缩 enableCompression true/false 日志上报LogItems类参数说明： 参数 是否必选 参数类型 描述 logItems 是 Array 批量日志 日志上报LogItem类参数说明： 参数 是否必选 参数类型 描述 tenantProjectId 是 String 租户项目ID contents 是 Array< LogContent> 批量日志内容，最大为1M labels 是 String 日志标签，JSON格式(示例Key值：projectId，clusterId，clusterName，nameSpace，appGroup，appName，serviceID，podName，pid，group，containerName，hostId，hostIP，hostName，hostIPv6，serverlessFunc，serverlessPkg，functionVersion，pailId，pathFile，kind） 例如： {"clusterName" : "k8s","appGroup" : "group1"} 日志上报LogConten类参数说明 参数 是否必选 参数类型 描述 logTimeNs 是 Long 日志时间（单位：纳秒） log 是 String 日志内容

使用步骤 获取华为云帐号的AK/SK，步骤参考：如何获取AK/SK。 安装Java开发环境，日志SDK支持JDK1.6以上开发环境。 下载并安装日志SDK包 下载日志SDK包。 下载后解压到指定目录。注：直接解压即可，不需要额外操作。 将解压后的所有jar包添加到您的java工程。 在云日志服务创建日志组和日志流。 开始一个新的Java工程。 public class PushLogSample {private static final Logger LOG = LoggerFactory.getLogger(PushLogSample.class);// Demo演示程序public static void main(String[] args) throws ClientException { // 初始化链接配置 ClientConfig clientConfig = ClientConfig.custom() .setAccessKey("5IMO4TOKD5E9XXXXXXX") // 当前租户的AK（Access Key） .setSecretKey("DRZYndiDyA8XXXFLYbaXXXN2ELuUsvXXXXXXXXXX") // 当前租户的SK（SecretKey Key） .setProjectId("1b06fXXXXX814XXXXX594a9adXX3c") // 当前租户的项目ID（Project Id） .setRegion("cn-north-7") // 当前租户的区域信息 .enableCompression(true) // 发送日志是否需要压缩（当日志内容过大，请开启true。不设置此参数，默认为false不开启压缩） .builder(); // 创建链接 Client client = new Client(clientConfig); // 创建日志发送的结构体 LogItems logItems = new LogItems(); List logItemList = new ArrayList<>(); for (int i = 0; i < 1; i++) { LogItem logItem = new LogItem(); logItem.setTenantProjectId("projectId"); Map labels = new HashMap<>(); labels.put("clusterId", "test_clusterId"); logItem.setLabels(JSONObject.toJSONString(labels)); List contents = new ArrayList<>(); for (int k = 0; k < 100; k++) { LogContent logContent = new LogContent(); logContent.setLogTimeNs(System.currentTimeMillis()*1000000); logContent.setLog("demo log~~~~~"); contents.add(logContent); } logItem.setContents(contents); logItemList.add(logItem); } logItems.setLogItems(logItemList); // 发送日志（日志组ID，日志流ID，日志） final LogResult result = client.pushLog("835XXXXX-63ce-XXXX-9d92-XXXXX37af9a8", "ff70XXX8-XXXX-4091-XXXX-XXXXXb69b5ed", logItems); if (result.isSuccess()) { LOG.warn("push log success.., msg {}", JSONObject.toJSONString(result)); } else { LOG.warn("push log failed .., msg {}", JSONObject.toJSONString(result)); } }}

使用前配置 使用云日志服务SDK前，您需要进行ClientConfig类的初始化配置。配置内容如下： 确认云日志服务的区域 使用SDK前首先需要确认当前租户所在的Region（如“华北-北京-1”等），然后选择与其匹配的云日志服务区域。 配置访问秘钥（AK/SK） 日志SDK依赖AK（Access Key）和SK（Secret Access Key）进行鉴权，使用SDK前需要先获取AK/SK信息。 获取当前租户的项目ID（Project Id）

操作步骤 在云日志服务管理控制台，单击“日志管理”。 在日志组列表中，单击日志组名称。 在日志流列表中，单击日志流名称。 您还可以在日志流“操作”列中，单击“搜索”进入日志流详情页面。 在日志流详情页面，单击创建快速查询，输入“快速查询名称”和“快速查询语句”。 快速查询名称，用于区分多个快速查询语句。名称自定义，需要满足如下要求： 只支持输入英文、数字、中文、中划线、下划线及小数点。 不能以小数点或下划线开头，以小数点结尾。 长度为1-64个字符。 快速查询语句，搜索日志时需要重复使用的关键字，例如“error*”。 单击“确定”，完成快速查询条件的创建。 单击快速查询语句的名称，查看日志详情。 图1 查看快速查询语句

操作步骤 在云日志服务管理控制台，单击日志组名称，进入日志组页面。 在日志组页面，单击日志流名称，进入日志流页面。 在左侧导航栏单击“日志接入 > 主机接入”。 图1 采集配置 在“添加主机”步骤，选择“Linux主机”或“Windows主机”，然后勾选您需要收集日志的主机名，单击“下一步”。 在“配置采集路径”步骤，添加您需要收集日志路径，LTS按照配置的路径进行日志采集。当选择Windows主机采集日志时，需要开启“采集Windows事件日志”，并且可以设置“日志类型”、“首次采集时间偏移量”、“事件等级”来过滤采集您所需要的日志内容。 采集路径支持递归路径，**表示递归5层目录。 示例：采集路径配置为 /var/logs/**/a.log，日志匹配如下： /var/logs/1/a.log /var/logs/1/2/a.log/var/logs/1/2/3/a.log/var/logs/1/2/3/4/a.log/var/logs/1/2/3/4/5/a.log 以上示例中的/1/2/3/4/5/，表示/var/logs目录中，往里递归的5个目录层级，在这5个目录层级中只要存在a.log，都能进行日志匹配。 采集路径中只能出现一次**，不能出现两个及以上。正确示例：/var/logs/**/a.log；错误示例：/opt/test/**/log/**。 采集路径中第一个层级不允许为**（避免误采集系统文件），错误示例：/**/test。 采集路径支持模糊匹配，匹配目录或文件名中的任何字符。 如果配置了C:\windows\system32类似的日志采集路径，但无法采集日志，请尝试打开WAF物理防火墙后重新配置。 示例1：采集路径配置为 /var/logs/*/a.log，表示/var/logs/目录下，任何一个目录中存在a.log，都能进行日志匹配，例如： /var/logs/1/a.log /var/logs/2/a.log 示例2：采集路径配置为 /var/logs/service-*/a.log，日志匹配示例： /var/logs/service-1/a.log /var/logs/service-2/a.log 示例3：采集路径配置为 /var/logs/service/a*.log，日志匹配示例： /var/logs/service/a1.log /var/logs/service/a2.log 采集路径如果配置的是目录，示例：/var/logs/，则只采集目录下后缀为“.log”、“.trace”和“.out”的文件。 如果配置的是文件名，则直接采集对应文件，只支持文本类型的文件。 请注意您的敏感信息是否在收集范围内。 当主机选择“Windows主机”时，如需采集系统日志，需要在“配置采集路径”环节，开启“采集Windows事件日志”。 windows事件日志采集不能重复配置，即相同主机下，即使跨日志组和日志流，也只能配置一次。 LTS暂不支持采集PostgreSQL（数据库）实例的日志，目前只支持采集安装在ECS（主机）实例的日志。 日志采集路径不能重复配置，即相同主机的同一个日志采集路径不能重复配置，否则可能会导致日志采集异常。 相同主机的同一个日志采集路径，如果在AOM进行了配置，则不能在LTS重复配置。 配置的文件的最后修改时间和当前时间差如果已超过12小时，则不会采集。 单击“下一步”，进入“配置采集信息”步骤。 表1 日志采集信息 名称 说明 日志格式 单行日志：采集的日志文件中，如果您希望每一行日志在LTS界面中都显示为一条单独的日志数据，则选择单行日志。 多行日志：采集的日志中包含像java异常的日志，如果您希望多行异常的日志显示为一条日志，正常的日志每一行都显示为一条单独的日志数据，则选择多行日志，方便您查看日志并且定位问题。 日志时间 系统时间：表示系统当前时间，默认为日志采集时间，每条日志的行首显示日志的采集时间。 说明： 日志采集时间：Agent采集日志，并且发送到云日志服务的时间；日志打印时间：系统产生并打印日志的时间。 Agent采集日志并发送日志到云日志平台的频率为1秒钟。 时间通配符：用日志打印时间来标识一条日志数据，通过时间通配符来匹配日志，每条日志的行首显示日志的打印时间。 如果日志中的时间格式为：2019-01-01 23:59:59，时间通配符应该填写为：YYYY-MM-DD hh:mm:ss。 如果日志中的时间格式为：19-1-1 23:59:59，时间通配符应该填写为：YY-M-D hh:mm:ss。 说明： 如果日志中不存在年份信息，则云日志会自动补齐年份数据为当前年份数据。 填写示例： YY - year (19) YYYY - year (2019) M - month (1) MM - month (01) D - day (1) DD - day (01) hh - hours (23) mm - minutes (59) ss - seconds (59) hpm - hours (03PM)h:mmpm - hours:minutes (03:04PM)h:mm:sspm - hours:minutes:seconds (03:04:05PM) hh:mm:ss ZZZZ (16:05:06 +0100) hh:mm:ss ZZZ (16:05:06 CET) hh:mm:ss ZZ (16:05:06 +01:00) 分行模式 日志格式选择多行日志时，需要选择分行模式，分行模式选择“日志时间”时，是以时间通配符来划分多行日志；当选择“正则模式”时，则以正则表达式划分多行日志。 正则表达式 此配置是用来标识一条日志数据的正则表达式。日志格式选择“多行日志”格式后且“分行模式”已选择“正则模式”后需要设置。 时间通配和正则表达式均是从每行日志的开头进行严格匹配，如果匹配不上，则会默认使用系统时间上报，这样可能会和文件内容中的时间不一致。如果没有特殊需求，建议使用单行日志-系统时间模式即可。 单击“确认”，完成日志采集规则配置。此时，云日志服务将按照设定的采集规则进行日志采集。 日志成功采集后，如果您的日志采集路径等发生变化，还可以修改日志采集配置。

概述 主机和云服务的日志数据上报至云日志服务后，默认存储时间为7天，您在创建日志组时，可以对日志存储进行设置（1-30天）。超出存储时间的日志数据将会被自动删除，对于需要长期存储的日志数据（日志持久化），云日志服务提供转储功能，可以将日志转储至其他云服务中进行长期保存。 日志转储功能只能拷贝已有日志，不会删除日志。根据配置的存储时间可定时清理日志文件，不会影响转储后的日志。 当前LTS支持转储至以下云服务，请根据您的业务场景选择OBS、DIS进行日志转储。 对象存储服务 OBS 提供日志存储功能，长期保存日志。 数据接入服务DIS 提供日志长期存储能力和丰富的大数据分析能力。 DIS可以将大量日志文件传输到云端做备份，进行离线分析、存储查询及机器学习，还能用于数据丢失或异常后的恢复和故障分析。同时大量小文本文件可合并转储为大文件，提高数据处理性能。 转储至DMS DMS通过分布式消费服务API处理日志。 当前LTS支持跨租户转储，可以通过创建委托将日志转储的能力共享给其他帐号，让其他帐号代为转储该帐号下的日志数据。委托时需要对被委托帐号赋予可以获取日志组和日志流的权限，例如LTS FullAccess。

删除过滤器 如果创建过滤器时显示配额不足，可以删除不再需要使用的过滤器后重试。 在“日志管理”页面中，单击日志组名称。 在日志流列表中，单击日志流所在行的指标数下的数字或横线。如下图： 图5 删除过滤器 在日志流下的过滤器列表中，单击需要删除的过滤器所在行的“删除”。 删除过滤器后，将无法在应用运维管理中再针对这项指标进行监控，但在应用运维管理中您还可以看见这个监控指标，待数据老化后，系统将自动删除该监控指标。

创建过滤器 在云日志服务管理控制台，单击日志组名称。 在日志流列表中，单击日志流所在行的“操作”列的“更多 > 指标过滤”。 图1 指标过滤 表1 参数说明 名称 说明 过滤器名称 用于区分同一日志流下不同的过滤器。 名称需要满足如下要求： 只支持输入英文、数字、中文、中划线、下划线及小数点。 不能以小数点、下划线开头或以小数点结尾。 长度为1-64个字符。 过滤关键词 过滤器将按照设置的关键词，对日志流中的日志数据进行关键词统计。 仅支持单个关键词的过滤，如果输入多个关键词也会被当成一个字符串处理。 过滤方式是精确匹配，区分大小写，数字及特殊符号需用双引号包含起来。 日志样例 用于测试配置的“过滤关键词”是否能精准匹配相关日志。 默认支持测试最近10条日志，如果无法匹配到相关日志，可以在日志列表中寻找符合条件的日志粘贴到测试框中，验证过滤关键词是否生效，也可以调整过滤关键词。 指标名称 “过滤关键词”对应的指标名称，类似key-value中的key值，以便日志服务帮助您做指标统计，并且将指标统计值发布到应用运维服务中，应用运维服务进行监控关键词出现的频率、次数及设置阈值并且接收告警。 名称需要满足如下要求： 只支持输入英文、数字、中文、中划线、下划线及小数点。 不能以小数点、下划线开头或以小数点结尾。 长度为1-64个字符。 请注意同一日志流下的指标名称不能重复，否则可能会造成数据不准的情况出现。 单击“确定”，完成过滤器的创建。 单击“指标数”列的数字，指标名称，可以跳转至应用运维管理界面查看监控详情。 图2 查看过滤器 在应用运维管理界面，依次选择“监控 > 指标浏览 > 自定义指标 > ALSAlarm”，对过滤的指标进行监控和告警。 图3 监控过滤器

删除日志流 如果日志流不再需要使用，可以删除日志流，日志流删除后，日志流中的日志数据将被同时删除。日志流删除后无法恢复，请谨慎操作。 删除日志流前请确认该日志流下没有配置日志采集任务，否则删除后可能影响正常的日志上报。 如果日志流绑定了日志转储任务，删除日志流之前，需要先删除该日志流关联的日志转储任务。 在日志流列表中，单击待删除日志流所在行的“删除”。 在弹出框中输入“DELETE”后，单击“确定”，完成日志流删除。

创建日志流 日志流的创建类型分为用户创建（主动）和云服务创建（被动），云服务创建指其他云服务与云日志服务进行系统对接后，系统自动在云日志服务控制台创建的日志流，本操作中日志流的创建类型为用户创建（主动）。 图1 创建日志流 在云日志服务管理控制台，单击日志组名称对应的按钮。 单击展开页面左上角的“创建日志流”，输入日志流名称，名称需要满足如下要求： 只支持输入英文、数字、中文、中划线、下划线及小数点。 不能以小数点、下划线开头或以小数点结尾。 长度为1-64个字符。 日志采集后，以日志流为单位，将多条日志数据发往云日志服务。如果日志较多，需要分门别类，建议您创建多个日志流，并给日志流做好命名，方便后续快速查找日志。日志流创建后，名称不支持修改。 在“企业项目”处选择业务需要的企业项目，也可单击“查看企业项目”，在企业项目管理页面查看全部企业项目。 单击“确定”，完成日志流的创建。 在日志流页面中，可以查看日志流的名称、企业项目、日志存储时间、创建时间和创建类型。