Configure el AWS IoT registro

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, introduzca 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.

AWS IoT Para configurar el registro:

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

2. En el panel de navegación izquierdo, selecciona Registros (anteriormente, una sección en Configuración).

3. Configura el registro a nivel de cuenta: el registro a nivel de cuenta se aplica a toda tu AWS IoT flota (dispositivos o terminales), a menos que lo anule la configuración a nivel de evento o de recursos específicos.

   1. En Registro a nivel de cuenta, selecciona Administrar el registro a nivel de cuenta para realizar actualizaciones.

   2. Selecciona la casilla de verificación «Habilitar el registro» para empezar a enviar los registros. CloudWatch Si la opción «Activar registro» está desactivada, no AWS IoT se enviará ningún CloudWatch registro a los grupos de registros, independientemente de las configuraciones de registro a nivel de eventos o recursos.

   3. En Función de registro de IAM, selecciona una función existente de la lista desplegable. Puede ver los detalles del rol para inspeccionar los permisos del rol. También puede seleccionar Crear un nuevo rol para configurar un nuevo rol de IAM. La función de registro proporciona políticas que permiten AWS IoT enviar entradas de registro CloudWatch en su nombre. Si configura el registro a nivel de eventos con un grupo de CloudWatch registros personalizado, debe actualizar la política de roles para incluir el ARN de este grupo de registros.

   4. Elija el nivel de registro predeterminado que corresponda al nivel de detalle de las entradas de registro que desea que aparezcan en los registros. CloudWatch Nota: El nivel de registro «DEBUG» es el que proporciona más detalles, pero aumenta CloudWatch los costes. CloudWatch Los destinos de los grupos de registros no se pueden configurar a nivel de cuenta. Sin embargo, puede especificar grupos de registros personalizados para tipos de eventos individuales, tal y como se describe en la siguiente sección.

   5. Seleccione Actualizar registro para guardar los cambios.

4. El registro a nivel de eventos le permite capturar de forma selectiva los registros de los eventos relevantes y dirigirlos a grupos de registros específicos CloudWatch . Esto le brinda la flexibilidad de organizar los registros por casos de uso para una mejor visibilidad, compartirlos con diferentes audiencias y reducir los CloudWatch costos al habilitar los registros y establecer los niveles de registro en función de la gravedad de los eventos.

   Configure el registro a nivel de eventos: el registro a nivel de eventos captura AWS IoT eventos específicos, como los intentos de autenticación del cliente. Estos ajustes anulan el registro a nivel de cuenta.

   1. En la sección Registro a nivel de eventos, selecciona Administrar el registro a nivel de eventos para realizar actualizaciones.

   2. De forma predeterminada, los tipos de eventos heredan la configuración de registro a nivel de cuenta. Nota: Cuando se configura el registro específico de un recurso, anula la configuración a nivel de cuenta y evento.

   3. Para modificar la configuración de eventos individuales, haga clic en el valor de la fila de eventos correspondiente. Puede ajustar tanto el nivel de registro como el destino del grupo de CloudWatch registros. Al especificar un destino de grupo de CloudWatch registros personalizado, debe comprobar que la política de roles de IAM incluya los permisos para el nuevo grupo de registros. Si no se actualiza la política de roles, se AWS IoT impedirá escribir registros en el grupo de registros personalizado. Tras realizar la selección, haga clic en la marca de verificación para confirmarla. La columna «Está modificado» mostrará «Sí» para indicar los cambios pendientes.

   4. Haga clic en Actualizar registro para aplicar los cambios o seleccione Cancelar para descartarlos.

5. Configurar anulaciones específicas de un recurso: las anulaciones específicas de un recurso aplican una configuración de registro a los recursos seleccionados. Un recurso puede ser un grupo de cosas, una IP de origen, un ID de cliente o un ID principal. La configuración de registro específica del recurso anula la configuración a nivel de cuenta y a nivel de evento. Cuando está habilitada, genera registros para todos los tipos de eventos en el nivel de registro configurado para los recursos especificados. Por ejemplo, puede configurar el registro a nivel de depuración para una cosa específica y, al mismo tiempo, mantener el registro a nivel de información para todas las demás cosas.

   1. Selecciona Añadir anulaciones específicas de un recurso en la sección Anulaciones específicas de un recurso.

   2. Elija un destino de registro: grupo de cosas, IP de origen, ID de cliente o ID principal.

   3. Introduzca el valor objetivo de registro correspondiente al tipo de objetivo seleccionado.

   4. Seleccione el nivel de registro deseado en el menú desplegable de la sección Nivel de registro específico del recurso.

   5. Haga clic en Enviar para añadir la modificación o en Cancelar para descartar los cambios.

   6. Para modificar una anulación específica de un recurso existente, seleccione la casilla de verificación situada junto al recurso y haga clic en «Eliminar» para eliminar la anulación o en «Editar» para modificarla.

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 \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   donde:

   --role-arn

   El ARN del rol que otorga AWS IoT permiso para escribir en tus registros en CloudWatch Logs. Para la configuración inicial, es necesaria la configuración del Role-ARN.

   --default-log-level

   El nivel de registro que se debe usar. Los valores válidos son:ERROR,, WARNINFO, DEBUG o. DISABLED Default-log-levella configuración es necesaria para la configuración inicial.

   --no-disable-all-logs

   Un parámetro opcional que permite todos los AWS IoT registros. Utilice este parámetro para habilitar el registro cuando esté deshabilitado actualmente.

   --disable-all-logs

   Parámetro opcional que desactiva todos los AWS IoT registros. Utilice este parámetro para deshabilitar el registro cuando esté habilitado actualmente.

   --event-configurations

   Este parámetro es opcional y le permite personalizar la configuración de registro para tipos de eventos individuales:

   • EventType: el tipo de evento que anula la configuración a nivel de cuenta

   • LogLevel: anula la configuración a nivel de cuenta con DEBUG, INFO, ERROR, WARN o DISABLED

   • LogDestination: especifique un grupo de registros personalizado para la entrega de registros CloudWatch

   Puede configurar el nivel de registro y el destino del registro de forma independiente para cada tipo de evento. Si no se especifica, los eventos heredarán la configuración a nivel de cuenta

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

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

   aws iot get-v2-logging-options \
       --verbose

   donde:

   --verbose

   Parámetro opcional que permite recuperar todos los tipos de eventos y sus configuraciones.

Para usar la CLI para configurar anulaciones específicas de recursos para AWS IoT

1. Habilite el registro a nivel de cuenta antes de configurar el registro específico de un recurso mediante el siguiente comando: aws iot set-v2-logging-options

2. Utilice el set-v2-logging-levelcomando para configurar las anulaciones específicas de un recurso. Consulte el siguiente ejemplo para ver la configuración de grupos de cosas:

   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 targetType 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.

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

   --target-type

   El valor target-type debe ser uno de los siguientes: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID.

   --target-name

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