

Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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.

# Métricas de uso de IDT
<a name="idt-usage-metrics"></a>

Si proporciona AWS credenciales con los permisos necesarios, AWS IoT Device Tester recopila y envía las métricas de uso a. AWS Se trata de una característica opcional que se utiliza para mejorar la funcionalidad de IDT. IDT recopila información como la siguiente: 
+ El Cuenta de AWS ID utilizado para ejecutar IDT
+  Los comandos de la CLI de IDT para ejecutar pruebas
+ El conjunto de pruebas que se ejecutan
+ Los conjuntos de pruebas de la carpeta {{<device-tester-extract-location>}}
+ La cantidad de dispositivos configurados en el grupo de dispositivos
+ Los nombres de casos de prueba y los tiempos de ejecución
+ La información sobre los resultados de las pruebas, por ejemplo, si se han superado, si han fallado, si se han encontrado errores o si se han omitido
+ Las características del producto probadas
+ El comportamiento de salida de IDT, como salidas inesperadas o anticipadas 

 Toda la información que IDT envía también se registra en un archivo `metrics.log` de la carpeta `{{<device-tester-extract-location>}}/results/{{<execution-id>}}/`. Puede consultar el archivo de registro para ver la información recopilada durante la ejecución de una prueba. Este archivo se genera solo si elige recopilar métricas de uso. 

Para deshabilitar la recopilación de métricas, no es necesario que realice ninguna acción adicional. Simplemente no almacene sus AWS credenciales y, si AWS las tiene almacenadas, no configure el archivo `config.jso` n para acceder a ellas.

## Configure sus AWS credentials
<a name="configure-aws-creds-for-metrics"></a>

Si aún no tiene uno Cuenta de AWS, debe [crear uno](#idt-metrics-permissions). Si ya tiene una Cuenta de AWS, solo tiene que [configurar los permisos necesarios](#idt-metrics-permissions) para su cuenta para que IDT pueda enviarle las métricas de uso AWS en su nombre.

### Paso 2: Configurar los permisos de IDT
<a name="idt-metrics-permissions"></a>

En este paso, configure los permisos que IDT utiliza para ejecutar las pruebas y recopilar datos de uso de IDT. Puede usar Consola de administración de AWS o AWS Command Line Interface (AWS CLI) para crear una política de IAM y un usuario para IDT y, a continuación, adjuntar políticas al usuario.
+ [Configuración de permisos para IDT (consola)](#idt-metrics-permissions-console)
+ [Configuración de permisos para IDT (AWS CLI)](#idt-metrics-permissions-cli)<a name="idt-metrics-permissions-console"></a>

**Configuración de permisos de IDT (consola)**

Siga estos pasos para usar la consola para configurar permisos para IDT para AWS IoT Greengrass.

1. Inicie sesión en la [consola de IAM](https://console.aws.amazon.com/iam).

1. Crear una política administrada que conceda permisos para crear roles con permisos específicos. 

   1. En el panel de navegación, seleccione **Políticas** y, a continuación, **Crear política**.

   1. En la pestaña **JSON**, reemplace el contenido del marcador de posición por la política siguiente.

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                      "iot-device-tester:SendMetrics"
                  ],
                  "Resource": "*"
              }
          ]
      }
      ```

------

   1. Elija **Siguiente: Etiquetas**.

   1. Elija **Siguiente: Revisar**.

   1. En **Nombre**, escriba **IDTUsageMetricsIAMPermissions**. En **Summary (Resumen)**, revise los permisos concedidos por la política.

   1. Elija **Crear política**.

1. Cree un usuario de IAM y adjunte los permisos al usuario.

   1. Cree un usuario de IAM. Siga los pasos del 1 al 5 en [Creación de usuarios de IAM (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console) en la *Guía del usuario de IAM*. Si ya ha creado un usuario de IAM, pase directamente al siguiente paso. 

   1. Adjunte los permisos a su usuario de IAM:

      1. En la página **Establecer permisos**, elija **Adjuntar políticas existentes directamente**.

      1. Busque la **IDTUsageMetricsIAMPermissions**política que creó en el paso anterior. Seleccione la casilla de verificación.

   1. Elija **Siguiente: etiquetas**.

   1. Elija **Next: Review (Siguiente: revisar)** para ver un resumen de sus opciones.

   1. Seleccione la opción **Crear un usuario**.

   1. Para ver las claves de acceso del usuario (ID de clave de acceso y claves de acceso secretas), elija **Mostrar** junto a la contraseña y la clave de acceso. Para guardar las claves de acceso, seleccione **Download.csv**y guarde el archivo en una ubicación segura. Utilizará esta información más adelante para configurar el archivo de AWS credenciales.

 <a name="idt-metrics-permissions-cli"></a>

**Para configurar los permisos de IDT (AWS CLI)**

Siga estos pasos AWS CLI para configurar los permisos de IDT para. AWS IoT Greengrass Si ya ha configurado permisos en la consola, vaya a [Configuración de su dispositivo para ejecutar pruebas de IDT](device-config-setup.md) o [Opcional: configurar su contenedor Docker para IDT para AWS IoT Greengrass](docker-config-setup.md).

1. En su ordenador, instale y configure el AWS CLI si aún no está instalado. Siga los pasos que se indican en [Instalación de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) en la *Guía del usuario de la AWS Command Line Interface *.
**nota**  
 AWS CLI Se trata de una herramienta de código abierto que puede utilizar para interactuar con los AWS servicios desde el shell de la línea de comandos.

1. Cree la siguiente política gestionada por el cliente que conceda permisos para gestionar el IDT y las funciones. AWS IoT Greengrass 

------
#### [ Linux, macOS, or Unix ]

   ```
   aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document '{
       "Version": "2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "iot-device-tester:SendMetrics"
               ],
               "Resource": "*"
           }
       ]
   }'
   ```

------
#### [ Windows command prompt ]

   ```
   aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document
                                           '{\"Version\": \"2012-10-17\",		 	 	  \"Statement\": [{\"Effect\": \"Allow\", \"Action\": [\"iot-device-tester:SendMetrics\"], \"Resource": \"*\"}]}'
   ```

**nota**  
Este paso incluye un ejemplo de símbolo del sistema de Windows porque utiliza una sintaxis JSON diferente a la de los comandos de terminal Linux, macOS o Unix.

------

1. Cree un usuario de IAM y adjunte los permisos requeridos por IDT para AWS IoT Greengrass.

   1. Cree un usuario de IAM. 

      ```
      aws iam create-user --user-name {{user-name}}
      ```

   1. Adjunte la política `IDTUsageMetricsIAMPermissions` que ha creado a su nuevo usuario de IAM. {{user-name}}Sustitúyalo por tu nombre de usuario de IAM y, {{<account-id>}} en el comando, por tu ID. Cuenta de AWS

      ```
      aws iam attach-user-policy --user-name {{user-name}} --policy-arn arn:aws:iam::{{<account-id>}}:policy/IDTGreengrassIAMPermissions
      ```

1. Cree una clave de acceso secreta para el usuario.

   ```
   aws iam create-access-key --user-name {{user-name}}
   ```

   Almacene la salida en una ubicación segura. Utilizará esta información más adelante para configurar el archivo de AWS credenciales.

## Proporcione AWS credenciales para IDT
<a name="idt-metrics-creds"></a>

Para permitir que IDT acceda a sus AWS credenciales y envíe las métricas a ellas AWS, haga lo siguiente:

1. Guarde las AWS credenciales de su usuario de IAM como variables de entorno o en un archivo de credenciales:

   1. Para usar variables de entorno, ejecute el siguiente comando:

      ```
      AWS_ACCESS_KEY_ID={{access-key}}
      AWS_SECRET_ACCESS_KEY={{secret-access-key}}
      ```

   1. Para utilizar el archivo de credenciales, añada la siguiente información a `.aws/credentials file:`

      ```
      [profile-name]
      aws_access_key_id={{access-key}}
      aws_secret_access_key={{secret-access-key}}
      ```

1. Configure la sección `auth` del archivo `config.json`. Para obtener más información, consulte [(Opcional) Configuración de config.json](set-config-custom.md#config-json-custom).