Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Metriche personalizzate e metriche estese a cui puoi inviare CloudWatch Per impostazione predefinita, i monitor delle app RUM inviano le metriche a. CloudWatch Queste metriche e dimensioni predefinite sono elencate nelle [CloudWatch metriche che puoi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html) raccogliere con RUM. CloudWatch Inoltre, puoi impostare un monitor dell'app per esportare la metrica. Il monitor dell'app può inviare metriche estese, personalizzate o entrambe. Può inviarli a. CloudWatch + **Metriche personalizzate: le** metriche personalizzate sono metriche definite dall'utente. 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 metriche personalizzate a. CloudWatch + **Metriche estese**: puoi inviare qualsiasi metrica CloudWatch RUM predefinita a CloudWatch con dimensioni aggiuntive. In questo modo, questi parametri possono offrirti una visione più dettagliata. **Topics** + [parametri personalizzati](#CloudWatch-RUM-custom-metrics) + [Parametri estesi](#CloudWatch-RUM-vended-metrics) ## parametri personalizzati Per inviare metriche personalizzate, devi utilizzare AWS APIs o AWS CLI anziché la console. Per ulteriori informazioni sull'utilizzo di AWS APIs, consulta [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)e [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html). 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 configuri metriche estese, puoi inviare qualsiasi metrica CloudWatch RUM predefinita a CloudWatch con dimensioni aggiuntive in modo che le metriche offrano una visione più dettagliata. Per ulteriori informazioni sulle metriche RUM predefinite, consulta. CloudWatch [CloudWatch metriche che puoi raccogliere con RUM CloudWatch](CloudWatch-RUM-metrics.md) 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 CloudWatch RUM per creare CloudWatch allarmi su di esse. Non ti vengono addebitati costi per le metriche estese create per le metriche predefinite di RUM. CloudWatch ### Metriche estese dell'applicazione Web Le seguenti dimensioni sono supportate per le metriche estese delle applicazioni Web: + `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` ### Metriche estese per applicazioni mobili Le seguenti dimensioni sono supportate per le metriche estese delle applicazioni mobili: + `ScreenName` + Valore derivante dall'attributo screen name - `attributes.screen.name` dell'applicazione + Valori di esempio: HomeScreen, SettingsView, ProfilePage + `DeviceModel` + Valore derivante dall'attributo del modello del dispositivo - `resource.attributes.device.model.name` + Valori di esempio: iPhone14,3, SM-G998B + `OSVersion` + Valore derivante dall'attributo della versione del sistema operativo - `resource.attributes.os.version` + Valori di esempio: 16.0, 13.0 **Nota** Metriche predefinite attualmente supportate per le applicazioni mobili: `ScreenLoadTime``ScreenLoadCount`,`NetworkLatency`,,`Http4xxCount`,`Http5xxCount`,`CrashCount`,`ANRCount`,`AppHangCount`, `ColdLaunchTime``WarmLaunchTime`, `SessionCount` e. `SpanPayloadSize` `LogPayloadSize` ### Configurazione di parametri estesi mediante la console Per utilizzare la console a cui inviare metriche estese CloudWatch, procedi nel seguente modo. Per informazioni sull'utilizzo di per AWS APIs inviare metriche estese a entrambi CloudWatch, consulta [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)e. [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html) **Per utilizzare la console per configurare un'app, monitora e invia metriche estese RUM a CloudWatch** 1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Nel riquadro di navigazione, scegli **Application Signals**, **RUM**. 1. Scegli il nome del monitor dell'app a cui inviare le metriche. 1. Scegli la scheda **Configuration** (Configurazione) e infine **RUM extended metrics** (Metriche RUM estese). 1. Scegli **Send metrics** (Invia parametri). 1. Seleziona uno o più nomi di parametri da inviare con dimensioni aggiuntive. 1. 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 una metrica con l'ID di pagina come dimensione, scegli **Cerca l'ID della pagina**, quindi seleziona la pagina IDs da utilizzare. 1. Per inviare un parametro con il tipo di dispositivo come dimensione, scegli **Desktop devices** (Dispositivi desktop) o **Mobile and tablets** (Dispositivi mobili e tablet). 1. Per inviare un parametro con il sistema operativo come dimensione, seleziona uno o più sistemi operativi in **Operating system** (Sistema operativo). 1. Per inviare un parametro con il tipo di browser come dimensione, seleziona uno o più browser in **Browsers** (Browser). 1. 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. 1. Quando hai finito di selezionare le opzioni, scegli **Send metrics** (Invia metriche). 1. (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 sugli CloudWatch allarmi, consulta. [Utilizzo degli CloudWatch allarmi Amazon](CloudWatch_Alarms.md) Per un tutorial sull'impostazione di un allarme in base a una metrica estesa CloudWatch RUM, vedi. [Tutorial: creazione di un parametro esteso e del relativo allarme](#CloudWatch-RUM-extended-metrics-alarmtutorial) **Interruzione dell'invio di metriche estese** **Per utilizzare la console al fine di interrompere l'invio di metriche estese** 1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Nel riquadro di navigazione, scegli **Application Signals**, **RUM**. 1. Scegli il nome del monitor dell'app a cui inviare le metriche. 1. Scegli la scheda **Configuration** (Configurazione) e infine **RUM extended metrics** (Metriche RUM estese). 1. 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 impostare una metrica estesa a cui inviare CloudWatch e quindi come impostare un allarme su quella metrica. In questo tutorial, crei una metrica che tiene traccia JavaScript degli errori nel browser Chrome. **Per configurare il parametro esteso e impostare un allarme su di esso** 1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Nel riquadro di navigazione, scegli **Application Signals**, **RUM**. 1. Scegli il nome del monitor dell'app a cui inviare la metrica. 1. Scegli la scheda **Configuration** (Configurazione) e infine **RUM extended metrics** (Metriche RUM estese). 1. Scegli **Send metrics** (Invia parametri). 1. Seleziona **JSErrorCount**. 1. In **Browsers** (Browser), seleziona **Chrome**. Questa combinazione di **JSErrorCount** e **Chrome** invierà una metrica estesa a CloudWatch. La metrica conta JavaScript gli errori solo per le sessioni utente che utilizzano il browser Chrome. **Il nome della metrica sarà **JsErrorCount**e il nome della dimensione sarà Browser.** 1. Scegli **Send metrics** (Invia parametri). 1. Nell'elenco delle **metriche estese**, scegli **Crea allarme** nella riga visualizzata **JsErrorCount**sotto **Nome** e in cui viene visualizzato **Chrome**. **BrowserName** 1. In **Specificare metrica e condizioni**, conferma che il **nome e i **BrowserName**campi della metrica** siano precompilati con i valori corretti. 1. In **Statistic** (Statistica), seleziona la statistica che desideri utilizzare per l'allarme. Il valore **Average** (Media) è ideale per questo tipo di parametro di conteggio. 1. Per **Period (Periodo)**, selezionare **5 minutes (5 minuti)**. 1. 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. 1. (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 degli allarmi](alarm-evaluation.md). 1. Scegli **Next (Successivo)**. 1. 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. 1. Scegli **Next (Successivo)**. 1. Inserisci un nome e, facoltativamente, una descrizione per l'allarme, quindi scegli **Next** (Successivo). 1. Verifica i dettagli e scegli **Create alarm** (Crea allarme).