• Server
• Android
• iOS

• 输出「用户访问监测」数据，覆盖 Session View，Action，LongTask，Error，同时提供 Native View 原生页面和 Webview 的数据
• 输出「日志」数据
• 输出 「应用性能监测」数据
• 提供 SourceMap 崩溃日志符号还原

• Datakit 安装

• 配置 Datakit/ddtrace

• 准备 Demo 访问文件

   |-- app.py 						//配置 Demo App 所需 http 访问地址
   |-- static						//静态文件：js 及 图片文件
   	|-- dataflux-rum.js			//观测云 Web js SDK 
   	|-- images
   		|-- logo.png			//Webview 显示图标
   		|-- demo-logo.png		//移动端“我的”页面头像显示
   	|-- jquery.mini.js			// jquery js
   	|-- qrcode.mini.js			// 二维码处理
   |-- templates					
   	|--index.html				//Demo App 访问的 Webview html
   	|--import_helper.html		//GuanceDemo 快捷导入配置使用
   |-- update_input_value.py		//更新 import_helper.html 显示 datakit 和 Demo API 地址使用
   
  

• 替换 import_helper.html 显示地址

  • 脚本替换 (需要 python3 安装 beautifulsoup4)

   python3 update_input_value.py demo-api-address-input  $DEMO_API_DRESS templates/import_helper.html
   python3 update_input_value.py datakit-address-input  $DATAKIT_ADDRESS templates/import_helper.html

  • 手动替换 import_helper.html 对应 datakit-address-input ,demo-api-address-input

  变量	含义
  datakit-address-input	import_helper.html 中 Datakit Address 输入框 id
  demo-api-address-input	import_helper.html 中 Demo API Address 输入框 id
  DATAKIT_ADDRESS	datakit 数据接入地址，例子：http://10.0.0.1:9529
  DEMO_API_DRESS	demo api 请求地址, 例子：http://10.0.0.1:8000

• 启动 Demo 访问后端服务

   DD_SERVICE=GC_SERVICE_SDK_DEMO \                   
   DD_SERVICE_MAPPING=postgres:postgresql,defaultdb:postgresql \
   DD_TAGS=project:sdk_demo,env:test,version:1.0 \
   DD_AGENT_HOST=localhost \
   DD_AGENT_PORT=9529 \
   ddtrace-run python3 app.py &> demo.log &

变量含义请查询 Datakit ddtrace Python 部署环境变量

sourcemap 是用于 app 崩溃数据符号还原使用。

• Datakit 安装 sourcemap 工具
• 下载最新 sourcemap

|-- demo_source_map.zip
	|-- gc_app_android_demo-prod-1.0.0.zip       //Android sourceMap
	|-- gc_app_ios-demo-prod-1.0.0.zip			    //iOS sourceMap

sourcemap 上传有两种方式， curl 或者手动放置，手动放置需要 datakit 部署机器的访问权限

CURL 命令上传需要替换一下 <dca_address> 地址 ，这里是官方文档

#  demo_source_map 文件夹下执行

# Android 
curl -X POST '<dca_address>/v1/rum/sourcemap?app_id=gc_app_android_demo&env=prod&version=1.0.0&platform=android' -F "file=@gc_app_android_demo-prod-1.0.0.zip" -H "Content-Type: multipart/form-data"

# iOS
curl -X POST '<dca_address>/v1/rum/sourcemap?app_id=gc_app_ios-demo&env=prod&version=1.0.0&platform=ios' -F "file=@gc_app_ios-demo-prod-1.0.0.zip" -H "Content-Type: multipart/form-data"

//Android SourceMap 路径
/usr/local/datakit/data/rum/android

//iOS SourceMap 路径
/usr/local/datakit/data/rum/ios

• Android: Demo 下载地址
• iOS:
  • 内部人员需提交内测申请
  • 外部人员需自行源码打包安装

GuanceDemo Datakit 地址和 Demo api 地址可以随意变更，第一次使用必须要先进行 「编辑 Demo 配置」

密码默认自动填充，用户名 guance 密码 admin

「登录页面」 > 「编辑 Demo 配置」，输入对应该 datakit 地址和 demo api 地址后并保存配置，配置保存成功需要重启，iOS 需要自行后台杀进程。

服务端部署完毕后，可以通过访问 http://{demo_api_url}/improt_helper 页面，进行快速配置导入。配置可以通过桌面端访问 improt_helper 页，然后用手机扫码获取，又或者从手机上访问 improt_helper 页，点击“复制文本”获取配置。

在「编辑 Demo 」配置页面，你可以对 App 访问进行“地址检测”，你可以在「登录页面」和主界面的「我的」页面找到「编辑 Demo 配置」的入口。