¿Cómo puedo recuperar los datos de registro de Registros de CloudWatch?

Breve descripción

Para recuperar los datos de registro de Registros de CloudWatch, siga las siguientes recomendaciones en función de su caso práctico:

• Transmita datos de registro con filtros de suscripción.
• Ejecute una consulta de Información de registros de CloudWatch.
• Exporte datos de registro a Amazon Simple Storage Service (Amazon S3).
• Utilice las API de CloudWatch.
• Descargue los registros a un archivo .csv.

Solución

Transmisión de datos de registro con filtros de suscripción

Para recuperar los datos de registro de Registros de CloudWatch en tiempo real, utilice filtros de suscripción. Los filtros de suscripción de los datos de registro evitan la limitación de la API de CloudWatch. Para obtener más información, consulte Real-time processing of log data with subscriptions y Log group-level subscription filters. En el caso de Amazon Kinesis Data Streams, se vuelve a realizar un reintento automático en el caso de las API de servicio limitadas.

Ejecución de una consulta de Información de registros de CloudWatch

Para buscar y analizar datos de registros, ejecute una consulta en Información de registros de CloudWatch. Las consultas ayudan a responder a los problemas y a identificar las causas para solucionarlos. Para obtener más información, consulte Analyzing log data with CloudWatch Logs Insights.

Exportación de datos de registro a Amazon S3

Puede exportar datos de Registros de CloudWatch a Amazon S3 en casos de uso de lotes. La exportación de los datos de registro puede tardar hasta 12 horas en estar disponible en Registros de CloudWatch. Para el análisis y el procesamiento en tiempo real, utilice filtros de suscripción.

Nota: Una cuenta de AWS solo puede tener una tarea de exportación para datos de registro en el estado PENDING, PENDING_CANCEL o RUNNING.

Utilización de las API de CloudWatch

Para localizar manualmente los datos de registro, utilice las API GetLogEvents o FilterLogEvents de CloudWatch. Estas API no son escalables debido a la cuota de transacciones por segundo (TPS). Consulte las cuotas actuales en CloudWatch Logs quotas. Si experimenta limitaciones de API, utilice filtros de suscripción.

Descarga de registros a un archivo .csv

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulte Troubleshoot AWS CLI errors. Además, asegúrese de utilizar la versión más reciente de la AWS CLI.

Para recuperar los datos de registro en formato de archivo .csv, utilice los siguientes métodos:

• Utilice la consola de CloudWatch.
• Utilice la AWS CLI.
• Utilice Información de registros de CloudWatch.

Utilización de la consola de CloudWatch

Siga estos pasos:

1. Abra la consola de CloudWatch y, a continuación, seleccione el grupo de registro.
2. Elija la secuencia de registro que contenga los eventos de registro que desea descargar.
3. Seleccione Acciones y, a continuación, Descargar los resultados de búsqueda.

Uso de la AWS CLI

Para recuperar los eventos de registro en formato de archivo .csv, ejecute el comando get-log-events:

Nota: Sustituya example-loggroup-name por el nombre del grupo de registro y example-logstream-name por el nombre de la secuencia de registro.

aws logs get-log-events --log-group-name example-loggroup-name  --log-stream-name example-logstream-name  --start-time 1705147529 --end-time 1705233929 > log_events.csv

Nota: El archivo .csv se almacena en el mismo directorio desde el que se inició el comando. Además, la AWS CLI usa el perfil y la región de AWS predeterminados que se hayan configurado para la estación de trabajo. Especifique la región en cuestión. La API GetLogEvents podría devolver resultados en blanco si hay varios eventos de registro disponibles a través del token.

Uso de Información de registros de CloudWatch

Siga estos pasos:

1. Ejecute una consulta para recuperar los datos de registro.
2. Según la cantidad de registros, utilice uno de los siguientes métodos para exportar los datos:
   Si hay menos de 10 000 registros, elija Exportar resultados.
   Si hay más de 10 000 registros, exporte los registros a un bucket de Amazon S3. A continuación, descargue los datos a un archivo .csv.