

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 CloudWatch registros en Visual Studio
<a name="cloudwatch-log-overview"></a>

La integración de Amazon CloudWatch Logs le permite supervisar, almacenar y acceder a CloudWatch los registros desde el AWS Toolkit for Visual Studio con Amazon Q. Tener acceso CloudWatch a las funciones de Logs, sin necesidad de salir del IDE, mejora la eficiencia al simplificar el proceso de desarrollo de Logs y reducir las interrupciones en CloudWatch el flujo de trabajo. En los siguientes temas se describe cómo trabajar con las características y funciones básicas de la integración de Logs. CloudWatch 

**Topics**
+ [CloudWatch Grupos de registros](#cloudwatch-log-overview-groups)
+ [CloudWatch Flujos de registro](#cloudwatch-log-overview-logstream)
+ [CloudWatch Registre eventos](#cloudwatch-log-overview-logevents)
+ [Acceso adicional a los registros CloudWatch](#cloudwatch-log-overview-additional)

## CloudWatch Grupos de registros
<a name="cloudwatch-log-overview-groups"></a>

Un `log group` es un grupo de `log streams` que comparten la misma configuración de retención, monitorización y control de acceso. No hay límites en el número de flujos de registros que pueden pertenecer a un grupo de registro.

### Visualización de grupos de registros
<a name="cloudwatch-log-overview-groups-view"></a>

La `View Log Groups` función muestra una lista de grupos de registros en el explorador de grupos de CloudWatch registros.

Para acceder a la función Ver grupos de registros y abrir el explorador de grupos de CloudWatch registros, complete los siguientes pasos.

1. Desde el AWS Explorador, expande **Amazon CloudWatch**.

1. Haga doble clic en **Grupos de registros** o abra el menú contextual (haga clic con el botón derecho) y seleccione **Ver** para abrir el **explorador de grupos de CloudWatch registros**.
**nota**  
El explorador de grupos de CloudWatch registros se abrirá en la misma ubicación de la ventana que el explorador de soluciones.

### Filtrado de grupos de registro
<a name="cloudwatch-log-overview-groups-filter"></a>

Su cuenta individual puede contener miles de grupos de registro diferentes. Para simplificar la búsqueda de grupos específicos, utilice la característica de `filtering` que se describe a continuación. 

1. En el **explorador de grupos de CloudWatch registros**, coloque el cursor en la barra de búsqueda situada en la parte superior de la ventana.

1. Comience a escribir un prefijo relacionado con los grupos de registros que está buscando.

1. CloudWatch El **explorador de grupos de registro** se actualiza automáticamente para mostrar los resultados que coinciden con los términos de búsqueda que especificó en el paso anterior.

### Eliminación de grupos de registros
<a name="cloudwatch-log-overview-groups-delete"></a>

Para eliminar un grupo de registro específico, consulte el procedimiento siguiente.

1. En el **explorador de grupos de CloudWatch registros**, haga clic con el botón derecho en el grupo de registros que desee eliminar.

1. Cuando se le pida, confirme que desea eliminar el grupo de registro seleccionado en ese momento.

1. Al pulsar el botón **Sí,** se elimina el grupo de registros seleccionado y, a continuación, se actualiza el explorador de **grupos de CloudWatch registros**.

### Actualización de los grupos de registros
<a name="cloudwatch-log-overview-groups-refresh"></a>

**Para actualizar la lista actual de grupos de registros que se muestra en el **explorador de grupos de CloudWatch registros**, pulse el botón del **icono Actualizar** situado en la barra de herramientas.**

### Copia del ARN del grupo de registro
<a name="cloudwatch-log-overview-groups-copyarn"></a>

Para copiar el ARN de un grupo de registro específico, siga los pasos que se describen a continuación.

1. En el **explorador de grupos de CloudWatch registros**, haga clic con el botón derecho en el grupo de registros del que desee copiar un ARN.

1. Elija la opción **Copiar ARN** del menú.

1. El ARN ya está copiado en el portapapeles local y listo para pegarlo.

## CloudWatch Flujos de registro
<a name="cloudwatch-log-overview-logstream"></a>

Un flujo de registro es una secuencia de eventos de registro que comparten la misma fuente.

**nota**  
Cuando consulte los flujos de registro, debe tener en cuenta las siguientes propiedades:  
De forma predeterminada, los flujos de registro se ordenan según la marca de tiempo del evento más reciente.
Las columnas asociadas a un flujo de registro se pueden organizar en orden ascendente o descendente, moviendo el **signo de intercalación** situado en los encabezados de las columnas.
Las entradas filtradas solo se pueden ordenar por el **nombre del flujo de registro.**

### Visualización de flujos de registro
<a name="cloudwatch-log-overview-logstream-view"></a>

1. En el **explorador de grupos de CloudWatch registros**, haga doble clic en un grupo de registros o haga clic con el botón derecho en un grupo de **registros y seleccione Ver flujo** de registros en el menú contextual.

1. Se abrirá una nueva pestaña en la ventana del **documento**, que contiene una lista de los flujos de registro asociados a su grupo de registro.

### Filtrado de flujos de registro
<a name="cloudwatch-log-overview-logstream-filter"></a>

1. En la pestaña **Flujos de registro**, en la ventana del **documento**, coloque el cursor en la barra de búsqueda.

1. Comience a escribir un prefijo relacionado con el flujo de registro que está buscando.

1. A medida que escribe, la pantalla en la que se encuentra se actualiza automáticamente para filtrar sus flujos de registro según lo que introduzca.

### Actualización de los flujos de registro
<a name="cloudwatch-log-overview-logstream-refresh"></a>

Para actualizar la lista actual de flujos de registro que se muestra en la ventana del **documento**, pulse el botón del **icono Actualizar**, situado en la **barra de herramientas**, junto a la **barra de búsqueda**.

### Copia del ARN de los flujos de registro
<a name="cloudwatch-log-overview-logstream-copyarn"></a>

Para copiar el ARN de un flujo de registro específico, siga los pasos que se describen a continuación.

1. En la pestaña **Flujos de registro**, en la ventana del **documento**, haga clic con el botón derecho en el flujo de registro del que desee copiar el ARN.

1. Elija la opción **Copiar ARN** del menú.

1. El ARN ya está copiado en el portapapeles local y listo para pegarlo.

### Descarga de los flujos de registro
<a name="cloudwatch-log-overview-logstream-delete"></a>

La característica **Exportar flujo de registro** descarga y almacena el flujo de registro seleccionado de forma local, desde donde se puede acceder a él mediante herramientas y software personalizados para procesarlo posteriormente.

1. En la pestaña **Flujos de registro**, en la ventana del **documento**, haga clic con el botón derecho en el flujo de registro que quiere descargar.

1. Seleccione **Exportar flujo de registro** para abrir el cuadro de diálogo **Exportar a un archivo de texto**.

1. Elija la ubicación en la que desee almacenar el archivo localmente e indique un nombre en el campo de texto correspondiente.

1. Confirme la descarga seleccionando **Aceptar**. El estado de la descarga aparece en el **Centro de estado de tareas de Visual Studio**

## CloudWatch Registre eventos
<a name="cloudwatch-log-overview-logevents"></a>

Los eventos de registro son registros de actividad registrados por la aplicación o el recurso que se monitorea CloudWatch.

### Acción de eventos de registro
<a name="cloudwatch-log-overview-logevents-actions"></a>

Los eventos de registro se muestran en forma de tabla. De forma predeterminada, los eventos se ordenan del más antiguo al más reciente.

Las siguientes acciones se asocian al registro de eventos en Visual Studio:
+ Modo de texto ajustado: puede cambiar el texto ajustado haciendo clic en un evento.
+ Botón de ajuste de texto: este botón se ubica en la `document window toolbar` y sirve para activar y desactivar el ajuste de texto en todas las entradas.
+ Copia los mensajes al portapapeles: selecciona los mensajes que deseas copiar, haz clic con el botón derecho en la selección y selecciona **Copiar** (`Ctrl + C` con el método abreviado de teclado).

### Consulta de los eventos de registro
<a name="cloudwatch-log-overview-logevents-view"></a>

1. En la ventana del **documento**, elija una pestaña que contenga una lista de flujos de registro. 

1. Haga doble clic en un flujo de registro o haga clic con el botón derecho en un flujo de registro y seleccione **Ver flujo de registro** en el menú.

1. Se abrirá una nueva pestaña de **evento de registro** en la ventana del **documento** que contiene una lista de los eventos de registro asociados al flujo de registro escogido.

### Filtrado de eventos de registro
<a name="cloudwatch-log-overview-logevents-filter"></a>

Hay tres formas de filtrar los eventos de registro: por contenido, por intervalo de tiempo o ambos. Para filtrar los eventos de registro tanto por contenido como por intervalo de tiempo, comience filtrando los mensajes por contenido o intervalo de tiempo y, a continuación, filtre los resultados por el otro método.

Para filtrar los eventos de registro por contenido:

1. En la pestaña de **eventos de registro**, en la ventana del **documento**, coloque el cursor en la barra de búsqueda, ubicada en la parte superior de la ventana.

1. Comience a escribir un término o una frase relacionados con los eventos de registro que está buscando.

1. A medida que escribe, la pantalla actual comienza a filtrar automáticamente los eventos de registro.
**nota**  
Los patrones de filtro distinguen mayúsculas y minúsculas. Para mejorar los resultados de búsqueda, puede incluir términos y frases exactos con caracteres no alfanuméricos entre comillas dobles (\$1""\$1). Para obtener información más detallada sobre los patrones de filtro, consulta el tema [Sintaxis de filtros y patrones](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html) en la CloudWatch guía de Amazon.

Para ver los eventos de registro generados durante un intervalo de tiempo específico:

1. En la pestaña de **evento de registro**, en la ventana del **documento**, pulse el botón del **icono de Calendario**, situado en la **barra de herramientas**. 

1. Con los campos proporcionados, especifique el intervalo de tiempo en el que desea buscar.

1. Los resultados filtrados se actualizan automáticamente a medida que se especifican las restricciones de fecha y hora.
**nota**  
La opción **Borrar filtro** borra todas las selecciones de date-and-time filtros actuales.

### Actualización de los eventos de registro
<a name="cloudwatch-log-overview-logevents-refresh"></a>

Para actualizar la lista actual de eventos de registro que se muestra en la pestaña **evento de registro**, seleccione el botón del **icono Actualizar** ubicado en la **barra de herramientas.**

## Acceso adicional a los registros CloudWatch
<a name="cloudwatch-log-overview-additional"></a>

Puede acceder a CloudWatch los registros asociados a otros AWS servicios y recursos directamente desde el AWS kit de herramientas de Visual Studio.

### Lambda
<a name="cloudwatch-log-overview-additional-lambda"></a>

Para ver los flujos de registro asociados a una función de Lambda:

**nota**  
Su función de ejecución de Lambda debe tener los permisos adecuados para enviar registros a CloudWatch Logs. Para obtener más información sobre los permisos de Lambda necesarios para los CloudWatch registros, consulte [https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs)

1. En el explorador del AWS kit de herramientas, expanda **Lambda**.

1. Haga clic con el botón derecho en la función que desee ver y, a continuación, seleccione **Ver registros** para abrir los flujos de registro asociados en la ventana del **documento**.

Para ver los flujos de registro mediante la `function view` de la integración de Lambda:

1. En el explorador del AWS kit de herramientas, expanda **Lambda**.

1. Haga clic con el botón derecho en la función que desee ver y, a continuación, seleccione **Ver función** para abrir la vista de función en la ventana del **documento**.

1. En `function view`, cambie a la pestaña **Registros**, donde se muestran los flujos de registro asociados a la función de Lambda escogida.

### ECS
<a name="cloudwatch-log-overview-additional-ecs"></a>

Para ver los recursos de registro asociados a un contenedor de tareas de ECS, siga el siguiente procedimiento.

**nota**  
Para que el servicio Amazon ECS pueda enviar registros CloudWatch, cada contenedor de una tarea de Amazon ECS determinada debe cumplir con la configuración requerida. Para obtener información adicional sobre la configuración y las configuraciones requeridas, consulte la guía [Uso del controlador AWS Logs Log](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html).

1. Desde el explorador de AWS kits de herramientas, amplíe **Amazon ECS.**

1. Elija el clúster de Amazon ECS que desee ver para abrir una nueva pestaña de **clúster de ECS** en la ventana del **documento**.

1. En el menú de navegación, situado en la parte izquierda de la pestaña **Clúster de ECS**, seleccione **Tareas** para enumerar todas las tareas asociadas al clúster.

1. En la pantalla de **tareas**, seleccione una tarea y elija el enlace **Ver registros**, ubicado en la esquina inferior izquierda.
**nota**  
Esta pantalla muestra todas las tareas incluidas en el clúster; el enlace de `View Logs` solo está visible para cada tarea que cumpla con la configuración de registros requerida.  
Si una tarea solo está asociada a un único contenedor, el enlace **Ver registros** abre el flujo de registro de ese contenedor.
Si una tarea está asociada a varios contenedores, el enlace **Ver registros** abre el cuadro de diálogo **Ver CloudWatch registros para la tarea de ECS**. Utilice el menú desplegable **Contenedor:** para elegir el contenedor del que quiere ver los registros y, a continuación, pulse **Aceptar**.

1. Se abre una nueva pestaña en la ventana del **documento** que muestra los flujos de registro asociados a la selección del contenedor.