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 Crear un rol vinculado a un servicio para AWS IoT SiteWise.

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. Reemplazar logging-policy-name con 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 y aws: 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:

• Reemplazar logging-policy-name con el nombre de la política que se va a crear.

• Reemplazar source-ARN con el ARN de su AWS IoT SiteWise recurso, como un modelo de activo o un activo. Para encontrar el valor ARN de cada tipo de AWS IoT SiteWise recurso, consulte los tipos de recursos definidos AWS IoT SiteWise en la Referencia de autorización de servicio.

• Reemplazar account-ID con 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.

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.

Contenido

• Administra el inicio de sesión AWS IoT SiteWise
  • Encuentre su nivel de registro
  • Cambie su nivel de registro
• Ejemplo: entradas de archivos de AWS IoT SiteWise registro

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.

Encuentre 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 tu nivel de AWS IoT SiteWise registro actual

1. Vaya a la consola de AWS IoT SiteWise.

2. 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"
  }
}

Cambie su 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.

2. En el panel de navegación izquierdo, elija Logging options (Opciones de registro).

3. Elija Editar.

4. Elija el Nivel de detalle que desea activar.

5. Seleccione Guardar.

AWS CLI

Ejecute el siguiente AWS CLI comando para cambiar el nivel de AWS IoT SiteWise registro. Reemplazar logging-level con 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"
  }
}