View a markdown version of this page

Metriche di utilizzo IDT - AWS IoT Greengrass
Configura le tue AWS credenzialiFornire AWS credenziali per IDT

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Metriche di utilizzo IDT

Se fornisci AWS credenziali con le autorizzazioni richieste, AWS IoT Device Tester raccoglie e invia le metriche di utilizzo a. AWS Si tratta di una funzionalità opzionale e viene utilizzata per migliorare la funzionalità IDT. IDT raccoglie informazioni come le seguenti:

  • L' Account AWS ID utilizzato per eseguire IDT

  • I AWS CLI comandi IDT utilizzati per eseguire i test

  • Le suite di test che vengono eseguite

  • Le suite di test nella <device-tester-extract-location> cartella

  • Il numero di dispositivi configurati nel pool di dispositivi

  • Nomi e tempi di esecuzione dei test case

  • Informazioni sui risultati del test, ad esempio se i test sono stati superati, hanno avuto esito negativo, hanno riscontrato errori o sono stati saltati

  • Caratteristiche del prodotto testate

  • Comportamento di uscita IDT, ad esempio uscite impreviste o anticipate

Tutte le informazioni inviate da IDT vengono inoltre registrate in un metrics.log file nella cartella. <device-tester-extract-location>/results/<execution-id>/ È possibile visualizzare il file di registro per visualizzare le informazioni raccolte durante un'esecuzione di test. Questo file viene generato solo se si sceglie di raccogliere le metriche di utilizzo.

Per disabilitare la raccolta delle metriche, non è necessario intraprendere ulteriori azioni. Semplicemente non archiviate AWS le vostre credenziali e, se avete AWS credenziali memorizzate, non configurate il config.json file per accedervi.

Configura le tue AWS credenziali

Se non ne hai già uno Account AWS, devi crearne uno. Se ne hai già uno Account AWS, devi semplicemente configurare le autorizzazioni richieste per il tuo account che consentano a IDT di inviare le metriche di utilizzo AWS a tuo nome.

Fase 2: configurazione delle autorizzazioni per IDT

In questo passaggio, configura le autorizzazioni utilizzate da IDT per eseguire test e raccogliere dati sull'utilizzo di IDT. Puoi utilizzare Console di gestione AWS or AWS Command Line Interface (AWS CLI) per creare una policy IAM e un utente per IDT, quindi allegare le policy all'utente.

Per configurare le autorizzazioni per IDT (Console)

Attenersi alla seguente procedura per utilizzare la console per configurare le autorizzazioni per IDT per AWS IoT Greengrass.

  1. Accedere alla console IAM.

  2. Creare un criterio gestito dal cliente che concede le autorizzazioni per creare ruoli con autorizzazioni specifiche.

    1. Nel pannello di navigazione, scegli Policy e Crea policy.

    2. Nella scheda JSON, sostituire il contenuto del segnaposto con la seguente policy.

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

    3. Scegliere Esamina policy.

    4. In Nome, inserisci IDTUsageMetricsIAMPermissions. In Riepilogo, esaminare le autorizzazioni concesse dai criteri.

    5. Scegli Crea policy.

  3. Crea un utente IAM e assegna le autorizzazioni all'utente.

    1. Crea un utente IAM. Segui i passaggi da 1 a 5 in Creazione di utenti IAM (console) nella Guida per l'utente IAM. Se hai già creato un utente IAM, vai al passaggio successivo.

    2. Allega le autorizzazioni al tuo utente IAM:

      1. Nella pagina Imposta autorizzazioni, seleziona Collega direttamente policy esistenti.

      2. Cerca la IDTUsageMetricsIAMPermissionspolicy che hai creato nel passaggio precedente. Selezionare la casella di controllo.

    3. Scegli Successivo: Tag.

    4. Scegliere Next:Review per visualizzare un riepilogo delle tue scelte.

    5. Selezionare Create user (Crea utente).

    6. Per visualizzare le chiavi di accesso dell'utente (ID chiave di accesso e chiavi di accesso segrete), scegliere Mostra accanto alla password e alla chiave di accesso. Per salvare le chiavi di accesso, scegli Download.csve salva il file in una posizione sicura. Queste informazioni verranno utilizzate successivamente per configurare il file AWS delle credenziali.

 

Per configurare le autorizzazioni per IDT (AWS CLI)

Segui questi passaggi per utilizzare la configurazione delle AWS CLI autorizzazioni per IDT per. AWS IoT Greengrass

  1. Sul tuo computer, installa e configura il file AWS CLI se non è già installato. Segui la procedura descritta in Installazione di AWS CLI nella Guida AWS Command Line Interface per l'utente.

    Nota

    AWS CLI È uno strumento open source che puoi utilizzare per interagire con AWS i servizi dalla tua shell a riga di comando.

  2. Crea la seguente politica gestita dai clienti che concede le autorizzazioni per gestire IDT e ruoli. AWS IoT Greengrass

    Linux 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

    Questo passaggio include un esempio del prompt dei comandi di Windows perché utilizza una sintassi JSON diversa rispetto ai comandi del terminale Linux, macOS o Unix.

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

  3. Crea un utente IAM e allega le autorizzazioni richieste da IDT for. AWS IoT Greengrass

    1. Crea un utente IAM. 

      aws iam create-user --user-name user-name

    2. Allega la IDTUsageMetricsIAMPermissions policy che hai creato al tuo utente IAM. Sostituiscila user-name con il tuo nome utente IAM e <account-id> nel comando con l'ID del tuo Account AWS.

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

  4. Creare una chiave di accesso segreta per l'utente.

    aws iam create-access-key --user-name user-name

    Memorizzare l'output in una posizione sicura. Utilizzerai queste informazioni in seguito per configurare il file AWS delle credenziali.

Fornire AWS credenziali per IDT

Per consentire a IDT di accedere alle tue AWS credenziali e inviare le metriche a AWS, procedi come segue:

  1. Archivia le AWS credenziali per il tuo utente IAM come variabili di ambiente o in un file di credenziali:

    1. Per utilizzare le variabili di ambiente, esegui i seguenti comandi.

      Linux or Unix
      export AWS_ACCESS_KEY_ID=access-key
export AWS_SECRET_ACCESS_KEY=secret-access-key
      Windows Command Prompt (CMD)
      set AWS_ACCESS_KEY_ID=access-key
set AWS_SECRET_ACCESS_KEY=secret-access-key
      PowerShell
      $env:AWS_ACCESS_KEY_ID="access-key"
$env:AWS_SECRET_ACCESS_KEY="secret-access-key"

    2. Per utilizzare il file delle credenziali, aggiungete le seguenti informazioni al ~/.aws/credentials file.

      [profile-name]
aws_access_key_id=access-key
aws_secret_access_key=secret-access-key

  2. Configura la auth sezione del config.json file. Per ulteriori informazioni, consulta (Facoltativo) Configura config.json.