macOS 应用接入¶
观测云应用监测能够通过收集各个 macOS 应用的指标数据,以可视化的方式分析各个 macOS 应用端的性能。
阅读路径¶
- 首次接入:先看 快速开始
- 完整接入:继续阅读本文
- 初始化参数:查看 SDK 初始化、RUM 配置、Log 配置、Trace 配置
- 自定义能力:查看 自定义标签使用、数据采集自定义规则
- 数据模型:查看 应用数据采集
- 问题排查:查看 故障排查
前置条件¶
注意
若已开通 RUM Headless 服务,前置条件已自动配置,可直接接入应用。
应用接入¶
- 进入用户访问监测 > 新建应用 > macOS;
- 输入应用名称;
- 输入应用 ID;
-
选择应用接入方式:
- 公网 DataWay:直接接收 RUM 数据,无需安装 DataKit 采集器。
- 本地环境部署:满足前置条件后接收 RUM 数据。
安装¶
源码地址:https://github.com/GuanceCloud/datakit-macos
Demo:https://github.com/GuanceCloud/datakit-macos/Example
1.配置 Podfile 文件。
2.在 Podfile 目录下执行 pod install 安装 SDK。
1.选中 PROJECT -> Package Dependency ,点击 Packages 栏目下的 +。
2.在弹出的页面的搜索框中输入 https://github.com/GuanceCloud/datakit-macos,这是代码的存储位置。
3.Xcode 获取软件包成功后,会展示 SDK 的配置页。
Dependency Rule :建议选择 Up to Next Major Version 。
Add To Project :选择支持的工程。
填好配置后点击 Add Package 按钮,等待加载完成。
4.在弹窗 Choose Package Products for datakit-macos 中选择需要添加 SDK 的 Target,点击 Add Package 按钮,此时 SDK 已经添加成功。
如果您的项目由 SPM 管理,将 FTMacOSSDK 添加为依赖项,添加 dependencies 到 Package.swift。
```swift dependencies: [
.package(url: "https://github.com/GuanceCloud/datakit-macos.git", .upToNextMajor(from: "[latest_version]")) ] ```
添加头文件¶
详细配置入口¶
高级场景¶
常见问题¶
关于崩溃日志分析¶
崩溃日志分析和 dSYM 说明请查看 故障排查。
出现 Include of non-modular header inside framework module 报错¶
因为 SDK 的 .h 文件中引⼊了依赖库的 .h 文件,所以需要设置
Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES 设置为 YES.