Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Ejemplo: contar incidencias de un término
Los eventos de registro suelen incluir mensajes importantes que desea contar, quizás referentes al éxito o fracaso de las operaciones. Por ejemplo, puede producirse un error y registrarse en un archivo de registro si falla una determinada operación. Es posible que desee monitorizar estas entradas para comprender la evolución de sus errores.
En el ejemplo siguiente, se crea un filtro de métricas para monitorizar el término Error. La política se creó y se agregó al grupo de registro MyApp/message.log. Registros de CloudWatch publica un punto de datos en la métrica personalizada de CloudWatch ErrorCount en el espacio de nombres MyApp/message.log con un valor de “1” para cada evento que contenga Error. Si ningún evento contiene la palabra Error, entonces se publica un valor 0. Cuando grafique estos datos en la consola de CloudWatch, asegúrese de utilizar la estadística de suma.
Después de crear un filtro de métricas, puede ver la métrica en la consola de CloudWatch. Cuando seleccione la métrica que desea ver, seleccione el espacio de nombres de métrica que coincida con el nombre del grupo de registro. Para obtener más información, consulte Viewing Available Metrics (Visualización de las métricas disponibles).
Para crear un filtro de métricas mediante la consola de CloudWatch
-
Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/
. -
En el panel de navegación, seleccione Grupos de registro.
-
Elija el nombre del grupo de registro.
-
Elija Actions (Acciones), Create metric filter (Crear filtro de métricas).
-
En Filter pattern (Patrón de filtro), escriba
Error.nota
Todas las entradas de Filter Pattern distinguen entre mayúsculas y minúsculas.
-
(Opcional) Para probar el patrón de filtro, en Test Pattern (Patrón de prueba), ingrese uno o más eventos de registro a utilizar para probar el patrón. Cada evento de registro debe estar dentro de una línea, ya que los saltos de línea se utilizan para separar los eventos de registro en el cuadro de Log event messages (Mensajes de eventos de registro).
-
Elija Next (Siguiente), y, a continuación, en la página Filter Name (Asignar métrica), en Filter Name (Nombre de filtro), escriba
MyAppErrorCount. -
En Metric Details, en Metric Namespace, escriba MyNameSpace.
-
En Metric Name, escriba ErrorCount.
-
Confirme que el Metric Value (Valor métrico) es 1. Esto especifica que el recuento se incrementa en 1 para cada evento de registro que contenga “Error”.
-
En Default Value (Valor predeterminado) escriba 0 y, a continuación, elija Next (Siguiente).
-
Elija Create metric filter (Crear filtro de métricas).
Para crear un filtro de métricas mediante la AWS CLI
En el símbolo del sistema, ejecute el siguiente comando:
aws logs put-metric-filter \ --log-group-name MyApp/message.log \ --filter-name MyAppErrorCount \ --filter-pattern 'Error' \ --metric-transformations \ metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
Puede probar esta nueva política publicando eventos que contengan la palabra “Error” en el mensaje.
Para publicar eventos mediante la AWS CLI
En el símbolo del sistema, ejecute el siguiente comando. Tenga en cuenta que los patrones distinguen entre mayúsculas y minúsculas.
aws logs put-log-events \ --log-group-name MyApp/access.log --log-stream-name TestStream1 \ --log-events \ timestamp=1394793518000,message="This message contains an Error" \ timestamp=1394793528000,message="This message also contains an Error"