全部產品
Search
文件中心

Simple Log Service:接入iOS使用者體驗監控資料

更新時間:Oct 25, 2024

本文介紹如何接入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及其內部資料的URL,Log Service提供私網網域名稱和公網網域名稱。更多資訊,請參見服務入口

cn-hangzhou.log.aliyuncs.com

${project}

Log ServiceProject名稱,更多資訊,請參見管理Project

test-project

${instance}

全棧可觀測服務執行個體ID。更多資訊,請參見建立執行個體

test-traces

${access-key-id}

AccessKey ID用於標識使用者,更多資訊,請參見存取金鑰

建議您遵循最小化原則,按需授予RAM使用者必要的許可權。關於授權的具體操作,請參見建立RAM使用者及授權RAM自訂授權樣本

${access-key-secret}

AccessKey Secret是使用者用於加密簽名字串和Log Service用來驗證簽名字串的密鑰,必須保密。

${access-key-token}

AccessKey Token,僅當AccessKey是通過STS方式擷取時才需要。