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.
# Supervise con Amazon CloudWatch Logs
AWS IoT SiteWise Configúrelo para registrar la información en CloudWatch los registros a fin de supervisar y solucionar los problemas del servicio.
Cuando utilizas la AWS IoT SiteWise consola, AWS IoT SiteWise crea un rol vinculado al servicio que permite al servicio registrar la información en tu nombre. Si no usa la AWS IoT SiteWise consola, debe crear manualmente un rol vinculado al servicio para recibir los registros. Para obtener más información, consulte [Cree un rol vinculado a un servicio para AWS IoT SiteWise](create-service-linked-role.md).
Debe tener una política de recursos que permita colocar AWS IoT SiteWise los eventos de registro en CloudWatch las transmisiones. Para crear y actualizar una política de recursos para CloudWatch los registros, ejecute el siguiente comando. {{logging-policy-name}}Sustitúyalo por el nombre de la política que se va a crear.
```
aws logs put-resource-policy --policy-name {{logging-policy-name}} --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"
```
CloudWatch Los registros también admiten [las claves de contexto aws: SourceArn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) [y aws: SourceAccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-ke-sourceaccount) condition. Estas claves de contexto de condición son opcionales.
Para crear o actualizar una política de recursos que AWS IoT SiteWise permita colocar únicamente los registros asociados al AWS IoT SiteWise recurso especificado en las CloudWatch transmisiones, ejecute el comando y haga lo siguiente:
+ {{logging-policy-name}}Sustitúyalo por el nombre de la política que se va a crear.
+ {{source-ARN}}Sustitúyalo por el ARN de tu AWS IoT SiteWise recurso, como un modelo de activo o un activo. Para encontrar el ARN de cada tipo de AWS IoT SiteWise recurso, consulte [Tipos de recursos definidos AWS IoT SiteWise en la Referencia](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) de *autorización de servicio*.
+ {{account-ID}}Sustitúyalo por el ID de AWS cuenta asociado al AWS IoT SiteWise recurso especificado.
```
aws logs put-resource-policy --policy-name {{logging-policy-name}} --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"{{source-ARN}}\"],\"aws:SourceAccount\":[\"{{account-ID}}\"]}}}]}"
```
De forma predeterminada, AWS IoT SiteWise no registra la información en los CloudWatch registros. Para activar el registro, elige un nivel de registro que no sea **Desactivado** (`OFF`). AWS IoT SiteWise admite los siguientes niveles de registro:
+ `OFF`: el registro está desactivado.
+ `ERROR`: se registran los errores.
+ `INFO`: se registran los errores y los mensajes informativos.
Puede configurar las puertas de enlace SiteWise Edge para que registren la información en CloudWatch Logs Through AWS IoT Greengrass. Para obtener más información, consulte [Supervise los registros de SiteWise Edge Gateway](monitor-gateway-logs.md).
También puede configurarlas AWS IoT Core para que registren información en los CloudWatch registros si está solucionando una acción de AWS IoT SiteWise regla. Para obtener más información, consulte [Solucionar problemas con una acción de AWS IoT SiteWise regla](troubleshoot-rule.md).
**Contents**
+ [Administra el inicio de sesión AWS IoT SiteWise](#manage-cloudwatch-logs)
+ [Búsqueda de su nivel de registro](#find-logging-level)
+ [Cambio del nivel de registro](#change-logging-level)
+ [Ejemplo: entradas de archivos de AWS IoT SiteWise registro](#sitewise-log-format)
## Administra el inicio de sesión AWS IoT SiteWise
Utilice la AWS IoT SiteWise consola o AWS CLI para las siguientes tareas de configuración de registro.
### Búsqueda de su nivel de registro
------
#### [ Console ]
Utilice el procedimiento siguiente para buscar el nivel de registro actual en la consola de AWS IoT SiteWise .
**Para encontrar su nivel de AWS IoT SiteWise registro actual**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación izquierdo, elija **Logging options (Opciones de registro)**.
El estado actual de registro aparece en **Logging status (Estado de registro)**. Si el registro está activado, el nivel de registro actual aparece en **Nivel de detalle**.
------
#### [ AWS CLI ]
Ejecute el siguiente comando para encontrar su nivel de AWS IoT SiteWise registro actual con el AWS CLI.
```
aws iotsitewise describe-logging-options
```
La operación devuelve una respuesta que contiene el nivel de registro en el siguiente formato.
```
{
"loggingOptions": {
"level": "{{String}}"
}
}
```
------
### Cambio del nivel de registro
Utilice el siguiente procedimiento para cambiar el nivel de registro en la AWS IoT SiteWise consola o mediante AWS CLI.
------
#### [ Console ]
**Para cambiar el nivel de AWS IoT SiteWise registro**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación izquierdo, elija **Logging options (Opciones de registro)**.
1. Elija **Editar**.
1. Elija el **Nivel de detalle** que desea activar.
1. Seleccione **Guardar**.
------
#### [ AWS CLI ]
Ejecute el siguiente AWS CLI comando para cambiar el nivel de AWS IoT SiteWise registro. {{logging-level}}Sustitúyalo por el nivel de registro que desee.
```
aws iotsitewise put-logging-options --logging-options level={{logging-level}}
```
------
## Ejemplo: entradas de archivos de AWS IoT SiteWise registro
Cada entrada de AWS IoT SiteWise registro incluye información sobre el evento y los recursos relevantes para ese evento, de modo que pueda comprender y analizar los datos del registro.
En el siguiente ejemplo, se muestra una CloudWatch entrada de AWS IoT SiteWise registros que registra cuándo se crea correctamente un modelo de activos.
```
{
"eventTime": "2020-05-05T00:10:22.902Z",
"logLevel": "INFO",
"eventType": "AssetModelCreationSuccess",
"message": "Successfully created asset model.",
"resources": {
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
}
```