SDK 日志

SDK 的日志使用 slf4j 接口，可以支持logback和log4j的日志。所在的package为：com.datarangers，需要需要查看日志，请配置该package日志路径。另外也可以查看console下该package下的日志。
首先确定是否有ERROR 日志，以及检查启动参数配置是否符合预期。

使用SDK上报事件，但是在finder系统中查询不到数据

按以下路径进行检查:

1. 先检查 “使用方法” > "验证配置" 提供的 curl 命令验证基本配置。
2. 检查 SDK 的版本，最后使用最新版本；检查配置 save 或者mode，确定上报是什么模式。当使用 FILE 上报模式的时候，数据只是保存到本地，不会上报。
3. 查看日志是否有错误。
4. 检查上报的事件名称是否符合规范，事件的local_time_ms是否正常。如果local_time_ms是一个未来的数据、或者是一个太老的数据（超过7天），就会被丢弃。
5. 可以在 “数据管理” > “数据质量”，查看是否有异常的数据。
6. 等5分钟，刷新页面，查看元数据是否存在。当元数据存在的时候，再去行为细查或者事件分析中去查询。
7. 联系客户经理。

事件上报成功，但是在finder行为细查中查看事件属性不存在

按以下路径进行检查：

1. 在“数据管理”>“事件属性”中查看事件属性是否存在，以及属性类型是否符合预期。
2. 在“数据管理”>“数据质量”中查看上报事件中是否存在“异常属性条数”。
3. 在“数据管理”>“事件属性”查看该事件属性是事件属性、还是事件公共属性。
4. 如果该属性在“any_event”事件下面，则是事件公共属性，否则是事件属性。
5. 事件公共属性上报的时候是是放在header的custom字段下，即接口的custom参数。
6. 事件属性是放在params下。

SDK 调试

SDK 的发送的核心逻辑在 com.datarangers.asynccollector.Consumer #run()，HTTP 发送的逻辑，最终使用 com.datarangers.util.HttpUtils #request进行发送。可以在相关地方进行debug 调试，进一步定位问题。

SSL 证书配置

• 证书错误：PKIX path building failed: sun.security.provider.certpath

这个错误是由于本地 JDK 没有信任证书，建议客户优先导入证书，
或者配置：datarangers.sdk.httpConfig.trustDisable=true。

• 自定义证书路径配置

如果客户的证书位置不在默认位置，需要自定义，可以配置相关参数：

# 开启证书路径自定义配置
datarangers.sdk.httpConfig.customKeyTrustEnable=true

# 配置keyMaterial路径
datarangers.httpConfig.keyMaterialPath={keyMaterialPath}
# 配置keyPassword
datarangers.httpConfig.keyPassword={keyPassword}
# 配置storePassword
datarangers.httpConfig.storePassword={storePassword}
# 配置trustMaterial路径
datarangers.httpConfig.trustMaterialPath={trustMaterialPath}

# 信任策略，只支持self,all 两种
datarangers.httpConfig.trustStrategy=self