华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账，当前仅支持按需计费模式。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 表3 请求Body参数 参数名 参数类型 是否必选 说明 face_id String 是 人脸ID，由系统内部生成的唯一ID。 external_image_id String 否 用户指定的图片外部ID，与当前图像绑定。用户不设置该参数时，系统会自动生成一个。该ID长度范围为[1,36]，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。 这里是待修改的参数，external_image_id和external_fields至少选一个。 external_fields Object 否 自定义字段的key值长度范围为[1,36]，string类型的value长度范围为[1,256]，具体参见自定义字段。 这里是待修改的参数，external_image_id和external_fields至少选一个。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 face_number Integer 更新的人脸数量。 调用失败时无此字段。 face_set_id String 人脸库ID。 调用失败时无此字段。 face_set_name String 人脸库名称。 调用失败时无此字段。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

日志告警 如果没有对函数代码执行返回结果有特定要求，例如绑定了APIG触发器的事件函数需要返回一个APIG响应格式的结果如下： import json def handler (event, context): return { "statusCode": 200, "isBase64Encoded": False, "body": json.dumps(event), "headers": { "Content-Type": "application/json" } } 一般不建议在函数代码内捕获异常，其会导致创建的错误次数告警配置不生效。但是FunctionGraph实现了与云日志服务(LTS)的对接，支持在LTS服务中配置告警，LTS支持日志告警实时监控函数日志中出现的异常信息。 父主题： 使用函数访问Redis数据库

处理建议 返回对象选择页面，重新选择要同步的对象后再进行预检查。 预检查阶段，源数据库连接中断，导致检查失败。请确认源数据库连接正常后再重新进行预检查 Oralce为源的任务，由于Oracle Logminer组件限制，增量阶段源库所选表的schema名、表名及其包含的列名不能超过30个字符。请修改不符合要求的schema名、表名及其中的列名，使其长度不超过30个字符，然后重新再进行预检查。 Microsoft SQL Server为源的任务，单个任务同步的表数量不能超过1000张。请减少单个任务同步的表数量，取消勾选不需要同步的表，或者拆分成多个同步任务执行，然后重新再进行预检查。 请检查源或者目标数据库引擎是否属于特殊版本，特殊版本可能存在某些语法不支持，导致预检查不通过，请重新更换源或者目标数据库后重新进行预检查。

主机接入LTS后无法采集到日志？ 若刚完成配置则需要等待片刻，日志才会开始上报。 排查主机配置的采集路径是否重复，即有可能主机的路径配置了多次，这样则需要修改配置，同一个主机的路径只允许存在一种配置。 排查相同主机的同一个日志采集路径，是否已在AOM进行了配置。在AOM配置后则不能在LTS重复配置。 参考ECS接入排查是否存在不规范的配置导致日志采集失败。 若以上解决办法无法解决您的问题，请提交工单寻求技术支持工程师的帮助。 父主题： 日志接入

排查方法 登录ICAgent所在ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 过滤日志文件，排查资源占用是否超过限制。 cat oss.icAgent.trace| grep 'icagent exit' 过滤日志压缩包，排查资源占用是否超过限制。 zgrep 'icagent exit' *.zip 过滤日志文件，ICAgent是否异常。 cat oss.script.trace | grep runtime 过滤日志压缩包，ICAgent是否异常。 zgrep runtime oss.script.*.zip

成本对比 场景一： 假设客户每天原始日志100GB（日志平均速率1.16MB/s），日志平均存储30天，30天原始日志总量为3000GB，日志存储方式为一主一副本。 根据Elasticsearch官方推荐，在一主一副本存储方式下，原始日志+副本数据+索引数据等合计占用的存储空间约为原始日志大小2.2倍，另外由于ES集群存在写不均匀且磁盘不能被耗尽，因此为了存储3000GB原始日志，至少需要准备3000GB*2.2（存储膨胀）*2（50%磁盘冗余） = 13200 GB磁盘。 搭建ES最小典型配置是3台ECS（16U64G5TB），kafka双副本能支持缓存最近12小时的日志 大类 小类 月成本 费用占比 搭建ES 3 * ECS（C6 16U64G） 3*1999=5997 47.6% 云硬盘EVS（高IO 15TB） 0.35*15*1024=5376 42.7% 搭建KAFKA 3 * ECS（2U4G） 3*208=624 4.9% 云硬盘EVS（超高IO 3*200GB） 600 4.7% - - 自建ELK，合计：12597 - LTS使用价格计算器，计算出来月成本约为2102元，使用LTS的成本约为自建ELK成本的16.7%，原因是在小日志量场景下，自建ELK起步资源成本很高，相比于按需付费的LTS，有很大劣势。 场景二： 假设客户每天原始日志1TB（日志平均速率11.6MB/s），日志平均存储7天，7天原始日志总量为7TB，日志存储方式为一主一副本。根据Elasticsearch官方推荐，在一主一副本存储方式下，原始日志+副本数据+索引数据等合计占用的存储空间约为原始日志大小2.2倍，另外由于ES集群存在写不均匀且磁盘不能被耗尽，因此为了存储7TB原始日志，至少需要准备7TB*2.2（存储膨胀）*2（50%磁盘冗余） = 31 TB磁盘。 搭建ES最小典型配置是3台ECS（16U64G10TB），kafka双副本能支持缓存最近12小时的日志 大类 小类 月成本 费用占比 搭建ES 3 * ECS（C6 16U64G） 3*1999=5997 31.7% 云硬盘EVS（高IO 31TB） 0.35*31*1024=11110 58.7% 搭建KAFKA 3 * ECS（2U4G） 3*208=624 3.3% 云硬盘EVS（超高IO 3*400GB） 1200 6.3% - - 自建ELK，合计：18931 - LTS使用价格计算器，计算出来月成本约为13408元，使用LTS的成本约为自建ELK成本的71%，原因是LTS的存储收费是按用量付费，自建ELK为了保证集群的正常运行需要留有很多磁盘冗余。 场景三： 假设客户每天原始日志5TB（日志平均速率58MB/s），日志平均存储30天，30天原始日志总量为150TB，日志存储方式为一主一副本。 根据Elasticsearch官方推荐，在一主一副本存储方式下，原始日志+副本数据+索引数据等合计占用的存储空间约为原始日志大小2.2倍，另外由于ES集群存在写不均匀且磁盘不能被耗尽，因此为了存储150TB原始日志，至少需要准备150TB*2.2（存储膨胀）*2（50%磁盘冗余） = 660 TB磁盘。 搭建ES最小典型配置是66台ECS（16U64G10TB），kafka双副本能支持缓存最近12小时的日志 大类 小类 月成本 费用占比 搭建ES 66 * ECS（C6 16U64G） 66*1999=131934 35.3% 云硬盘EVS（高IO 660TB） 0.35*660*1024=236544 63.2% 搭建KAFKA 3 * ECS（2U4G） 3*208=624 0.2% 云硬盘EVS（超高IO 3*1700GB） 5100 1.4% - - 自建ELK，合计：374202 - LTS使用价格计算器，计算出来月成本约为107655元，使用LTS的成本约为自建ELK成本的28.8%，原因是LTS的存储收费是按用量付费，自建ELK为了保证集群的正常运行需要留有很多磁盘冗余。

功能对比 云日志服务（LTS）在功能特性的完备度、日志搜索分析性能方面对比ELK有明显的优势，详细对比请见如下表格： 特性 子特性 LTS ELK 描述 日志采集 云服务日志采集 ☆☆☆☆☆ 无 ELK：不支持采集云服务日志。 LTS：云服务租户面日志统一采集到LTS。 虚机和容器日志采集 ☆☆☆☆☆ ☆☆☆☆ ELK：使用logstash或者filebeat等开源采集器采集日志。 LTS：使用ICAgent采集日志，有提供向导页面，上手难度低。 多语言SDK日志采集 ☆☆☆ 无 ELK：不支持。 LTS：提供java SDK直接上报日志到LTS 主机组管理（主机动态扩缩容） ☆☆☆☆☆ 无 ELK：不支持。 LTS：提供主机管理、主机组管理能力，主机组支持自定义标识主机组，可以管理动态扩缩容主机组。 日志结构化解析 ☆☆☆☆ ☆☆☆☆☆ ELK：基于采集器实现自定义日志结构化解析。 LTS：提供结构化解析能力，可以正则表达式、JSON、分隔符、自定义模板等方式解析日志。 日志搜索 关键词搜索、模糊搜索、快速分析 ☆☆☆☆☆ ☆☆☆☆☆ ELK和LTS：提供类似的日志关键词搜索能力。 实时日志查看 ☆☆☆☆☆ 无 ELK：未提供实时日志查看页面。 LTS：提供实时日志查看页面。 百亿日志秒级搜索 ☆☆☆☆☆ ☆☆ ELK：自建ELK受限于机器资源数量，搜索海量日志时耗时较长。 LTS：利用公有云海量的弹性计算资源，百亿日志可以在3秒内返回搜索结果。 千亿级日志迭代搜索 ☆☆☆☆☆ 无 ELK：无法直接搜索千亿条日志，会出现响应超时。 LTS：提供迭代搜索能力，用户可以直接搜索千亿条日志。 日志管理规模 百PB级 百TB级 ELK：经常要关注机器扩容，费时费力。 LTS：按需付费，LTS自动管理百PB级日志，不用关心底层资源消耗情况。 日志搜索 SQL分析日志 ☆☆☆☆☆ ☆☆ ELK：SQL性能差，语法上不支持嵌套SQL。 LTS：SQL性能强，支持嵌套SQL。 日志搜索 SQL函数 ☆☆☆☆☆ ☆☆ ELK：只支持最基础的SQL统计函数。 LTS：在基础SQL函数基础上，提供了大量的扩展函数，例如IP函数、统计函数、环比同比函数、URL函数等，极大扩展了使用场景。 日志搜索 可视化图表 ☆☆☆☆ ☆☆☆ LTS：提供了表格、折线图、饼图、柱状图等多种可视化图表 日志搜索 仪表盘 ☆☆☆☆☆ ☆☆ ELK：没有云服务日志开箱即用仪表盘。 LTS：提供开箱即用的仪表盘，对常见的云服务日志例如ELB/APIG/DDS/DCS/CFW等提供开箱即用的仪表盘。 日志告警 日志关键词告警和SQL告警 ☆☆☆☆☆ ☆ ELK：没有日志告警功能。 LTS：提供准实时的日志关键词和SQL告警功能。 告警通知渠道（邮件、短信、HTTPS等） ☆☆☆☆☆ ☆ ELK：无法将告警方便的以钉钉、微信、短信等方式通知用户。 LTS：对接华为云消息通知服务，能以邮件、短信、微信、钉钉、飞书、HTTP等多种渠道通知客户。 日志转储 转储到对象存储 ☆☆☆☆☆ 无 ELK：无法直接转储对象存储。 LTS：页面简单配置可以将日志转储到对象存储。 日志转储 转储到kafka ☆☆☆☆☆ ☆☆ ELK：需要自己部署程序将日志转发到KAFKA LTS：页面简单配置可以将日志实时转储到KAFKA 日志转储 转储到数据仓库 ☆☆☆☆☆ 无 ELK：无法直接将日志转储到数据仓库 LTS：页面简单配置可以将日志转储到数据仓库 日志加工 定时SQL作业 ☆☆☆☆☆ 无 ELK：没有定时SQL作业能力 LTS：可以配置定时SQL作业，将原始日志加工统计为想要的少量日志结果 函数加工 ☆☆☆☆☆ 无 ELK：没有日志加工功能。 LTS：提供函数触发器，在函数服务中可以配置自定义脚本将日志灵活加工。

主机管理 在Windows环境下安装ICAgent失败并提示"SERVICE STOP"怎么办？ 在LTS页面升级ICAgent失败怎么办？ 无法查询LTS原始日志页面新产生的日志怎么办？ 安装ICAgent完成后反复重启怎么办？ 在LTS页面安装ICAgent完成后显示离线怎么办？ 在LTS页面安装ICAgent完成后不显示怎么办？ 如何创建终端节点？ 如何获取AK/SK？ 如何通过创建委托授权安装ICAgent？

排查方法 确认日志采集开关是否开启。 登录云日志服务LTS控制台，选择“配置中心”。 在“日志采集开关”页签，确认日志采集开关是否开启，若没有开启，需要开启日志采集开关。 检查最近一次下发的日志采集开关配置。 登录ICAgent所在的ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 执行如下命令，查询日志采集配置。 zgrep switchList *.zip //查询已转储日志压缩包 cat oss.icAgent.trace | grep switchList //查询当前日志文件 从过滤结果查找日志时间最新的配置，并查看switch.log是否为true（代表开启日志采集开关）。 检查日志采集开关文件的内容switch.log是否为true（代表开启日志采集开关）。 登录ICAgent所在的主机。 查询日志采集开关文件。 cat /var/share/oss/manager/ICProbeAgent/internal/TRACE_CONFIG/swithes_context.json 日志采集开关文件的内容switch.log为true。 确认是否日志发送失败。 登录ICAgent所在ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 查询发送失败日志。 cat oss.icAgent.trace | grep httpsend | grep 'dataType:TRACE' | grep failed zgrep 'dataType:TRACE' *.zip | grep httpsend | grep failed 若显示failed代表日志发送失败，则需要联系LTS技术支持工程师排查。 确认LTS下发配置。 登录ICAgent所在ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 过滤日志文件查询LTS下发的日志采集配置。 cat oss.icAgent.trace | grep 'als event' | grep -v grep | tail -n 1 以上截图仅供参考，请以实际查询结果为准。从过滤结果查找用户实际设置的日志组、日志流以及采集路径，则确保已下发采集配置。 如果日志文件查询不到，则查询日志压缩包。 zgrep 'als event' *.zip | grep -v grep | tail -n 1 登录云日志服务LTS控制台，确认是否正确下发了采集配置。

容器应用日志场景 场景描述：适用于用户将应用系统部署在K8S集群上，使用LTS统一采集和搜索日志的场景。用户的应用系统一般由多个工作负载组成，每个工作负载至少部署2个实例。 使用建议： 日志采集方式： 建议使用采集器ICAgent采集日志，您可以使用CCE接入配置日志采集路径。不建议使用SDK、API上报日志。使用ICAgent的好处是与应用系统完全解耦，无侵入，无需更改代码，使用SDK/API等方式步骤相对复杂，如果代码编写不当容易对应用系统的稳定性造成影响。 采集容器应用日志的方式有：容器标准输出、容器文件、节点文件、K8S事件，建议优先使用容器文件。对比容器标准输出，容器文件的优点是可以持久化挂载到主机上，且输出的内容用户自主控制性更强。对比节点文件，容器文件的优点是采集的日志有命名空间、工作负载、POD等元数据信息，在搜索日志的时候更加便捷。 日志组规划建议：将一个CCE集群的所有日志放在一个日志组中，日志组的别名（支持修改）可以使用CCE集群的名称，日志组的原始名称（不支持修改）建议使用k8s-log-{集群ID}。 日志流规划建议： 如果您的日志是没有固定规则的日志，可以将类似组件的日志采集到同一个日志流，例如java组件、php组件、python组件。类似组件的日志采集到一个日志流的好处是日志流的数量不至于太多而难以管理，如果您的组件数量比较少（例如小于20个），您可以将每个组件的日志采集到不同的日志流。 如果您的日志是类似NGINX网关这种可以结构化解析的日志，建议您将有相同格式的日志采集到同一个日志流。因为统一的日志格式才能方便您后续统一使用SQL分析功能，实现可视化图表分析。 权限隔离建议：云日志服务的日志流支持企业项目隔离，通过为日志流设定不同的企业项目可以实现不同IAM用户有不同日志流的访问权限。

云服务日志分析场景 如何采集云服务日志到LTS：LTS支持多种云服务接入采集到LTS，您需要在对应云服务的页面打开日志开关，即可以将日志采集到指定的日志组/日志流。 如何配置到最佳使用状态：很多云服务的日志都是支持结构化的，您可以在结构化配置页面为您的云服务日志配置对应的结构化解析规则，详细操作请参考日志结构化配置。结构化解析之后即可对日志使用SQL进行可视化分析。LTS也为很多常见的云服务日志提供了开箱即用的仪表盘，例如ELB/APIG/DCS等开箱即用仪表盘。

等保安全合规场景 场景描述：国家网络安全法要求上市公司、金融企业需要保存关键系统日志至少180天，用户可以将这些日志采集到LTS后统一存储。 使用建议： 日志采集方式： 云主机和容器日志，建议优先使用采集器ICAgent采集，使用ECS向导或者CCE向导。 云服务日志例如ELB/VPC日志，您可以在云服务界面打开开关将日志采集到LTS。 如果您的某些设备必须要以Syslog协议上报日志，您可以参考如何搭建Syslog服务器收集日志并采集到LTS。 日志存储方式： LTS默认支持用户存储365天，您可以修改日志存储时长。另外如果1年您觉得存储时长不够，可以提工单给LTS开通3年存储。 降低存储成本： 使用LTS在23年1130公测的冷存储特性，冷存储的日志存储单价比OBS仅贵25%，但是可以支持搜索，在易用性和成本上是最佳选择。 转储至OBS，优点是成本低，缺点是不支持搜索历史日志的内容，使用不便利。

应用监控告警场景 场景描述：适用于使用日志来实时监控应用系统是否正常，提前发现系统故障的场景。 使用建议： 告警统计方式：LTS有两种告警配置方式：关键词告警和SQL告警。如果您的日志是无规则的，那么适用关键词告警，例如java程序的运行日志；如果您的日志是有规则的，例如NGINX网关日志，那么适用SQL统计告警，您可以使用SQL语句对结构化的日志做统计分析，获取您想要的指标配置告警。 告警规则配置：告警触发一般需要越快越好，您的告警规则统计周期建议使用1分钟。您可以使用LTS提供的默认消息模板来发送告警。如果您有个性化的诉求，您可以在系统提供的默认模板的基础上做一些修改保存为消息模板，然后发送告警。 配置ELB/APIG等关键云服务日志告警：ELB经常用来作为应用系统的对外的入口，您可以打开ELB日志对接到LTS，然后配置ELB 5XX状态码告警，这样就可以及时发现系统是否有故障。同时您可以借助开箱即用的ELB仪表盘模板，观察应用系统整体的成功率。

云主机应用日志场景 场景描述：适用于用户将应用系统部署在云主机上，使用LTS统一采集和搜索日志的场景。用户的应用系统一般由多个组件（也称微服务）组成，每个组件部署在至少2台云主机上。 使用建议： 日志采集方式：建议使用采集器ICAgent采集日志，您需要在云主机上安装ICAgent，然后使用ECS接入配置日志采集路径。不建议使用SDK、API上报日志。使用ICAgent的好处是与应用系统完全解耦，无侵入，无需更改代码，使用SDK/API等方式步骤相对复杂，如果代码编写不当容易对应用系统的稳定性造成影响。 日志组规划建议：将一个应用系统的日志放在一个日志组中，日志组的名称可以使用应用系统的名称。 日志流规划建议： 如果您的日志是没有固定规则的日志，可以将类似组件的日志采集到同一个日志流，例如java组件、php组件、python组件。类似组件的日志采集到一个日志流的好处是日志流的数量不至于太多而难以管理，如果您的组件数量比较少（例如小于20个），您可以将每个组件的日志采集到不同的日志流。 如果您的日志是类似NGINX网关这种可以结构化解析的日志，建议您将有相同格式的日志采集到同一个日志流。因为统一的日志格式才能方便您后续统一使用SQL分析功能，实现可视化图表分析。 权限隔离建议：云日志服务的日志流支持企业项目隔离，通过为日志流设定不同的企业项目可以实现不同IAM用户有不同日志流的访问权限。

业务运营分析场景 场景描述：适用于在应用系统中打印业务日志，例如交易额、客户、产品等信息，然后使用LTS的SQL分析功能，输出可视化图表和仪表盘的场景。 使用建议： 日志采集方式：建议使用采集器ICAgent采集日志，将日志打印到单独的日志文件中，不要与应用程序的运行日志混在一起。不建议使用SDK、API上报日志。 日志结构化解析方式：建议您打印的业务日志使用空格分割或者JSON格式，这样方便快速配置日志结构化解析规则。 日志可视化呈现： 您可以创建自定义的仪表盘，使用类SQL语法分析已经结构化处理好的业务日志。自定义的仪表盘中，你可以添加多个图表，也可以添加过滤器，使用LTS做业务分析，可以减少采购数据仓库，没有额外成本，上手更简单。 日志加工：有些时候想要分析的业务日志混在运行日志中，或者业务日志中有些敏感数据需要删除，或者有些数据缺少维度数据，这个时候可以使用DSL加工（23年930开始邀测）功能对日志进行规整、富化、流转、脱敏、过滤等操作。

大数据组件日志采集场景 场景描述：有些用户会使用MRS/Flink/Spark等大数据组件做数据处理，希望采集自定义的日志到LTS，但是不希望采集大数据组件的运行日志（对于业务分析价值小）。 使用建议： 日志采集方式：推荐用户使用JAVA SDK或者GO SDK上报日志。常见的大数据组件不太方便指定个性化的日志文件路径去只打印自己的业务日志，因此使用SDK上报日志是比较好的选择。 日志结构化解析方式：LTS支持iOS SDK、Android SDK、百度小程序SDK、微信小程序SDK等端侧SDK，使用端侧SDK上报的日志不支持云端结构化解析，因此建议您上报已经结构化的JSON格式日志。

LTS日志使用冷存储保存后遇到问题怎么办？ 问题：标准存储日志如何转换成冷存储？ 答：当日志保存时间大于标准存储层数据保存时间，且小于日志存储时间时，数据将自动转换为智能冷存储层数据存储。 例如：日志存储时间是30天，标准存储层数据保存时间是10天，假设只有第一天有日志上报，那么到第11天时，第1天的日志会存储到冷存储中，到第12天时，第2天的日志会存储到冷存储中，以此类推。 图1 冷存储 问题：冷存储的日志是否能重新变成标准存储日志？ 答：不能，冷存储的日志不支持重新转为标准存储。 问题：标准存储的日志转换成冷存储的生效周期有多久？ 答：1个小时内。 问题：日志存储一段时间后，修改日志流的配置，设置日志冷存储，存量日志会自动转存到冷存储中吗？比如用户日志存储时间设置为30天，当前日志已经存储了10天，现在修改日志流配置，开启智能冷存储，标准存储层数据保存时间设置为7天，那超过7天的历史日志会存放到冷存储中吗？ 答：历史日志达到标准存储层数据保存时间了就会放入冷存储，如上问题，标准存储层数据保存时间为7天，现在日志已经存储了10天，那么前3天的日志就会存放到冷存储中。 父主题： 日志管理

Windows环境下安装ICAgent失败，并提示SERVICE STOP 现象：在Windows环境下安装ICAgent失败，提示SERVICE STOP。任务管理器中不存在ICAgent任务。系统服务列表中不存在ICAgent服务。命令行下执行sc query icagent提示未找到。 原因：一般为360安全卫士等杀毒软件拦截了icagent服务注册。 解决方法： 检查360安全卫士等杀毒软件是否正在运行。 关闭360安全卫士后再进行icagent安装。 Windows下ICAgent采集文件类型需要手动配置采集路径*.log、 *.trace、 *.out等文本文件，不支持二进制文件。

使用LTS SDK相关问题 本文介绍使用LTS SDK的常见问题和相关报错的处理方法。 端侧SDK日志接入LTS时需要注意什么？ 答：请用户在使用端侧SDK日志接入LTS时，建议提前做好一键关闭日志上报、逐步提升上报流量等措施，做到及时止损，如果您的移动端日志流量非常大，请提前知会LTS技术支持为您提前预留资源。 端侧SDK中的上报日志report接口和立即上报日志reportImmediately接口如何选择？ 答：建议使用上报日志report接口，通过调整上报策略，配置上报间隔、上报大小等参数。重要紧急的数据使用立即上报日志reportImmediately接口，即可进行立即上报。 端侧SDK上报的数据是放到labels参数还是contents参数？ 答：固定数据（例如用户ID、设备型号、渠道、系统、网络等）可以放到labels参数，方便进行维度分析；其他数据建议都放到contents参数，然后按需进行索引配置。 集成接入SDK包后对于客户App大小和性能有什么影响吗？ 答：iOS端App大小增加50KB左右，Android端App大小增加200KB左右，Web端大小可以忽略不计。在上传日志数据100条/每秒的情况下对性能没有影响。 iOS SDK和Android SDK支持哪些版本？ 答：iOS SDK支持iOS10及以上版本，Android SDK支持Android7及以上版本。如果需要支持更低版本，请提交工单申请开通。 按文档要求操作接入后，但在LTS控制台查询不到上报的日志数据？ 答：首先检查AK，SK，region，projectId这四个参数是否正确，更多信息请参考SDK接入。其次，在App控制台查看报错提示，详细请参考错误码。最后，请检查端侧权限是否已开通LTS白名单，若有需要，请提交工单申请开通。 App控制台上报日志失败，报错提示接口403？ 答：在云日志服务控制台查看日志流是否开启了匿名上报。详细请参考日志流章节中如何开启匿名写入。 集成接入SDK的时候提示SDK初始化失败。 答：可以先开启debug模式，每个参数都会打印，根据提示可以定位到初始化失败的原因。 端侧上报一条日志长度和大小限制。 答：一条日志长度是30720个字符，超过该长度的内容会被删除，只截取30*1024长度的内容，然后以字符串方式上报LTS。上报日志的大小限制为1MB。 端侧SDK日志的上报策略是什么样的？ 答：端侧SDK日志有时间和空间维度的自定义上报策略，上报间隔默认3s，上报条数默认200条，哪个先触发就先上报。 端侧SDK日志发送是异步发送还是同步发送？ 答：端侧SDK日志发送是异步发送。 LTS能支持多大的端侧SDK并发量？ 答：端侧SDK并发量与资源容量大小有关，理论上来说只要LTS资源足够，并发量不是问题。若需要支持更多端侧SDK并发量，请提交工单申请开通。 父主题： SDK接入

如何获取AK/SK？ AK/SK（Access Key ID/Secret Access Key）即访问密钥，表示一组密钥对。请参考如何获取访问密钥AK/SK获取AK和SK。 AK：访问密钥ID，是与私有访问密钥关联的唯一标识符。访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 请获取并使用公共用户账号的AK/SK，请勿使用个人账号的AK/SK。 父主题： 主机管理

如何从第三方云厂商将日志搬迁到华为云LTS? 若用户是在第三方云厂商使用日志服务，有大量数据在第三方云厂商对象存储上，希望将日志搬迁到华为云，对于不同的日志类型，请参考如下方法： 热日志（搜索分析）：典型保存7-14天，用于应用运维，该日志不需要搬迁到华为云。用户在华为云直接启用云日志服务LTS，运行14天后，第三方云厂商保存的日志自然就老化了。详细请参考开始使用云日志服务。 归档日志（等保合规）：典型保存180天以上，用于安全合规审计，该日志一般转储存放到对象存储中。使用对象存储的迁移工具，将第三方云厂商保存在对象存储中的文件迁移到华为云对象存储服务OBS即可。详细操作请参考迁移第三方云厂商数据至OBS。 父主题： 产品咨询问题

常见问题及解决方法 查询日志时提示查询结果不精确。 可能原因：查询时间范围内总日志量过多，当前控制台显示的是查询时间范围内部分日志查询的结果，为不精确结果。 解决方法：建议多次单击查询按钮，直至获得精确结果。或者减小查询时间范围后，再进行查询。 查询日志时匹配到的日志结果过多。 可能原因：只有短语搜索#"value"才能保证关键词出现的顺序。例如查询语句abc def搜索的是同时包含abc和def的日志，无法准确匹配包含短语abc def的日志。 解决方法：推荐采用短语搜索#"abc def"，可以准确匹配包含短语abc def的日志。请参考短语搜索。 部分搜索语句查询不到预期的日志，且无报错提示。 可能原因1：不支持搜索分词符。 可能原因2：短语搜索语句中包含*或?时，视为普通字符，不作为通配符使用。 解决方法：请参考搜索语法修改为正确的查询语句。

操作步骤 若是ECS接入时，安装ICAgent完成后在主机页面不显示。 在安装ICAgent页面确认安装命令复制正确，不能使用跨region的安装命令。 检查已获取的AK/SK是否正确，且AK/SK没有被删除。 执行“netstat -nap | grep icagent”命令查看主机网络是否正常。 若是CCE接入时，安装ICAgent完成后在主机页面不显示。 确保CCE集群已安装ICAgent并且已创建相关节点自定义标识的主机组，若没有安装ICAgent，请到主机管理页面进行升级。详细操作请参考升级ICAgent。 在Windows环境安装ICAgent失败。 确保使用administrator账户安装。 检查已获取的AK/SK是否正确，且AK/SK没有被删除。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 文件内容Hash, 即存证指纹 charge_type String 存证类型, normal:普通存证 create_time String 创建时间 tx_id String 交易ID block_hash String 区块哈希 block_height Integer 区块高度 user_addr String 用户地址，基于用户证书生成的公钥 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tx_id String 交易ID, 64位哈希值 最小长度：64 最大长度：64 ev_id String 存证ID 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

URI GET /v1/{project_id}/evidences 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid，一般为32位字符串 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页，每页大小,分页大小只支持10、20、50/页，默认显示10条/页 最小值：10 最大值：50 offset 否 Integer 偏移量，从第几项开始,默认值为0 最小值：0 最大值：65535 name 否 String 按照存证名称字段搜索，不支持模糊匹配 最小长度：4 最大长度：765 charge_type 否 String 按照存证类型，精确匹配 最小长度：4 最大长度：64 begin_time 是 String 按照时间范围搜索，起始时间 （UTC时间，毫秒级)，和end_time配合使用。最大时间不超过30天。 最小长度：13 最大长度：16 end_time 是 String 按照时间范围搜索，截止时间 （UTC时间，毫秒级)，和begin_time配合使用。最大时间不超过30天 最小长度：13 最大长度：16

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total_count Integer 总记录 evidences Array of Evidence objects 存证信息列表 表4 Evidence 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 存证指纹 charge_type String 存证类型, normal:普通存证 create_time String 创建时间 tx_id String 交易ID 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tx_id String 交易ID, 64位哈希值 最小长度：64 最大长度：64 ev_id String 存证ID 最小长度：0 最大长度：64 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

URI GET /v1/{project_id}/evidences/trend 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid，一般为32位字符串 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 charge_type 是 String 存证类型， 取值normal，表示普通存证 最小长度：1 最大长度：64 time_mode 是 String 时间模式，取值支持hour;day;week;month。hour返回30个点,粒度为2分钟；day返回24个点，粒度为1小时；week返回个28点，粒度为6小时；month返回30个点，粒度为1天； 最小长度：3 最大长度：16