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

Métricas personalizadas y ampliadas que puede enviar a CloudWatch

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.

  • 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 a CloudWatch.

  • Métricas ampliadas: puede enviar cualquiera de las métricas de CloudWatch RUM 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. No se le cobrarán las métricas personalizadas derivadas de ningún tipo de evento o atributo de CloudWatch RUM.

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 las métricas ampliadas, puede enviar 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.

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.

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

No se le cobrarán las métricas ampliadas que se creen para las métricas predeterminadas de CloudWatch RUM.

Métricas ampliadas de aplicaciones web

Las siguientes dimensiones son compatibles con las métricas ampliadas de aplicaciones web:

  • 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

Métricas ampliadas de aplicaciones móviles

Las siguientes dimensiones son compatibles con las métricas ampliadas de aplicaciones móviles:

  • ScreenName

    • Valor del atributo del nombre de pantalla: attributes.screen.name de la aplicación

    • Valores de ejemplo: HomeScreen, SettingsView, ProfilePage

  • DeviceModel

    • Valor del atributo del modelo del dispositivo: resource.attributes.device.model.name

    • Valores de ejemplo: iPhone14.3, SM-G998B

  • OSVersion

    • Valor del atributo de la versión del sistema operativo: resource.attributes.os.version

    • Valores de ejemplo: 16.0, 13.0

nota

Métricas predeterminadas compatibles actualmente con las aplicaciones móviles: ScreenLoadTime, ScreenLoadCount, NetworkLatency, Http4xxCount, Http5xxCount, CrashCount, ANRCount, AppHangCount, ColdLaunchTime, WarmLaunchTime, SessionCount, SpanPayloadSize y LogPayloadSize.

Configuración de métricas ampliadas con la consola

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

Para obtener información sobre el uso de las API de AWS para enviar métricas ampliadas a CloudWatch, 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. Elija el nombre del monitor de aplicaciones que 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.

    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. Elija el nombre del monitor de aplicaciones que 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. Elija el nombre del monitor de aplicaciones que 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 alarmas.

  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 Crear alarma.