Application Real-Time Monitoring Service:Surveiller les applications iOS

Définir l'endpoint

Définit l'endpoint de votre application. Appelez cette méthode avant start.

@objc
public static func setEndpoint(_ endpoint: String)

Définir le workspace

Définit le workspace de votre application. Appelez cette méthode avant start.

@objc
public static func setWorkspace(_ workspace: String)

Démarrer le SDK

Initialise le SDK avec l'ID de service spécifié.

@objc(start:)
public static func start(_ serviceId: String)

Définir un ID d'appareil personnalisé

Définit un ID d'appareil personnalisé qui remplace celui obtenu automatiquement.

@objc
public static func setDeviceID(_ deviceID: String)

Définir une version d'application personnalisée

Définit une version d'application personnalisée que le SDK signale au lieu de celle détectée automatiquement.

@objc
public static func setAppVersion(_ appVersion: String)

Définir le canal de l'application

Définit un ID de canal pour identifier le canal de distribution de votre application.

@objc
public static func setChannelID(_ channelID: String)

Exclure des classes spécifiques

Ajoute un nom de classe à l'ensemble d'exclusion du swizzle afin que les classes correspondantes ignorent l'instrumentation automatique. Utilisez cette méthode pour exclure les classes que vous ne souhaitez pas surveiller ou qui causent des problèmes de compatibilité. Vous pouvez appeler cette méthode plusieurs fois. Le SDK utilise la correspondance de sous-chaîne pour l'exclusion des noms de classe.

// Exclude all classes containing StoreKit2ViewController
[AlibabaCloudRUM excludeClassFromTracking:@"StoreKit2ViewController"];
// Exclude all classes containing BTDemoStoreKit2MixedBridge
[AlibabaCloudRUM excludeClassFromTracking:@"BTDemoStoreKit2MixedBridge"];

Activer ou désactiver des modules

Active ou désactive des modules de collecte de données spécifiques. Les configurations locales ont priorité sur les configurations distantes. Les appels multiples s'accumulent.

@objc(disableModule:)
public static func disableModule(_ module: AlibabaCloudModule)

@objc(enableModule:)
public static func enableModule(_ module: AlibabaCloudModule)

@objc(AlibabaCloudModule)
public enum AlibabaCloudModule: Int {
    case crash        = 0
    case network      = 1
    case view         = 2
    case action       = 3
    case webView      = 4
    case longTask     = 5
    case appLaunch    = 6
    case appState     = 7
    case netState     = 8
    case customEvent  = 9
    case customLog    = 10
    case customMetric = 11
}

Exemple :

// Disable the network data collection module
[AlibabaCloudRUM disableModule:AlibabaCloudModuleNetwork];

Définir l'environnement de l'application

Spécifie l'environnement de l'application, tel que LOCAL, DAILY ou PROD.

@objc
public static func setEnvironment(_ env: Env)

Collecte d'instantanés de ressources

Collecte les en-têtes et les informations de payload des requêtes et réponses HTTP. Par défaut, la collecte d'instantanés de ressources est désactivée. Vous devez l'activer explicitement.

Active la collecte d'instantanés de ressources pour la bibliothèque HttpClient en définissant un ResourceSnapshotProvider.

void setResourceSnapshotProvider(ResourceSnapshotProvider? provider)

Définir le nom d'utilisateur

Définit un nom d'utilisateur pour associer les données de surveillance aux utilisateurs réels.

@objc
public static func setUserName(_ userID: String)

Définir des informations supplémentaires utilisateur personnalisées

Définit des informations utilisateur supplémentaires pour enrichir l'analyse des données au niveau utilisateur.

@objc(setUserExtraInfo:)
public static func setUserExtraInfo(_ extraInfo: [String: AnyObject])

Définir des propriétés globales

Définit des propriétés métier globales personnalisées. Une fois définies, toutes les nouvelles données héritent automatiquement de ces propriétés, permettant une corrélation entre les données de surveillance et les attributs métier.

@objc(setExtraInfo:)
public static func setExtraInfo(_ extraInfo: [String: AnyObject])

@objc(addExtraInfo:)
public static func addExtraInfo(_ extraInfo: [String: AnyObject])

Signaler des exceptions personnalisées

Signale des données d'exception personnalisées pour l'analyse statistique.

@objc(setCustomException:causeBy:errorDump:)
public static func setCustomException(_ exceptionType: String, causeBy: String, errorDump: String)

Signaler des événements personnalisés

Signale des données d'événements personnalisés pour l'analyse statistique.

Plusieurs versions surchargées sont disponibles pour différents besoins de rapport :

Signaler des journaux personnalisés

Signale des informations de journal personnalisées pour l'analyse statistique.

Signaler des ressources personnalisées

Signale des données de requête de ressource réseau personnalisées, y compris l'état de la requête, les métriques de performance et les informations de suivi de trace. Deux versions surchargées sont disponibles pour les scénarios de base et avancés.

@objc(setCustomResource:success:url:method:statusCode:errorMessage:)
public static func setCustomResource(_ type: String, success: Bool, url: String, method: String, statusCode: Int, errorMessage: String?) -> Bool

// Swift - Successful GET request
let result = AlibabaCloudRUM.setCustomResource(
    "API",
    success: true,
    url: "https://api.example.com/users",
    method: "GET",
    statusCode: 200,
    errorMessage: nil
)

// Swift - Failed POST request
let result2 = AlibabaCloudRUM.setCustomResource(
    "API",
    success: false,
    url: "https://api.example.com/login",
    method: "POST",
    statusCode: 401,
    errorMessage: "Unauthorized access"
)

// Objective-C - Successful GET request
BOOL result = [AlibabaCloudRUM setCustomResource:@"API"
                                         success:YES
                                             url:@"https://api.example.com/users"
                                          method:@"GET"
                                      statusCode:200
                                    errorMessage:nil];

// Objective-C - Failed POST request
BOOL result2 = [AlibabaCloudRUM setCustomResource:@"API"
                                          success:NO
                                              url:@"https://api.example.com/login"
                                           method:@"POST"
                                       statusCode:401
                                     errorMessage:@"Unauthorized access"];

@objc(setCustomResource:success:url:method:statusCode:errorMessage:provider:tracing:measure:)
public static func setCustomResource(_ type: String, success: Bool, url: String, method: String, statusCode: Int, errorMessage: String?, provider: String?, tracing: AlibabaCloudTracingContext?, measure: AlibabaCloudResourceMeasure?) -> Bool