I parametri personalizzati e i parametri estesi che puoi inviare a CloudWatch e CloudWatch Evidently - Amazon CloudWatch
Parametri personalizzatiParametri estesi

I parametri personalizzati e i parametri estesi che puoi inviare a CloudWatch e CloudWatch Evidently

Per impostazione predefinita, i monitor dell'app RUM inviano i parametri a CloudWatch. Queste dimensioni e metriche predefinite sono elencati in Parametri di CloudWatch che puoi raccogliere con CloudWatch RUM.

Inoltre, puoi impostare un monitor dell'app per esportare la metrica. Il monitor dell'app può inviare metriche estese, personalizzate o entrambe. Può inviarle a CloudWatch, a CloudWatch Evidently o a entrambi.

  • Parametri personalizzati: i parametri personalizzati sono parametri da te definiti. Con i parametri personalizzati, puoi utilizzare qualsiasi nome e spazio dei nomi del parametro. Per derivare i parametri, puoi utilizzare qualsiasi evento personalizzato, evento integrato, attributo personalizzato o attributo predefinito.

    Puoi inviare i parametri personalizzati sia a CloudWatch che a CloudWatch Evidently

  • Parametri estesi: consente di inviare i parametri RUM di CloudWatch predefiniti a CloudWatch Evidently per utilizzarli negli esperimenti di CloudWatch Evidently. Puoi inviare i parametri RUM predefiniti di CloudWatch a CloudWatch con dimensioni aggiuntive. In questo modo, questi parametri possono offrirti una visione più dettagliata.

Parametri personalizzati

Per inviare parametri estesi a CloudWatch Evidently, devi utilizzare le API AWS o AWS CLI al posto della console. Per maggiori informazioni sull'uso delle API AWS, consulta PutRumMetricsDestination e BatchCreateRumMetricDefinitions.

Il numero massimo di definizioni di parametri personalizzati e parametri estesi che una singola destinazione può contenere è 2.000. Per ogni parametro personalizzato o esteso inviato a ciascuna destinazione, ogni combinazione di nome e valore della dimensione conta per tale limite. Non ti vengono addebitati costi per le metriche personalizzate derivate da qualsiasi tipo di evento o attributo di CloudWatch RUM.

L'esempio seguente mostra come creare un parametro personalizzato derivato da un evento personalizzato. Ecco l'esempio di evento personalizzato utilizzato:

cwr('recordEvent', {
    type: 'my_custom_event', 
    data: {
        location: 'IAD', 
        current_url: 'amazonaws.com', 
        user_interaction: {
            interaction_1 : "click",
            interaction_2 : "scroll"
        }, 
        visit_count:10
    }
})

Dato questo evento personalizzato, puoi creare un parametro personalizzato che conta il numero di visite all'URL di amazonaws.com dai browser Chrome. La seguente definizione crea un parametro denominato AmazonVisitsCount nel tuo account, nello spazio dei nomi RUM/CustomMetrics/PageVisits.

{
    "AppMonitorName":"customer-appMonitor-name",
    "Destination":"CloudWatch",
    "MetricDefinitions":[
        {
            "Name":"AmazonVisitsCount",
            "Namespace":"PageVisit",
            "ValueKey":"event_details.visit_count",
            "UnitLabel":"Count",
            "DimensionKeys":{
                "event_details.current_url": "URL"
            },
            "EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}" 
        }
    ]
}

Parametri estesi

Se imposti le metriche estese, puoi eseguire una o entrambe le operazioni seguenti:

  • Invia i parametri RUM di CloudWatch predefiniti a CloudWatch Evidently per utilizzarli negli esperimenti di CloudWatch Evidently. È possibile inviare a Evidently solo le metriche seguenti: PerformanceNavigationDuration, PerformanceResourceDuration, WebVitalsCumulativeLayoutShift, WebVitalsFirstInputDelay e WebVitalsLargestContentfulPaint.

  • Invia qualsiasi parametro di CloudWatch RUM a CloudWatch con dimensioni aggiuntive in modo che i parametri offrano una visione più dettagliata. Ad esempio, puoi visualizzare i parametri specifici di un determinato browser utilizzato dagli utenti o le metriche degli utenti in una geolocalizzazione specifica.

Per ulteriori informazioni sui parametri di CloudWatch RUM predefiniti, consulta Parametri di CloudWatch che puoi raccogliere con CloudWatch RUM.

Il numero massimo di definizioni di parametri personalizzati e parametri estesi che una singola destinazione può contenere è 2.000. Per ogni parametro esteso o parametro personalizzato inviato a ciascuna destinazione, ogni combinazione di nome e valore della dimensione conta come parametro esteso per tale limite.

Quando invii metriche estese a CloudWatch, puoi utilizzare la console di CloudWatch RUM per creare allarmi CloudWatch su di essi.

Non ti vengono addebitati costi per le metriche estese create per le metriche predefinite di CloudWatch RUM.

Le metriche estese per tutti i nomi delle metriche che è possibile inviare tramite i monitoraggi dell'app supportano le dimensioni seguenti. Questi nomi del parametro sono elencati in Parametri di CloudWatch che puoi raccogliere con CloudWatch RUM.

  • BrowserName

    Valori delle dimensioni di esempio: Chrome, Firefox, Chrome Headless

  • CountryCode: utilizza il formato ISO-3166 con codici a due lettere.

    Valori delle dimensioni di esempio: US, JP, DE

  • DeviceType

    Valori delle dimensioni di esempio: desktop, mobile, tablet, embedded

  • FileType

    Valori delle dimensioni di esempio: Image, Stylesheet

  • OSName

    Valori delle dimensioni di esempio: Linux, Windows, iOS, Android

  • PageId

Configurazione di parametri estesi mediante la console

Per utilizzare la console al fine di inviare metriche estese a CloudWatch, segui i passaggi seguenti.

Per inviare metriche estese a CloudWatch Evidently, devi utilizzare le API AWS o AWS CLI al posto della console. Per informazioni sull'utilizzo delle API AWS per inviare metriche estese a CloudWatch o Evidently, consulta PutRumMetricsDestination e BatchCreateRumMetricDefinitions.

Utilizzo della console per configurare un monitor di app e inviare parametri estesi di RUM a CloudWatch

  1. Apri la console CloudWatch all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel riquadro di navigazione, scegli Application Signals, RUM.

  3. Scegli List view (Visualizzazione elenco), quindi scegli il nome del monitoraggio dell'app che deve inviare le metriche.

  4. Scegli la scheda Configuration (Configurazione) e infine RUM extended metrics (Metriche RUM estese).

  5. Scegli Send metrics (Invia parametri).

  6. Seleziona uno o più nomi di parametri da inviare con dimensioni aggiuntive.

  7. Seleziona uno o più fattori da utilizzare come dimensioni per queste metriche. Man mano che effettui le tue scelte, il numero di metriche estese creati viene visualizzato in Number of extended metrics (Numero di parametri estesi).

    Questo numero viene calcolato moltiplicando il numero di nomi dei parametri scelti per il numero delle diverse dimensioni create.

    1. Per inviare un parametro con l'ID pagina come dimensione, scegli Browse for page ID (Individua l'ID pagina), quindi seleziona gli ID pagina da utilizzare.

    2. Per inviare un parametro con il tipo di dispositivo come dimensione, scegli Desktop devices (Dispositivi desktop) o Mobile and tablets (Dispositivi mobili e tablet).

    3. Per inviare un parametro con il sistema operativo come dimensione, seleziona uno o più sistemi operativi in Operating system (Sistema operativo).

    4. Per inviare un parametro con il tipo di browser come dimensione, seleziona uno o più browser in Browsers (Browser).

    5. Per inviare un parametro con la geolocalizzazione come dimensione, seleziona una o più posizioni in Locations (Posizioni).

      Nell'elenco verranno visualizzate solo le posizioni da cui questo monitoraggio dell'app ha riportato le metriche.

  8. Quando hai finito di selezionare le opzioni, scegli Send metrics (Invia metriche).

  9. (Facoltativo) Nell'elenco Extended metrics (Metriche estese), crea un allarme che controlli uno dei parametri scegliendo Create alarm (Crea allarme) nella riga relativa al parametro.

    Per informazioni generali relative agli allarmi CloudWatch, consulta Utilizzo di allarmi Amazon CloudWatch. Per un tutorial su come configurare un allarme su un parametro esteso di CloudWatch RUM, consulta Tutorial: creazione di un parametro esteso e del relativo allarme.

Interruzione dell'invio di metriche estese

Per utilizzare la console al fine di interrompere l'invio di metriche estese

  1. Apri la console CloudWatch all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel riquadro di navigazione, scegli Application Signals, RUM.

  3. Scegli List view (Visualizzazione elenco), quindi scegli il nome del monitoraggio dell'app che deve inviare le metriche.

  4. Scegli la scheda Configuration (Configurazione) e infine RUM extended metrics (Metriche RUM estese).

  5. Seleziona una o più combinazioni di nome e dimensione dei parametri per interrompere l'invio. Quindi scegli Actions (Operazioni), Delete (Elimina).

Tutorial: creazione di un parametro esteso e del relativo allarme

Questo tutorial mostra come configurare un parametro esteso da inviare a CloudWatch e come impostare un allarme su tale parametro. In questo tutorial, creerai un parametro che tiene traccia degli errori JavaScript nel browser Chrome.

Per configurare il parametro esteso e impostare un allarme su di esso

  1. Apri la console CloudWatch all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel riquadro di navigazione, scegli Application Signals, RUM.

  3. Scegli List view ((Visualizzazione elenco), quindi scegli il nome del monitoraggio dell'app che deve inviare il parametro.

  4. Scegli la scheda Configuration (Configurazione) e infine RUM extended metrics (Metriche RUM estese).

  5. Scegli Send metrics (Invia parametri).

  6. Seleziona JsErrorCount.

  7. In Browsers (Browser), seleziona Chrome.

    Con questa combinazione di JsErrorCount e Chrome si invierà un parametro esteso a CloudWatch. Il parametro conta gli errori JavaScript solo per le sessioni utente che utilizzano il browser Chrome. Il nome del parametro sarà JsErrorCount e il nome della dimensione sarà Browser.

  8. Scegli Send metrics (Invia parametri).

  9. Nell'elenco Extended metrics (Metriche estese), scegli Create alarm (Crea allarme) nella riga che mostra JsErrorCount in Name (Nome) e Chrome in BrowserName.

  10. In Specify metric and conditions (Specifica parametri e condizioni), conferma che i campi Metric name (Nome parametro) e BrowserName siano precompilati con i valori corretti.

  11. In Statistic (Statistica), seleziona la statistica che desideri utilizzare per l'allarme. Il valore Average (Media) è ideale per questo tipo di parametro di conteggio.

  12. Per Period (Periodo), selezionare 5 minutes (5 minuti).

  13. In Condizioni, effettuare le seguenti operazioni:

    • Scegli Static (Statico).

    • Scegli Greater (Maggiore) per specificare che l'allarme deve passare allo stato ALARM quando il numero di errori è superiore alla soglia specificata.

    • In than... (di...), inserisci il numero per la soglia di allarme. L'allarme entra nello stato ALARM quando il numero di errori in un periodo di 5 minuti supera questo numero.

  14. (Facoltativo) Per impostazione predefinita, l'allarme passa allo stato ALARM non appena il numero di errori supera la soglia impostata durante un periodo di 5 minuti. Facoltativamente, è possibile modificare questa impostazione in modo che l'allarme entri nello stato ALARM solo se questo numero viene superato per un periodo superiore a 5 minuti.

    Per eseguire questa operazione, scegli Additional configuration (Configurazione aggiuntiva), quindi in Datapoints to alarm (Data point per allarme) specifica quanti periodi di 5 minuti devono avere un numero di errori superiore alla soglia per attivare l'allarme. Ad esempio, puoi selezionare 2 su 2 per attivare l'allarme solo quando due periodi consecutivi di 5 minuti superano la soglia, oppure 2 su 3 attivarlo se due dei tre periodi consecutivi di 5 minuti superano la soglia.

    Per ulteriori informazioni in merito a questo tipo di valutazione degli allarmi, consulta Valutazione di un allarme.

  15. Scegli Next (Successivo).

  16. In Configure actions (Configura operazioni), specifica cosa deve accadere quando l'allarme si attiva. Per ricevere una notifica con Amazon SNS, procedi come segue:

    • Scegliere Add notification (Aggiungi notifica).

    • Scegli In allarme.

    • Seleziona un argomento SNS esistente o crearne uno nuovo. Se ne crei uno nuovo, specifica un nome e aggiungi almeno un indirizzo e-mail.

  17. Scegli Next (Successivo).

  18. Inserisci un nome e, facoltativamente, una descrizione per l'allarme, quindi scegli Next (Successivo).

  19. Verifica i dettagli e scegli Create alarm (Crea allarme).