Trabajar con grupos de registros y flujos de registros - Amazon CloudWatch Logs
Creación de un grupo de registros Enviar registros a un grupo de registros Ver datos de registro Cambiar la retención de datos de registro Etiquetar grupos de registros

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.

Trabajar con grupos de registros y flujos de registros

Un flujo de registro es una secuencia de eventos de registro que comparten la misma fuente. Cada fuente independiente de CloudWatch registros en Logs constituye un flujo de registros independiente.

Un grupo de registros es un grupo de flujos de registro que comparten la misma configuración de retención, monitoreo y control de acceso. Puede definir grupos de registros y especificar los flujos que deben incluirse en cada uno. No hay límites en el número de flujos de registros que pueden pertenecer a un grupo de registros.

Puede usar los procedimientos de esta sección para trabajar con grupos de registros y flujos de registros.

Cree un grupo de CloudWatch registros en Logs

Al instalar el agente de CloudWatch Logs en una EC2 instancia de Amazon siguiendo los pasos de las secciones anteriores de la Guía del usuario de Amazon CloudWatch Logs, el grupo de registros se crea como parte de ese proceso. También puede crear un grupo de registros directamente en la CloudWatch consola.

Para crear un grupo de registros

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

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

  3. Elija Actions (Acciones) y, a continuación, elija Create log group (Crear grupo de registros).

  4. Escriba el nombre del grupo de registros y, a continuación, seleccione Crear grupo de registros.

sugerencia

Puede marcar como favoritos a grupos de registros, así como paneles y alarmas, desde el menú Favorites and recents (Favoritos y recientes) del panel de navegación. En la columna Visitados recientemente, desplácese sobre el grupo de registros que desea marcar como favoritos y elija el símbolo de estrella junto a este.

Enviar registros a un grupo de registros

CloudWatch Logs recibe automáticamente los eventos de registro de varios AWS servicios. También puede enviar otros eventos de registro a CloudWatch Logs mediante uno de los siguientes métodos:

Ver los datos de registro enviados a Logs CloudWatch

Puede ver los datos de registro y desplazarse por ellos stream-by-stream según los envíe el agente de CloudWatch registros a CloudWatch Logs. Puede especificar el intervalo de tiempo para los datos de registro que desee ver.

Para ver los datos de registro

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

  2. En el panel de navegación, elija Log groups (Grupos de registro).

  3. En Log Groups (Grupos de registro), elija el grupo de registros para ver los flujos.

  4. En la lista de grupos de registros, elija el nombre del grupo de registros que desea ver.

  5. En la lista de flujos de registros, elija el nombre del flujo de registros que desea ver.

  6. Para cambiar la forma en que se muestran los datos de registro, lleve a cabo alguna de las siguientes operaciones:

    • Para expandir un único evento de registro, elija la flecha situada junto a ese evento de registro.

    • Para ampliar todos los eventos de registro y verlos como texto sin formato, por encima de la lista de eventos de registro, elija Text (Texto).

    • Para filtrar los eventos de registro, escriba el filtro de búsqueda que desee en el campo de búsqueda. Para obtener más información, consulte Creación de métricas a partir de eventos de registro mediante filtros.

    • Para ver los datos de registro de un intervalo de fechas y horas especificado, junto al filtro de búsqueda, elija la flecha situada al lado de la fecha y hora. Para especificar un intervalo de fechas y horas, elija Absolute (Absoluto). Para elegir un número predefinido de minutos, horas, días o semanas, elija Relative (Relativo). También puede cambiar entre UTC una zona horaria local.

Cambie la retención de datos de registro en CloudWatch los registros

De forma predeterminada, los datos de registro se almacenan en CloudWatch los registros de forma indefinida. Sin embargo, puede configurar durante cuánto tiempo almacenar los datos de registro en un grupo de registros. Cualquier dato anterior a la configuración de retención actual se eliminará. Puede cambiar la retención de registro de cada grupo de registros cuando lo desee.

nota

CloudWatch Logs no elimina inmediatamente los eventos del registro cuando alcanzan su configuración de retención. Por lo general, pueden pasar hasta 72 horas antes de que se eliminen los eventos de registro, pero en raras ocasiones puede llevar más tiempo.

Esto significa que si cambia un grupo de registro para que tenga una configuración de retención más larga cuando contenga eventos de registro que ya hayan expirado, pero que no se hayan eliminado realmente, esos eventos de registro tardarán hasta 72 horas en eliminarse después de que se alcance la fecha de retención nueva. Para asegurarse de que los datos de registro se eliminen de manera permanente, mantenga un grupo de registro en su configuración de retención más baja hasta que hayan transcurrido 72 horas desde el final del periodo de retención anterior o hasta que haya confirmado que se han eliminado los eventos de registro más antiguos.

Cuando los eventos de registro alcanzan el límite en su configuración de retención, se marcan para su eliminación. Una vez marcados, ya no se contemplan dentro de los costos de almacenamiento de archivos, incluso si tarda un tiempo en eliminarlos. Estos eventos de registro marcados para su eliminación tampoco se incluyen cuando se utiliza an API para recuperar el storedBytes valor y ver cuántos bytes almacena un grupo de registros.

Para cambiar la configuración de retención de registros

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

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

  3. Busque el grupo de registros que desea actualizar.

  4. En la columna Retención de ese grupo de registros, elija la configuración de retención actual, como Nunca caduque.

  5. En la configuración de retención, en Expirar eventos después, elige un valor de retención del registro y, a continuación, selecciona Guardar.

Etiquetar grupos de registros en Amazon CloudWatch Logs

Puede asignar sus propios metadatos a los grupos de registros que cree en Amazon CloudWatch Logs en forma de etiquetas. Una etiqueta es un par clave-valor definido por el usuario para un grupo de registros. El uso de etiquetas es una forma sencilla pero eficaz de gestionar AWS los recursos y la organización de los datos, incluidos los datos de facturación.

nota

Puede usar etiquetas para controlar el acceso a los recursos de CloudWatch registros, incluidos los grupos de registros y los destinos. El acceso a los flujos de registro se controla a nivel de grupo de registro, debido a la relación jerárquica que existe entre los grupos de registro y los flujos de registro. A fin de obtener información sobre el uso de etiquetas para controlar el acceso, consulte Control del acceso a recursos de Amazon Web Services mediante etiquetas.

Conceptos básicos de etiquetas

Usas AWS CloudFormation la AWS CLI, o CloudWatch Registros API para completar las siguientes tareas:

  • Agregar etiquetas a un grupo de registros al crearlo.

  • Agregar etiquetas a un grupo de registros existente.

  • Enumerar las etiquetas para un grupo de registros.

  • Eliminar las etiquetas de un grupo de registros.

Puede utilizar las etiquetas para categorizar los grupos de registros. Por ejemplo, puede clasificarlas en categorías por objetivo, propietario o entorno. Dado que define la clave y el valor de cada etiqueta, puede crear un conjunto de categorías personalizadas para satisfacer sus necesidades específicas. Por ejemplo, podría definir un conjunto de etiquetas que lo ayude a realizar un seguimiento de los grupos de registros por propietario y aplicaciones asociadas. Estos son algunos ejemplos de etiquetas:

  • Proyecto: nombre del proyecto

  • Propietario: nombre

  • Objetivo: pruebas de carga

  • Aplicación: nombre de aplicación

  • Entorno: producción

Seguimiento de costos mediante el etiquetado

Puede usar etiquetas para categorizar y realizar un seguimiento de sus AWS costos. Cuando aplicas etiquetas a tu AWS recursos, incluidos los grupos de registros, su AWS el informe de asignación de costos incluye el uso y los costos agregados por etiquetas. Puede aplicar etiquetas que representen categorías de negocio (p. ej., centros de costos, nombres de aplicación o propietarios) para estructurar los costos entre diferentes servicios. Para obtener más información, consulte Utilizar etiquetas de asignación de costes para los informes de facturación personalizados en la AWS Billing Guía del usuario.

Restricciones de las etiquetas

Se aplican las siguientes restricciones a las etiquetas.

Restricciones básicas

  • El número máximo de etiquetas por grupo de registro es 50.

  • Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

  • No se pueden cambiar o editar etiquetas para un grupo de registros eliminado.

Restricciones de clave de etiqueta

  • Cada clave de etiqueta debe ser única. Si agrega una etiqueta con una clave que ya está en uso, la nueva etiqueta sobrescribe el par clave-valor existente.

  • No puede iniciar una clave de etiqueta aws: porque este prefijo está reservado para que lo usen AWS. AWS crea etiquetas que comienzan con este prefijo en tu nombre, pero no puedes editarlas ni eliminarlas.

  • Las claves de etiqueta deben tener entre 1 y 128 caracteres Unicode de longitud.

  • Las claves de etiquetas deben constar de los siguientes caracteres: letras Unicode, números, espacios en blanco y los siguientes caracteres especiales: _ . / = + - @.

Restricciones de valor de etiqueta

  • Los valores de etiqueta deben tener entre 0 y 255 caracteres Unicode de longitud.

  • Los valores de etiqueta pueden estar en blanco. De lo contrario, deben constar de los siguientes caracteres: letras Unicode, números, espacios en blanco y cualquiera de los siguientes caracteres especiales: _ . / = + - @.

Etiquetar grupos de registros mediante AWS CLI

Puede añadir, enumerar y eliminar etiquetas mediante el AWS CLI. Para ver ejemplos, consulte la siguiente documentación:

create-log-group

Crea un grupo de registros. Si lo desea, puede agregar etiquetas al crear el grupo de registros.

tag-resource

Asigna una o más etiquetas (pares clave-valor) al recurso Logs especificado CloudWatch .

list-tags-for-resource

Muestra las etiquetas que están asociadas a un CloudWatch recurso de Logs.

untag-resource

Elimina una o más etiquetas del recurso de CloudWatch registros especificado.

Etiquetar grupos de registros mediante los CloudWatch registros API

Puede añadir, enumerar y eliminar etiquetas mediante los CloudWatch registrosAPI. Para ver ejemplos, consulte la documentación siguiente:

CreateLogGroup

Crea un grupo de registros. Si lo desea, puede agregar etiquetas al crear el grupo de registros.

TagResource

Asigna una o más etiquetas (pares clave-valor) al recurso de registros especificado CloudWatch .

ListTagsForResource

Muestra las etiquetas que están asociadas a un CloudWatch recurso de Logs.

UntagResource

Elimina una o más etiquetas del recurso de CloudWatch registros especificado.