文档

接入iOS用户体验监控数据

更新时间:

本文介绍如何接入iOS用户体验监控数据到全栈可观测应用。

前提条件

已创建全栈可观测实例(推荐)或Trace实例。具体操作,请参见创建全栈可观测实例创建Trace实例

重要
  • 全栈可观测实例需为2.1.0及以上版本。您可以在实例列表中查看版本信息。

  • 本文以全栈可观测应用为例,即下文中的实例均为全栈可观测实例。

步骤一:SDK集成

在项目文件夹中,创建Podfile文件,并在Podfile中配置以下内容。

#指定source。
source 'https://gitee.com/aliyun-sls/Specs.git'

# 引入以下Pods。
pod 'AliyunLogProducer', '4.0.0'
pod 'AliyunLogOTelCommon', '4.0.0'
pod 'AliyunLogOtlpExporter', '4.0.0'
pod 'AliyunLogCrashReporter', '4.0.0'

步骤二:初始化SDK

参考如下代码,初始化SDK。

    [ConfigurationManager.shared setProviderWithAccessKeyProvider:^AccessKey * _Nullable(NSString * _Nonnull scope) {
        return [AccessKey initWithAccessKeyId:@"${access-key-id}"
                              accessKeySecret:@"${access-key-secret}"
                        accessKeySecuritToken:@"${access-key-token}"
        ];
    } workspaceProvider:^Workspace * _Nullable(NSString * _Nonnull scope) {
        return [Workspace initWithEndpoint:@"https://${endpoint}"
                                   project:@"${project}"
                                instanceId:@"${instanceId}"
        ];
    } environmentProvider:^Environment * _Nullable(NSString * _Nonnull scope) {
        // 设置环境信息。
        return [Environment initWithEnv:@"default" // 默认为default。一般情况下,建议debug版本设置为dev,release版本设置为pub。
                                    uid:@"123456780" // 设置用户ID,可选。
                                  utdid:@"" // 设置设备ID,可选。传入无效值时,SDK会自动生成utdid。
                                channel:@"" // 设置渠道信息,可选。
               ];
    }];

    // 一般情况下,建议debug版本设置为YES,release版本设置为NO。
    BOOL debuggable = NO;
    [[CrashReporter shared] initWithDebuggable:debuggable];

变量说明

变量

说明

示例

${endpoint}

日志服务Project的接入地址,格式为${region-endpoint},支持公网和阿里云内网(经典网络、VPC)。更多信息,请参见服务入口

cn-hangzhou.log.aliyuncs.com

${project}

日志服务Project名称。

test-project

${instance}

全栈可观测服务实例ID。更多信息,请参见创建实例

test-traces

${access-key-id}

阿里云账号AccessKey ID。

建议您使用只具备日志服务Project写入权限的RAM用户的AccessKey(包括AccessKey ID和AccessKey Secret)。授予RAM用户向指定Project写入数据权限的具体操作,请参见授权。如何获取AccessKey的具体操作,请参见访问密钥

${access-key-secret}

阿里云账号AccessKey Secret。

建议您使用只具备日志服务Project写入权限的RAM用户的AccessKey。

${access-key-token}

阿里云账号AccessKey Token。

仅当AccessKey是通过STS方式获取时才需要。