Ejemplo: recuento de eventos de registro

El tipo de monitorización de evento de registro más sencillo consiste en contar el número de eventos de registro que se producen. Es posible que desee hacerlo para llevar un recuento de todos los eventos, para crear un monitor de estilo "latido" o simplemente para practicar la creación de filtros de métricas.

En el siguiente ejemplo de CLI, MyAppAccessCount se aplica un filtro de métricas denominado MyApp /access.log al grupo de registros para crear la métrica EventCount en el espacio de CloudWatch nombres MyNamespace. El filtro está configurado para que compare cualquier contenido de eventos de registro y para aumentar la métrica en "1".

Para crear un filtro de métricas mediante la consola CloudWatch

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

2. En el panel de navegación, seleccione Grupos de registro.

3. Elija el nombre de un grupo de registros.

4. Elija Actions, Create metric filter (Crear filtro de métricas).

5. Deje Filter Pattern (Patrón de filtro) y Select Log Data to Test (Seleccionar los datos de registro para probar) en blanco.

6. Elija Next (Siguiente), y, a continuación, en Filter Name (Nombre de filtro), escriba EventCount.

7. En Metric Details (Detalles de métrica), en Metric Namespace (Espacio de nombres de métrica), escriba MyNameSpace.

8. En Nombre de métrica, escriba MyAppEventCount.

9. Confirme que el Metric Value (Valor métrico) es 1. Esto especifica que el recuento se incrementa en 1 para cada evento de registro.

10. En Default Value (Valor predeterminado), escriba 0 y, a continuación, elija Next (Siguiente). Al especificar un valor predeterminado se garantiza que los datos se registren incluso durante los periodos en los que no se producen eventos de registro, lo que impide que haya métricas irregulares en las que a veces no existen datos.

11. Elija Create metric filter (Crear filtro de métricas).

Para crear un filtro métrico mediante el AWS CLI

En el símbolo del sistema, ejecute el siguiente comando:

aws logs put-metric-filter \
  --log-group-name MyApp/access.log \
  --filter-name EventCount \
  --filter-pattern " " \
  --metric-transformations \
  metricName=MyAppEventCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0

Puede probar esta nueva política publicando cualesquiera datos de eventos. Deberías ver los puntos de datos publicados en la métrica MyAppAccessEventCount.

Para publicar los datos del evento mediante el AWS CLI

En el símbolo del sistema, ejecute el siguiente comando:

aws logs put-log-events \
  --log-group-name MyApp/access.log --log-stream-name TestStream1 \
  --log-events \
    timestamp=1394793518000,message="Test event 1" \
    timestamp=1394793518000,message="Test event 2" \
    timestamp=1394793528000,message="This message also contains an Error"