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 registros MyApp/message.log. CloudWatch Logs publica un punto de datos ErrorCount en la métrica CloudWatch personalizada del espacio de nombres MyApp/message.log con un valor de «1" para cada evento que contenga un error. Si ningún evento contiene la palabra Error, entonces se publica un valor 0. Cuando se representan estos datos gráficamente 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 CloudWatch consola. 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 CloudWatch consola
-
Abra la CloudWatch consola 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 (Detalles de métrica), en Metric Namespace (Espacio de nombres de métrica), escriba MyNameSpace.
-
En Nombre de métrica, 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 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/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 el 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"