Android平臺集成華為AGC性能管理服務問題處理指南

最近嘗試集成了華為AGC的性能管理服務，集成過程中也遇到一些問題。本文就對我在集成性能管理服務的踩坑記錄進行總結(jié)，希望能幫到大家。

問題一：剛集成性能管理服務，報錯miss client id

具體的錯誤提示如下：

I/com.huawei.agc.apms: failed to fetch remote config: client token request miss client id, please check whether the 'agconnect-services.json' is configured correctly

問題解決：

在相關(guān)論壇查詢發(fā)現(xiàn)，是由于沒有添加agcp插件導致的問題，參考鏈接。

需要在應用級gradle文件中，按照文檔添加如下代碼：

apply plugin: 'com.huawei.agconnect'

問題二：如何查看端側(cè)性能管理的上報日志

剛集成性能管理的時候，在ACG管理臺的性能管理界面，沒有我們應用的性能數(shù)據(jù)，想配合端側(cè)的logcat日志來定位該問題。

但是不知道如何打開端側(cè)的性能管理相關(guān)日志

問題解決

在性能管理的資料文檔中，有描述到如何打開性能管理的調(diào)試日志，文檔鏈接：

https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-viewlog

具體操作如下：

打開應用的AndroidManifest.xml文件中，在application標簽中添加<meta-data>元素

<application> 

    <meta-data

      android:name="apms_debug_log_enabled"

      android:value=" true" />

</application>

打開以后，可以再logcat過濾功能“com.huawei.agc.apms”或者”apms”來查看日志：

需要關(guān)注：其中的resultCode為200時，才代表數(shù)據(jù)上傳成功。

I/HiAnalyticsSDK: SendMission=> events PostRequest sendevent TYPE : oper, TAG : APMS, resultCode: 200 ,reqID:b639daae0490c378cf242544916a9c36

問題三：logcat里面一直沒有apms上傳成功的日志。

已經(jīng)添加<meta-data>并且修改為了true，在logcat中可以看到contains和sending日志，但是一直沒有上面說的上傳成功的日志

問題解決

檢查發(fā)現(xiàn)，我的agconnect-services.json文件，是在開通性能管理服務前下載的。開通性能管理服務以后，需要更新json文件

開通服務前，json文件只有29行。開通性能服務，json增加了參數(shù)，已經(jīng)52行了。

更新完json文件以后，數(shù)據(jù)就有數(shù)據(jù)上報的日志了。

問題四：已有相關(guān)日志，但agc界面還是沒有性能數(shù)據(jù)。

定位沒有性能數(shù)據(jù)的時候，發(fā)現(xiàn)已經(jīng)有resultCode為200的數(shù)據(jù)，但是在AGC控制臺上，還是沒有性能數(shù)據(jù)。

相關(guān)的日志如下：

I/HiAnalyticsSDK: hmsSdk=> events PostRequest sendevent TYPE : maint, TAG : _hms_config_tag, resultCode: 200 ,reqID:842927417075465ab9ad990e2ce92646

問題解決

仔細發(fā)現(xiàn)，上述日志中，resultCode: 200的這一段日志，其TAG并不是APMS，那他肯肯定就不是apms數(shù)據(jù)上傳成功的日志。

深入分析日志發(fā)現(xiàn)，存在部分鑒權(quán)失敗的日志

E/HiAnalyticsSDK: HttpTransportCommander=> NE-004|IO Exception.timeout

D/HiAnalyticsSDK: HttpTransportCommander=> request times: 1

I/HiAnalyticsSDK: getPubKey=> result code : -102

然后聯(lián)系華為技術(shù)支持，得到答復是，性能管理所使用的HiAnalyticsSDK上報通道，存在鑒權(quán)問題。

需要手動去AGC界面–我的項目–華為分析-項目概覽 里面開通分析服務，開通分析服務一段時間后，就能鑒權(quán)通過，該問題就自行解決啦。

問題五：沒有相關(guān)的網(wǎng)絡數(shù)據(jù)。

其他性能數(shù)據(jù)都正常使用，但是在界面上沒有網(wǎng)絡請求的數(shù)據(jù)。

問題解決

查看AGC官方資料發(fā)現(xiàn)，性能管理的網(wǎng)絡請求數(shù)據(jù)，依賴APM插件，需要正確集成APM插件才能有網(wǎng)絡數(shù)據(jù)。

集成步驟：

1、在項目級的gradle文件中，在dependencies路徑下，添加如下代碼：

classpath 'com.huawei.agconnect:agconnect-apms-plugin:1.4.1.305'

2、在應用級的gradle文件中，添加如下代碼

apply plugin: 'com.huawei.agconnect.apms'

參考文檔

華為AGC性能管理服務官方文檔：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-agcsdk

性能管理服務Android Codelab：https://developer.huawei.com/consumer/cn/codelabsPortal/carddetails/AppGalleryConnectAPM