# Introducción a Información de colaboradores de CloudWatch para DynamoDB
En esta sección, se describe cómo habilitar y usar Información de colaboradores de Amazon CloudWatch en diferentes modos para cumplir las necesidades de supervisión mediante la consola de Amazon DynamoDB o la AWS Command Line Interface (AWS CLI).
En los siguientes ejemplos, usará la tabla de DynamoDB que se define en el tutorial de [Introducción a DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GettingStartedDynamoDB.html).
**Topics**
+ [Elección de un modo de Contributor Insights](#contributorinsights_tutorial.modes)
+ [Uso de Información de colaboradores (consola)](#usecontributorinsights_console)
+ [Uso de Contributor Insights (AWS CLI)](#usecontributorinsights_cli)
## Elección de un modo de Contributor Insights
Antes de habilitar Contributor Insights, debe comprender los dos modos disponibles. Revise la comparación de modos para seleccionar la opción que mejor se adapte a sus requisitos específicos.
| Aspecto | Modo de claves a las que se ha accedido y limitadas | Modo de claves limitadas |
| --- | --- | --- |
| Monitores | Todas las solicitudes (satisfactorias y limitadas) | Solo solicitudes limitadas |
| Gráficos | Los elementos a los que más se accede \$1 los elementos más limitados | Solo los elementos más limitados |
| Lo mejor para | Análisis y optimización específicos | Supervisión de la limitación |
| Usar cuando | Necesita una visibilidad completa de los patrones de acceso. Está realizando un análisis o una depuración a corto plazo. | Su principal preocupación es identificar y resolver problemas de limitación. Desea mantener Contributor Insights habilitado de forma continua para las alertas de limitación en tiempo real. |
## Uso de Información de colaboradores (consola)
La consola proporciona una forma intuitiva de habilitar Contributor Insights y seleccionar el modo adecuado para sus necesidades de supervisión.
**Uso de Información de colaboradores en la consola**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de DynamoDB en [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/).
1. En el panel de navegación del lado izquierdo de la consola, elija **Tablas**.
1. Elija la tabla `Music`.
1. Elija la pestaña **Supervisar**.
1. Elija **Activar Información de colaboradores de CloudWatch**.
![\[Captura de pantalla de la consola que muestra la pestaña y el botón de monitoreo.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/CI_ChooseAndManageNew.PNG)
1. En el cuadro de diálogo **Administrar la configuración de Información·de·colaboradores·de·CloudWatch**, **active la opción** para la tabla base de `Music` y el índice secundario global `AlbumTitle-index`.
1. Deje el interruptor de **Solo modo de claves limitadas** en la posición de desactivado para ambos y, a continuación, elija **Guardar cambios**.
![\[Captura de pantalla de la consola con las opciones de la lista de estados de Contributor Insights.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/CI_Enable.png)
Esto habilita el modo predeterminado de *claves a las que se ha accedido y limitadas* para la tabla y GSI, lo que permite supervisar los elementos a los que se ha accedido y limitados. Cambiar el interruptor de **Solo modo de claves limitadas** a la posición de encendido habilitaría el modo de *claves limitadas*.
Si la operación no se realiza correctamente, consulte [FailureException en DescribeContributorInsights](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeContributorInsights.html#DDB-DescribeContributorInsights-response-FailureException) en la *Referencia de la API de Amazon DynamoDB* para conocer los posibles motivos.
1. Los gráficos de Información·de·colaboradores·de·CloudWatch son ahora visibles en la pestaña **Supervisar** para la tabla de `Music`. Dado que ha habilitado el modo de *claves a las que se ha accedido y limitadas*, verá gráficos de elementos a los que se ha accedido y limitados.
![\[Captura de pantalla de la consola con la pestaña Contributor Insights con varios gráficos correspondientes a la tabla Music.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/CI_Graphs.png)
### Cambio entre modos
Puede cambiar entre modos en cualquier momento sin desactivar Contributor Insights.
**Cambio de los modos de Contributor Insights**
1. En la pestaña **Supervisar** de la tabla, elija **Administrar Información·de·colaboradores·de·CloudWatch**.
1. En el cuadro de diálogo **Administrar la configuración de Contributor Insights**, para cada tabla base o GSI:
+ Active o desactive el **modo solo claves limitadas** para habilitar el modo *claves limitadas* o volver al modo predeterminado *claves a las que se ha accedido y limitadas*.
+ Desactive la opción **Activar** para desactivar Información·de·colaboradores·de·CloudWatch para una tabla o un GSI.
1. Seleccione **Save changes (Guardar cambios)**.
Una vez completado, los gráficos reflejarán el modo nuevo.
### Crear alarmas de CloudWatch
Siga estos pasos para crear una alarma de CloudWatch y recibir una notificación cuando cualquier clave de partición consume más de 50 000 [ConsumedThroughputUnits](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights_HowItWorks.html#contributorinsights_HowItWorks.Graphs.most-accessed) o experimenta limitaciones.
1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación del lado izquierdo de la consola, seleccione **Contributor Insights**.
1. Elija la regla adecuada en función del modo y de lo que desee supervisar:
+ Para la supervisión de los elementos a los que se ha accedido (solo en el modo de claves a las que se ha accedido y limitadas): elija **DynamoDBContributorInsights-PKC-Music**
+ Para la supervisión de elementos limitados (ambos modos): elija **DynamoDBContributorInsights-PKT-Music**
1. Seleccione el menú desplegable **Acciones**.
1. Elija **View in metrics (Ver en métricas)**.
1. Seleccione **Valor máximo de colaborador**.
**nota**
Solo `Max Contributor Value` y `Maximum` producen estadísticas útiles. Las demás estadísticas de esta lista no devuelven valores significativos.
![\[Captura de pantalla de la consola con la pestaña Contributor Insights y el botón.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/CI_AlarmsViewinMetrics.png)
1. En la columna **Acciones** seleccione **Crear alarma**.
![\[Captura de pantalla de la consola con las opciones de la lista de estados de Contributor Insights.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarm.png)
1. Ingrese un valor de limitación adecuado y elija **Siguiente**:
+ Para los elementos a los que se ha accedido (reglas de PKC): ingrese 50 000 para `ConsumedThroughputUnits`
+ Para los elementos limitados (reglas de PKT): ingrese 1 para `ThrottleCount` para recibir una alerta en caso de que se produzca una limitación
![\[Captura de pantalla de la consola con la pestaña Contributor Insights y el botón.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarmThreashold.png)
1. Consulte [Uso de alarmas de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) para obtener información detallada sobre cómo configurar la notificación de la alarma.
## Uso de Contributor Insights (AWS CLI)
La AWS CLI proporciona acceso programático a Contributor Insights y es totalmente compatible con ambos modos. Puede especificar el modo al habilitar Contributor Insights o cambiar de modo más adelante.
### Operaciones básicas con el modo predeterminado
**Uso de Contributor Insights con la configuración predeterminada**
1. Habilite Información·de·colaboradores·de·CloudWatch para DynamoDB en la tabla base de `Music` con el modo de *claves a las que se ha accedido y limitadas*. Dado que `ACCESSED_AND_THROTTLED_KEYS` es el modo predeterminado, puede omitir el parámetro `--contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE
```
1. Habilite Contributor Insights for DynamoDB en el índice secundario global `AlbumTitle-index`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index \
--contributor-insights-action=ENABLE
```
1. Obtenga el estado y las reglas de la tabla `Music` y todos sus índices.
```
aws dynamodb describe-contributor-insights
--table-name Music
```
La respuesta incluirá el campo `ContributorInsightsMode` que muestra `ACCESSED_AND_THROTTLED_KEYS`.
1. Muestre el estado de la tabla `Music` y todos sus índices.
```
aws dynamodb list-contributor-insights --table-name Music
```
### Habilitación del modo de claves limitadas
**Habilitación de Contributor Insights en el modo de claves limitadas**
1. Habilite Información·de·colaboradores·de·CloudWatch para DynamoDB en la tabla base de `Music` con el modo de *claves limitadas*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Habilite Contributor Insights en el modo de *claves limitadas* para el índice secundario global `AlbumTitle-index`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Compruebe el modo describiendo la configuración de Contributor Insights.
```
aws dynamodb describe-contributor-insights --table-name Music
```
La respuesta mostrará `ContributorInsightsMode` como `THROTTLED_KEYS` y menos reglas en comparación con el modo predeterminado.
### Cambio entre modos
**Cambio de los modos de Contributor Insights**
1. Cambie del modo de *claves limitadas* al modo de *claves a las que se ha accedido y limitadas*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS
```
1. Cambie del modo de *claves a las que se ha accedido y limitadas* al modo de *claves limitadas*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Compruebe el estado durante la transición.
```
aws dynamodb describe-contributor-insights --table-name Music
```
Durante el cambio de modo, `ContributorInsightsStatus` se mostrará como `ENABLING`. Una vez completado, se mostrará como `ENABLED` con el nuevo modo.
### Administración de Contributor Insights
**Administración de la configuración de Contributor Insights**
1. Desactive CloudWatch Contributor Insights for DynamoDB en el índice secundario global `AlbumTitle-index`.
```
aws dynamodb update-contributor-insights \
--table-name Music --index-name AlbumTitle-index \
--contributor-insights-action=DISABLE
```
1. Muestre todas las configuraciones de Contributor Insights en la cuenta.
```
aws dynamodb list-contributor-insights
```
Aquí se muestran todas las tablas e índices con Contributor Insights habilitado, junto con sus modos.
1. Obtenga información detallada sobre una configuración específica.
```
aws dynamodb describe-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index
```
### Respuestas de ejemplo
Esto son respuestas de ejemplo que muestran las diferencias entre los modos:
#### Respuesta del modo de claves a las que se ha accedido y limitadas
```
{
"TableName": "Music",
"ContributorInsightsRuleList": [
"DynamoDBContributorInsights-PKC-Music-1234567890123",
"DynamoDBContributorInsights-PKT-Music-1234567890123",
"DynamoDBContributorInsights-SKC-Music-1234567890123",
"DynamoDBContributorInsights-SKT-Music-1234567890123"
],
"ContributorInsightsStatus": "ENABLED",
"ContributorInsightsMode": "ACCESSED_AND_THROTTLED_KEYS",
"LastUpdateDateTime": "2024-01-15T10:30:00.000Z"
}
```
#### Respuesta del modo de claves limitadas
```
{
"TableName": "Music",
"ContributorInsightsRuleList": [
"DynamoDBContributorInsights-PKT-Music-1234567890123",
"DynamoDBContributorInsights-SKT-Music-1234567890123"
],
"ContributorInsightsStatus": "ENABLED",
"ContributorInsightsMode": "THROTTLED_KEYS",
"LastUpdateDateTime": "2024-01-15T10:35:00.000Z"
}
```
Observe que el modo de claves limitadas tiene menos reglas (solo PKT y SKT), lo que corresponde a una supervisión más centrada.