Configuración de registros de AWS IoT

1. En Seleccionar tipo de entidad de confianza, elija Servicio de AWS. A continuación, seleccione IoT en Caso de uso. Si no ve IoT, ingrese y busque IoT en el menú desplegable Casos de uso para otros servicios de AWS:. Seleccione Siguiente.

2. En la página Añadir permisos, verá las políticas que se asocian automáticamente al rol de servicio. Elija Siguiente.

3. En la página Nombrar, revisar y crear, introduzca un Nombre de rol y Descripción de rol para el rol y, a continuación, elija Crear rol.

4. En la lista de Roles, busque el rol que creó, ábralo y copie el ARN del rol (<logging-role-arn>) para utilizarlo cuando Configure el registro predeterminado en AWS IoT (consola).

Para usar la consola de AWS IoT para configurar el registro predeterminado para todo AWS IoT

1. Inicie sesión en la consola de AWS IoT. Para obtener más información, consulte Abra la consola de AWS IoT.

2. En el panel de navegación izquierdo, elija Configuración. En la sección Registros de la página Configuración, elija Administrar registros.

   La página Registros muestra el rol de registro y el nivel de detalle utilizado por todo AWS IoT.

   

3. En la página Registros, elija Seleccionar rol para especificar un rol que creó en Creación de un rol de registro o Crear rol para crear un nuevo rol para utilizarlo para el registro.

   

4. Elija el Nivel de registro que describa el nivel de detalle de las entradas de registro que quiere que aparezcan en los registros de CloudWatch.

5. Elija Actualizar para guardar los cambios.

Para usar la CLI para configurar el registro predeterminado para AWS IoT

1. Utilice el comando set-v2-logging-options para establecer las opciones de registro para su cuenta.

   aws iot set-v2-logging-options \
       --role-arn logging-role-arn \
       --default-log-level log-level

   donde:

   --role-arn

   El ARN de rol que concede permiso a AWS IoT para escribir en los registros de CloudWatch.

   --default-log-level

   El nivel de registro que se debe usar. Los valores válidos son: ERROR, WARN, INFO, DEBUG o DISABLED

   --no-disable-all-logs

   Un parámetro opcional que habilita todo el registro de AWS IoT. Utilice este parámetro para habilitar el registro cuando esté deshabilitado actualmente.

   --disable-all-logs

   Un parámetro opcional que deshabilita todo el registro de AWS IoT. Utilice este parámetro para deshabilitar el registro cuando esté habilitado actualmente.

2. Utilice el comando get-v2-logging-options para obtener las opciones de registro actuales.

   aws iot get-v2-logging-options

Para usar la CLI para configurar el registro específico de recursos para AWS IoT

1. Utilice el comando set-v2-logging-options para establecer las opciones de registro para su cuenta.

   aws iot set-v2-logging-options \
       --role-arn logging-role-arn \
       --default-log-level log-level

   donde:

   --role-arn

   El ARN de rol que concede permiso a AWS IoT para escribir en los registros de CloudWatch.

   --default-log-level

   El nivel de registro que se debe usar. Los valores válidos son: ERROR, WARN, INFO, DEBUG o DISABLED

   --no-disable-all-logs

   Un parámetro opcional que habilita todo el registro de AWS IoT. Utilice este parámetro para habilitar el registro cuando esté deshabilitado actualmente.

   --disable-all-logs

   Un parámetro opcional que deshabilita todo el registro de AWS IoT. Utilice este parámetro para deshabilitar el registro cuando esté habilitado actualmente.

2. Utilice el comando set-v2-logging-level para configurar el registro específico de recursos para un grupo de objetos.

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   El tipo y nombre del recurso para el que está configurando el registro. El valor target_type debe ser uno de los siguientes: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID. El valor del parámetro log-target puede ser texto, como se muestra en el ejemplo de comando anterior, o una cadena JSON, como en el ejemplo siguiente.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   El nivel de registro utilizado cuando se generan registros para el recurso especificado. Los valores válidos son: DEBUG, INFO, ERROR, WARN y DISABLED.

   aws iot set-v2-logging-level \ 
                 --log-target targetType=CLIENT_ID,targetName=ClientId1 \
                 --log-level DEBUG

3. Utilice el comando list-v2-logging-levels para enumerar los niveles de registro configurados actualmente.

   aws iot list-v2-logging-levels

4. Utilice el comando delete-v2-logging-level para eliminar un nivel de registro específico de recursos, como en los ejemplos siguientes.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --targetType

   El valor target_type debe ser uno de los siguientes: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID.

   --targetName

   El nombre del grupo de objetos para el que se va a quitar el nivel de registro.