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.
# Configure CloudWatch los registros para las actualizaciones de OTA
El servicio OTA Update admite el registro con Amazon CloudWatch. Puedes usar la AWS IoT consola para habilitar y configurar el CloudWatch registro de Amazon para las actualizaciones de OTA. Para obtener más información, consulte [Cloudwatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html).
Para habilitar el registro, debe crear un rol de IAM y configurar el registro de actualización OTA.
**nota**
Antes de activar el registro de actualizaciones mediante OTA, asegúrate de entender los permisos de acceso a los CloudWatch registros. Los usuarios con acceso a CloudWatch los registros pueden ver tu información de depuración. Para obtener más información, consulte [Autenticación y control de acceso para Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/auth-and-access-control-cwl.html).
## Crear un rol de registro y habilitar el registro
Utilice la [consola de AWS IoT](https://console.aws.amazon.com/iot/home) para crear un rol de registro y habilitar el registro.
1. En el panel de navegación, seleccione **Configuración**.
1. En **Registros**, elija **Editar**.
1. En **Nivel de detalle**, elija **Depuración**.
1. En **Definir rol**, elija **Crear nuevo** para crear un rol de IAM para el registro.
1. En **Nombre**, escriba un nombre único para su rol. El rol se creará con todos los permisos necesarios.
1. Elija **Actualizar**.
## Registros de actualización OTA
El servicio de actualización OTA publica registros en su cuenta cuando se produce alguna de las siguientes situaciones:
+ Se crea una actualización OTA.
+ Se completa una actualización OTA.
+ Se crea un trabajo de firma de código.
+ Se completa un trabajo de firma de código.
+ Se crea un AWS IoT trabajo.
+ Se ha completado un AWS IoT trabajo.
+ Se crea una secuencia.
Puede ver sus registros en la [consola de CloudWatch .](https://console.aws.amazon.com/cloudwatch/home)
**Para ver una actualización de OTA en CloudWatch los registros**
1. En el panel de navegación, elija **Logs (Registros)**.
1. En **Grupos de registros**, elija **AWSIoTLogsV2**.
Los registros de actualización OTA pueden contener las siguientes propiedades:
**accountId**
El ID de AWS cuenta en el que se generó el registro.
**actionType**
La acción que generó el registro. Esta propiedad se puede establecer en uno de los siguientes valores:
+ `CreateOTAUpdate`: se creó una actualización OTA.
+ `DeleteOTAUpdate`: se eliminó una actualización OTA.
+ `StartCodeSigning`: se inició un trabajo de firma de código.
+ `CreateAWSJob`: Se creó un AWS IoT trabajo.
+ `CreateStream`: se creó una secuencia.
+ `GetStream`: Se envió una solicitud de transmisión a la función de entrega de archivos AWS IoT basada en MQTT.
+ `DescribeStream`: se envió una solicitud de información sobre una transmisión a la característica de entrega de archivos basada en MQTT de AWS IoT .
**awsJobId**
El ID de AWS IoT trabajo que generó el registro.
**clientId**
El ID de cliente de MQTT que ha realizado la solicitud que generó el registro.
**clientToken**
El token de cliente asociado con la solicitud que generó el registro.
**details**
Más información acerca de la operación que generó el registro.
**logLevel**
El nivel de registro del registro. En el caso de los registros de actualización OTA, este siempre está establecido en `DEBUG`.
**otaUpdateId**
El ID de actualización OTA que generó el registro.
**protocolo**
El protocolo usado para realizar la solicitud que generó el registro.
**status**
El estado de la operación que generó el registro. Los valores válidos son:
+ Success
+ Failure
**streamId**
El ID de AWS IoT flujo que generó el registro.
**timestamp**
La hora en que se generó el registro.
**topicName**
Un tema de MQTT usado para realizar la solicitud que generó el registro.
### Registros de ejemplo
A continuación, se muestra un registro de ejemplo generado cuando se inicia un trabajo de firma de código:
```
{
"timestamp": "2018-07-23 22:59:44.955",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "StartCodeSigning",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "Start code signing job. The request status is SUCCESS."
}
```
El siguiente es un ejemplo de registro que se genera cuando se crea un AWS IoT trabajo:
```
{
"timestamp": "2018-07-23 22:59:45.363",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateAWSJob",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"awsJobId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "Create AWS Job The request status is SUCCESS."
}
```
A continuación, se muestra un registro de ejemplo generado cuando se crea una actualización OTA:
```
{
"timestamp": "2018-07-23 22:59:45.413",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateOTAUpdate",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "OTAUpdate creation complete. The request status is SUCCESS."
}
```
A continuación, se muestra un registro de ejemplo generado cuando se crea una secuencia:
```
{
"timestamp": "2018-07-23 23:00:26.391",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateStream",
"otaUpdateId": "3d3dc5f7-3d6d-47ac-9252-45821ac7cfb0",
"streamId": "6be2303d-3637-48f0-ace9-0b87b1b9a824",
"details": "Create stream. The request status is SUCCESS."
}
```
A continuación, se muestra un registro de ejemplo generado cuando se elimina una actualización OTA:
```
{
"timestamp": "2018-07-23 23:03:09.505",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "DeleteOTAUpdate",
"otaUpdateId": "9bdd78fb-f113-4001-9675-1b595982292f",
"details": "Delete OTA Update. The request status is SUCCESS."
}
```
A continuación, se muestra un registro de ejemplo generado cuando un dispositivo solicita una secuencia de la característica de entrega de archivos basada en MQTT:
```
{
"timestamp": "2018-07-25 22:09:02.678",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "GetStream",
"protocol": "MQTT",
"clientId": "b9d2e49c-94fe-4ed1-9b07-286afed7e4c8",
"topicName": "$aws/things/b9d2e49c-94fe-4ed1-9b07-286afed7e4c8/streams/1e51e9a8-9a4c-4c50-b005-d38452a956af/get/json",
"streamId": "1e51e9a8-9a4c-4c50-b005-d38452a956af",
"details": "The request status is SUCCESS."
}
```
A continuación, se muestra un registro de ejemplo generado cuando un dispositivo llama a la API `DescribeStream`:
```
{
"timestamp": "2018-07-25 22:10:12.690",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "DescribeStream",
"protocol": "MQTT",
"clientId": "581075e0-4639-48ee-8b94-2cf304168e43",
"topicName": "$aws/things/581075e0-4639-48ee-8b94-2cf304168e43/streams/71c101a8-bcc5-4929-9fe2-af563af0c139/describe/json",
"streamId": "71c101a8-bcc5-4929-9fe2-af563af0c139",
"clientToken": "clientToken",
"details": "The request status is SUCCESS."
}
```