Métricas personalizadas y ampliadas que puede enviar a CloudWatch y CloudWatch Evidently - Amazon CloudWatch
Métricas personalizadasMétricas ampliadas

Métricas personalizadas y ampliadas que puede enviar a CloudWatch y CloudWatch Evidently

De forma predeterminada, los monitores de aplicaciones de RUM envían métricas a CloudWatch. Estas métricas y dimensiones predeterminadas se muestran en Métricas de CloudWatch que puede recopilar con CloudWatch RUM.

También puede configurar un monitor de aplicaciones para que exporte métricas. El monitor de aplicaciones puede enviar métricas ampliadas, métricas personalizadas o ambas. Puede enviarlas a CloudWatch o a CloudWatch Evidently, o a ambos.

  • Métricas personalizadas: las métricas personalizadas son métricas que el usuario define. Con las métricas personalizadas, puede usar cualquier nombre y espacio de nombres de métrica. Para derivar las métricas, puedes usar cualquier evento personalizado, evento integrado, atributo personalizado o atributo predeterminado.

    Puede enviar métricas personalizadas tanto a CloudWatch como a CloudWatch Evidently.

  • Métricas ampliadas: permite enviar las métricas RUM predeterminadas de CloudWatch a CloudWatch Evidently para utilizarlas en los experimentos de Evidently. También puede enviar cualquiera de las métricas RUM de CloudWatch predeterminadas a CloudWatch con dimensiones adicionales. De este modo, estas métricas pueden ofrecerle una visión más detallada.

Métricas personalizadas

Para enviar métricas personalizadas, debe utilizar las API de AWS o AWS CLI en lugar de la consola. Para obtener más información sobre el uso de las API de AWS, consulte PutRumMetricsDestination y BatchCreateRumMetricDefinitions.

Un destino puede contener un máximo de 2000 definiciones de métricas ampliadas y personalizadas. Para cada métrica personalizada o ampliada que envíe a cada destino, cada combinación de nombre y valor de dimensión cuenta para este límite. Esto también cuenta como una métrica personalizada de CloudWatch para fijar precios.

El siguiente ejemplo muestra cómo crear una métrica personalizada derivada de un evento personalizado. Este es el ejemplo de evento personalizado que se utiliza:

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

Dado este evento personalizado, puede crear una métrica personalizada que cuente el número de visitas a la URL amazonaws.com desde navegadores Chrome. La siguiente definición crea una métrica denominada AmazonVisitsCount en su cuenta, en el espacio de nombres 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\"]}}" 
        }
    ]
}

Métricas ampliadas

Si configura métricas ampliadas, puede realizar una o ambas de las siguientes acciones:

  • Envíe las métricas CloudWatch RUM predeterminadas a CloudWatch Evidently para utilizarlas en los experimentos de Evidently. Solo se pueden enviar a Evidently las métricas PerformanceNavigationDuration, PerformanceResourceDuration, WebVitalsCumulativeLayoutShift, WebVitalsFirstInputDelay y WebVitalsLargestContentfulPaint.

  • Envíe cualquiera de las métricas predeterminadas de CloudWatch RUM a CloudWatch con dimensiones adicionales para que las métricas le ofrezcan una visión más detallada. Por ejemplo, puede ver las métricas específicas de un navegador determinado que utilicen los usuarios o las métricas de los usuarios de una ubicación geográfica específica.

Para obtener más información acerca de las métricas de CloudWatch RUM, consulte Métricas de CloudWatch que puede recopilar con CloudWatch RUM.

Un destino puede contener un máximo de 2000 definiciones de métricas ampliadas y personalizadas. Para cada métrica extendida que envíe a cada destino, cada combinación de nombre y valor de dimensión cuenta como una métrica extendida para este límite. Esto también cuenta como una métrica personalizada de CloudWatch para fijar precios.

Al enviar métricas ampliadas a CloudWatch, puede utilizar la consola de CloudWatch RUM para crear alarmas de CloudWatch en ellas.

Las métricas ampliadas se cobran como métricas personalizadas de CloudWatch. Para más información, consulte Precios de Amazon CloudWatch.

Las siguientes dimensiones son compatibles con las métricas ampliadas de todos los nombres de métricas que pueden enviar los monitores de aplicaciones. Estos nombres de métricas se enumeran en Métricas de CloudWatch que puede recopilar con CloudWatch RUM.

  • BrowserName

    Ejemplos de valores de dimensión: Chrome, Firefox, Chrome Headless

  • CountryCode: utiliza el formato ISO-3166, con códigos de dos letras.

    Ejemplos de valores de dimensión: US, JP, DE

  • DeviceType

    Ejemplos de valores de dimensión: desktop, mobile, tablet, embedded

  • FileType

    Ejemplos de valores de dimensión: Image, Stylesheet

  • OSName

    Ejemplos de valores de dimensión: Linux, Windows, iOS, Android

  • PageId

Configuración de métricas ampliadas con la consola

Para usar la consola para enviar métricas ampliadas a CloudWatch, siga estos pasos.

Para enviar métricas ampliadas a CloudWatch Evidently, debe utilizar las API de AWS o AWS CLI en lugar de la consola. Para obtener información sobre el uso de las API de AWS para enviar métricas ampliadas a CloudWatch o Evidently, consulte PutRumMetricsDestination y BatchCreateRumMetricDefinitions.

Usar la consola para configurar un monitor de aplicaciones y enviar las métricas ampliadas de RUM a CloudWatch

  1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación, elija Señales de aplicación, RUM.

  3. Seleccione List view (Vista de lista) y, a continuación, seleccione el nombre del monitor de aplicaciones que vaya a enviar las métricas.

  4. Elija la pestaña Configuration (Configuración) y, a continuación, elija RUM extended metrics (Métricas ampliadas de RUM).

  5. Elija Send metrics (Enviar métricas).

  6. Seleccione uno o más nombres de métricas para enviarlos con dimensiones adicionales.

  7. Seleccione uno o más factores para utilizarlos como dimensiones para estas métricas. Al hacer sus elecciones, la cantidad de métricas ampliadas que crean sus elecciones se muestra en Number of extended metrics (Número de métricas ampliadas).

    Este número se calcula multiplicando el número de nombres de métricas elegidos por el número de dimensiones diferentes que se crean. Este número representa la cantidad de métricas personalizadas que se le cobran. Para obtener más información sobre los precios de CloudWatch, consulte Precios de Amazon CloudWatch.

    1. Para enviar una métrica con el ID de página como dimensión, elija Browse for page ID (Buscar el ID de página) y, a continuación, seleccione los ID de página que desee utilizar.

    2. Para enviar una métrica con el tipo de dispositivo como dimensión, elija Desktop devices (Dispositivos de escritorio) o Mobile and tablets (Móviles y tabletas).

    3. Para enviar una métrica con el sistema operativo como dimensión, seleccione uno o más sistemas operativos en Operating system (Sistema operativo).

    4. Para enviar una métrica con el tipo de navegador como dimensión, seleccione uno o más navegadores en Browsers (Navegadores).

    5. Para enviar una métrica con la ubicación geográfica como dimensión, seleccione una o más ubicaciones en Locations (Ubicaciones).

      Solo aparecerán en la lista para elegir las ubicaciones desde las que este monitor de aplicaciones haya informado sobre métricas.

  8. Cuando haya terminado con las opciones, elija Send metrics (Enviar métricas).

  9. (Opcional) En la lista Extended metrics (Métricas ampliadas), para crear una alarma que controle una de las métricas, elija Create alarm (Crear alarma) en la fila de esa métrica.

    Para obtener información general sobre las alarmas de CloudWatch, consulte Uso de las alarmas de Amazon CloudWatch. Para ver un tutorial sobre cómo configurar una alarma en una métrica ampliada de CloudWatch RUM, consulte Tutorial: crear una métrica ampliada y ponerle una alarma.

Dejar de enviar métricas ampliadas

Usar la consola para dejar de enviar métricas ampliadas

  1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación, elija Señales de aplicación, RUM.

  3. Seleccione List view (Vista de lista) y, a continuación, seleccione el nombre del monitor de aplicaciones que vaya a enviar las métricas.

  4. Elija la pestaña Configuration (Configuración) y, a continuación, elija RUM extended metrics (Métricas ampliadas de RUM).

  5. Seleccione una o más combinaciones de nombre y dimensión de métrica para detener el envío. A continuación, elija Actions (Acciones), Delete (Eliminar).

Tutorial: crear una métrica ampliada y ponerle una alarma

Este tutorial muestra cómo configurar una métrica ampliada para enviarla a CloudWatch y, a continuación, cómo configurar una alarma en esa métrica. En este tutorial, creará una métrica que realice un seguimiento de los errores de JavaScript en el navegador Chrome.

Configuración de esta métrica ampliada y cómo establecer una alarma

  1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación, elija Señales de aplicación, RUM.

  3. Seleccione List view (Vista de lista) y, a continuación, seleccione el nombre del monitor de aplicaciones que vaya a enviar la métrica.

  4. Elija la pestaña Configuration (Configuración) y, a continuación, elija RUM extended metrics (Métricas ampliadas de RUM).

  5. Elija Send metrics (Enviar métricas).

  6. Seleccione JSErrorCount.

  7. En Browsers (Navegadores), seleccione Chrome.

    Esta combinación de JSErrorCount y Chrome enviará una métrica ampliada a CloudWatch. La métrica solo cuenta los errores de JavaScript en las sesiones de usuario que utilicen el navegador Chrome. El nombre de la métrica será JSErrorCount y el nombre de la dimensión será Browser (Navegador).

  8. Elija Send metrics (Enviar métricas).

  9. En la lista Extended metrics (Métricas ampliadas), seleccione Create alarm (Crear alarma) en la fila que muestre JSErrorCount en Name (Nombre) y Chrome en BrowserName (Nombre del navegador).

  10. En Specify metric and conditions (Especificar métrica y condiciones), confirme que los campos Metric name (Nombre de la métrica) y BrowserName estén rellenados previamente con los valores correctos.

  11. En Statistic (Estadística), seleccione la estadística que desee utilizar para la alarma. Average (Promedio) es una buena opción para este tipo de métrica de recuento.

  12. En Period (Período), seleccione 5 minutes (5 minutos).

  13. En Condiciones, haga lo siguiente:

    • Elija Static (Estático).

    • Elija Greater (Mayor) para especificar que la alarma debe pasar al estado ALARM (ALARMA) cuando el número de errores sea superior al umbral que esté a punto de especificar.

    • En than… (que…), ingrese el número del umbral de la alarma. La alarma entra en estado ALARM cuando el número de errores en un período de 5 minutos supera este número.

  14. (Opcional) De forma predeterminada, la alarma pasa al estado ALARM en cuanto el número de errores supera el umbral establecido durante un período de 5 minutos. Si lo desea, puede cambiarlo para que la alarma entre en estado ALARM solo si se supera este número durante más de un período de 5 minutos.

    Para ello, seleccione Additional configuration (Configuración adicional) y, a continuación, en Datapoints to alarm (Puntos de datos para la alarma), especifique cuántos períodos de 5 minutos deben tener el número de errores por encima del umbral para activar la alarma. Por ejemplo, puede seleccionar 2 de 2 para que la alarma se active solo cuando dos períodos consecutivos de 5 minutos superen el umbral, o 2 de 3 para que se active la alarma si 2 de los 3 períodos consecutivos de 5 minutos superan el umbral.

    Para obtener más información acerca de este tipo de evaluación de alarmas, consulte Evaluación de una alarma.

  15. Elija Siguiente.

  16. En Configure actions (Configurar acciones), especifique lo que debe suceder cuando la alarma entre en estado de alarma. Para recibir una notificación con Amazon SNS, haga lo siguiente:

    • Seleccione Agregar notificación.

    • Elija En alarma.

    • Seleccione un tema de SNS existente o cree uno nuevo. Si crea uno nuevo, especifique un nombre y agregue al menos una dirección de correo electrónico.

  17. Elija Siguiente.

  18. Ingrese un nombre y, si lo desea, una descripción de la alarma y elija Next (Siguiente).

  19. Revise los detalles y seleccione Create alarm (Crear alarma).