Recuperación de las métricas personalizadas con StatsD - Amazon CloudWatch
Visualización de métricas StatsD que el agente de CloudWatch ha importado

Recuperación de las métricas personalizadas con StatsD

Puede recuperar métricas personalizadas adicionales de sus aplicaciones o servicios con el agente de CloudWatch con el protocolo StatsD. StatsD es una solución popular de código abierto que puede recopilar métricas de una amplia variedad de aplicaciones. StatsD es especialmente útil para instrumentar sus propias métricas. Para obtener un ejemplo de cómo se utilizan el agente de CloudWatch y StatsD conjuntamente, consulte How to better monitor your custom application metrics using Amazon CloudWatch Agent (¿Cómo se supervisan de manera más efectiva las métricas de la aplicación personalizada con el agente de Amazon CloudWatch?).

StatsD es compatible con los servidores Linux y los servidores con Windows Server. CloudWatch admite el siguiente formato StatsD:

MetricName:value|type|@sample_rate|#tag1:
  value,tag1...

  • MetricName: una cadena sin dos puntos, barras, caracteres # o @.

  • value: puede ser entero o flotante.

  • type: especifique c para contador, g para medidor, ms para temporizador, h para el histograma o s para conjunto.

  • sample_rate: (Opcional) un flotador entre 0 y 1, inclusive. Se utiliza únicamente para las métricas de contador, histograma y temporizador. El valor predeterminado es 1 (muestreo del 100% del tiempo).

  • tags: (Opcional) una lista de etiquetas separadas por comas. Las etiquetas StatsD son similares a las dimensiones de CloudWatch. Utilice el carácter de dos puntos para las etiquetas de clave/valor, como env:prod.

Puede utilizar cualquier cliente de StatsD que utilice este formato para enviar las métricas al agente de CloudWatch. Para obtener más información acerca de algunos de los clientes de StatsD disponibles, consulte la página de clientes de StatsD en GitHub.

Para recopilar estas métricas personalizadas, añada una línea "statsd": {} a la sección metrics_collected del archivo de configuración del agente. Puede añadir esta línea manualmente. Si utiliza el asistente para crear el archivo de configuración, esta línea se añade automáticamente. Para obtener más información, consulte Cree el archivo de configuración del agente de CloudWatch.

La configuración de StatsD predeterminada funciona para la mayoría de los usuarios. Hay campos opcionales que puede añadir a la sección statsd del archivo de configuración del agente según sea necesario:

  • service_address: la dirección del servicio a la que el agente de CloudWatch debe escuchar . El formato es ip:port. Si se omite la dirección IP, el agente escucha en todas las interfaces disponibles. Solo se admite el formato UDP, por lo que no es necesario especificar un prefijo UDP.

    El valor predeterminado es :8125.

  • metrics_collection_interval: la frecuencia en segundos con la que se utiliza el complemento StatsD se ejecuta y recopila métricas. El valor de predeterminado es de 10 segundos. El rango va de 1 a 172 000.

  • metrics_aggregation_interval: la frecuencia en segundos con la que CloudWatch agrupa las métricas en puntos de datos únicos. El valor de predeterminado es de 60 segundos.

    Por ejemplo, si metrics_collection_interval es 10 y metrics_aggregation_interval es 60, CloudWatch recopila datos cada 10 segundos. Después de cada minuto, las seis lecturas de datos de ese minuto se agrupan en un único punto de datos, que se envía a CloudWatch.

    El rango va de 0 a 172 000. Si metrics_aggregation_interval se establece en 0, se deshabilita la agrupación de métricas de StatsD.

  • allowed_pending_messages: el número de mensajes UDP que se pueden poner en cola. Cuando la cola está llena, el servidor StatsD comienza a descartar paquetes. El valor predeterminado es 10 000.

  • drop_original_metrics: opcional. Si utiliza el campo aggregation_dimensions de la sección metrics para agrupar las métricas en resultados agregados, de forma predeterminada, el agente envía tanto las métricas agregadas como las métricas originales, separadas para cada valor de la dimensión. Si no desea que las métricas originales se envíen a CloudWatch, puede especificar este parámetro con una lista de métricas. No se notifican a CloudWatch las métricas especificadas junto con este parámetro por dimensión. En su lugar, solo se registran las métricas agregadas. Esto reduce la cantidad de métricas que recopila el agente, lo que reduce los costes.

A continuación se muestra un ejemplo de la sección statsd del archivo de configuración del agente, con el puerto predeterminado e intervalos de recopilación y agrupación personalizados.

{
   "metrics":{
      "metrics_collected":{
         "statsd":{
            "service_address":":8125",
            "metrics_collection_interval":60,
            "metrics_aggregation_interval":300
         }
      }
   }
}

Visualización de métricas StatsD que el agente de CloudWatch ha importado

Después de importar las métricas StatsD en CloudWatch, puede verlas como gráficos de series temporales y crear alarmas que puedan ver las métricas y notificarle si infringen un umbral que especifique. El siguiente procedimiento muestra cómo ver métricas de StatsD como un gráfico de series temporales. Para obtener más información sobre cómo se configura una alarma, consulte Uso de las alarmas de Amazon CloudWatch.

Para ver las métricas StatsD en la consola de CloudWatch

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

  2. En el panel de navegación, seleccione Métricas.

  3. Elija el espacio de nombres que se usará para las métricas que el agente ha recopilado. De forma predeterminada, este es CWAgent, pero es posible que haya especificado un espacio de nombres diferente en el archivo de configuración del agente de CloudWatch.

  4. Elija una dimensión de métrica (por ejemplo, Per-Instance Metrics [Métricas por instancia]).

  5. La pestaña All metrics muestra todas las métricas para dicha dimensión en el espacio de nombres. Puede hacer lo siguiente:

    1. Para representar gráficamente una métrica, active la casilla de verificación situada junto a ella. Para seleccionar todas las métricas, seleccione la casilla de verificación en la fila de encabezado de la tabla.

    2. Para ordenar la tabla, utilice el encabezado de columna.

    3. Para filtrar por recurso, seleccione el ID de recurso y, a continuación, elija Add to search (Añadir a la búsqueda).

    4. Para filtrar por métrica, elija el nombre de la métrica y, a continuación, seleccione Add to search (Añadir a búsqueda).

  6. (Opcional) Para agregar el gráfico a un panel de CloudWatch, elija Actions (Acciones) y después Add to dashboard (Añadir al panel).