Configurazione avanzata per Engagement SDK per app universali di WindowsAdvanced Configuration for Windows Universal Apps Engagement SDK

Questa procedura descrive come configurare le diverse opzioni di configurazione per le app Android di Azure Mobile Engagement.This procedure describes how to configure various configuration options for Azure Mobile Engagement Android apps.

PrerequisitiPrerequisites

Per completare questa esercitazione, è necessario disporre di:This tutorial requires the following:

Nota

Per completare l'esercitazione, è necessario disporre di un account Azure attivo.To complete this tutorial, you must have an active Azure account. Se non si dispone di un account, è possibile creare un account di valutazione gratuita in pochi minuti.If you don't have an account, you can create a free trial account in just a couple of minutes. Per informazioni dettagliate, vedere la pagina relativa alla versione di valutazione gratuita di Azure.For details, see Azure Free Trial.

Configurazione avanzataAdvanced configuration

Disabilitare la segnalazione automatica degli arresti anomaliDisable automatic crash reporting

È possibile disabilitare la funzionalità di segnalazione automatica degli arresti anomali di Engagement.You can disable the automatic crash reporting feature of Engagement. Quando si verifica un'eccezione non gestita, Engagement non eseguirà alcuna azione.Then, when an unhandled exception occurs, Engagement does nothing.

Avviso

Se si disabilita questa funzionalità, quando si verifica un arresto anomalo non gestito nell'app, Engagement non lo invierà E non chiuderà la sessione e i processi.If you disable this feature, then when an unhandled crash occurs in your app, Engagement does not send the crash AND does not close the session and jobs.

Per disabilitare la segnalazione automatica degli arresti anomali, personalizzare la configurazione in base al modo in cui che è stata dichiarata:To disable automatic crash reporting, customize your configuration depending on the way you declared it:

Dal file EngagementConfiguration.xmlFrom EngagementConfiguration.xml file

Impostare la segnalazione degli arresti anomali su false tra i tag <reportCrash> e </reportCrash>.Set report crash to false between <reportCrash> and </reportCrash> tags.

Dall'oggetto EngagementConfiguration in fase di esecuzioneFrom EngagementConfiguration object at run time

Impostare la segnalazione degli arresti anomali su false usando l'oggetto EngagementConfiguration.Set report crash to false using your EngagementConfiguration object.

    /* Engagement configuration. */
    EngagementConfiguration engagementConfiguration = new EngagementConfiguration();
    engagementConfiguration.Agent.ConnectionString = "Endpoint={appCollection}.{domain};AppId={appId};SdkKey={sdkKey}";

    /* Disable Engagement crash reporting. */
    engagementConfiguration.Agent.ReportCrash = false;

Disabilitare la segnalazione in tempo realeDisable real time reporting

Per impostazione predefinita, il servizio Engagement segnala i log in tempo reale.By default, the Engagement service reports logs in real time. Se l'applicazione segnala spesso i log, è preferibile memorizzare i log nel buffer e segnalarli tutti insieme con cadenza regolare,If your application reports logs frequently, it is better to buffer the logs and to report them all at once on a regular time basis. la cosiddetta "modalità burst".This is called “burst mode”.

A tale scopo, chiamare il metodo:To do so, call the method:

    EngagementAgent.Instance.SetBurstThreshold(int everyMs);

L'argomento è un valore in millisecondi.The argument is a value in milliseconds. Ogni volta che si vuole riattivare la registrazione in tempo reale, chiamare il metodo senza alcun parametro o con il valore 0.Whenever you want to reactivate the real-time logging, call the method without any parameter, or with the 0 value.

La modalità burst aumenta lievemente la durata della batteria ma ha un impatto su Monitor di Engagement: la durata di tutte le sessioni e di tutti i processi viene arrotondata alla soglia di burst e, di conseguenza, le sessioni e i processi inferiori alla soglia di burst potrebbero non essere visibili.Burst mode slightly increases the battery life but has an impact on the Engagement Monitor: all sessions and jobs duration are rounded to the burst threshold (thus, sessions and jobs shorter than the burst threshold may not be visible). È consigliabile usare una soglia di burst non maggiore di 30000, ovvero 30 secondi.We recommend using a burst threshold no longer than 30000 (30s). Per i log salvati è previsto un limite di 300 elementi.Saved logs are limited to 300 items. Se l'invio richiede troppo tempo, è possibile che alcuni log vadano persi.If sending is too long, you can lose some logs.

Avviso

La soglia di burst non può essere configurata per un periodo inferiore a un secondo.The burst threshold cannot be configured to a period less than one second. Se si imposta un valore minore, l'SDK mostrerà una traccia con l'errore e verrà reimpostato automaticamente sul valore predefinito, vale a dire, zero secondi.If you do so, the SDK shows a trace with the error and automatically resets to the default value, zero seconds. In questo modo si attiva l'SDK per la segnalazione dei log in tempo reale.This triggers the SDK to report the logs in real-time.