Caricamento dei log lato dispositivo tramite regole AWS IoT

Puoi utilizzare il motore AWS IoT delle regole per caricare i record di registro dai file di registro esistenti sul dispositivo (log di sistema, applicazione e dispositivo-client) su Amazon. CloudWatch Quando i log lato dispositivo vengono pubblicati su un MQTT argomento, l'azione Logs rules trasferisce i messaggi in Logs. CloudWatch CloudWatch Questo processo descrive come caricare i log dei dispositivi in batch utilizzando il parametro batchMode di azione delle regole attivato (impostato su true).

Per iniziare a caricare i log lato dispositivo su, completa i seguenti prerequisiti. CloudWatch

Prerequisiti

Prima di iniziare, esegui queste attività:

• Crea almeno un dispositivo IoT di destinazione registrato AWS IoT Core come AWS IoT oggetto. Per ulteriori informazioni, consulta Crea un oggetto.

• Determina lo spazio MQTT tematico per l'inserimento e gli errori. Per ulteriori informazioni sugli MQTT argomenti e sulle convenzioni di denominazione consigliate, consulta la sezione degli Argomenti MQTT MQTTargomenti in Caricare i log lato dispositivo su Amazon. CloudWatch

Per ulteriori informazioni su questi prerequisiti, consulta Caricare i log lato dispositivo su. CloudWatch

CloudWatch Creazione di un gruppo di log

Per creare un gruppo di CloudWatch log, completare i seguenti passaggi. Scegliete la scheda appropriata a seconda che preferiate eseguire i passaggi tramite AWS Command Line Interface (AWS CLI). AWS Management Console

AWS Management Console

Per creare un gruppo di CloudWatch log utilizzando AWS Management Console

1. Aprire AWS Management Console e accedere a CloudWatch.

2. Nel pannello di navigazione, scegli Logs (Log), quindi Log groups (Gruppi di log).

3. Scegliere Crea gruppo di log.

4. Aggiorna il campo Log group name (Nome del gruppo di log) e, facoltativamente, aggiorna i campi Retention setting (Impostazione conservazione).

5. Scegli Create (Crea) .

AWS CLI

Per creare un gruppo di CloudWatch log utilizzando il AWS CLI

1. Per creare il gruppo di log, esegui il seguente comando. Per ulteriori informazioni, vedere create-log-group nella Guida ai comandi AWS CLI v2.

   Sostituisci il nome del gruppo di log nell'esempio (uploadLogsGroup) con il tuo nome preferito.

   aws logs create-log-group --log-group-name uploadLogsGroup

2. Per confermare che il gruppo di log è stato creato correttamente, esegui il seguente comando.

   aws logs describe-log-groups --log-group-name-prefix uploadLogsGroup

   Output di esempio:

   {
       "logGroups": [
           {
               "logGroupName": "uploadLogsGroup",
               "creationTime": 1674521804657,
               "metricFilterCount": 0,
               "arn": "arn:aws:logs:us-east-1:111122223333:log-group:uploadLogsGroup:*",
               "storedBytes": 0
           }
       ]
   }

Creazione di una regola dell'argomento

Per creare una AWS IoT regola, completa i passaggi seguenti. Scegliete la scheda appropriata a seconda che preferiate eseguire i passaggi tramite AWS Command Line Interface (AWS CLI). AWS Management Console

AWS Management Console

Per creare una regola tematica utilizzando AWS Management Console

1. Apri l'hub delle regole.

   1. Apri AWS Management Console e vai a AWS IoT.

   2. Nella barra di navigazione, scegli Message routing (Instradamento dei messaggi) e quindi Rules (Regole).

   3. Scegli Crea regola.

2. Inserisci le proprietà della regola.

   1. Inserisci un nome della regola alfanumerico.

   2. (Facoltativo) Compila i campi Rule description (Descrizione regola) e Tags (Tag).

   3. Scegli Next (Successivo).

3. Inserisci una SQL dichiarazione.

   1. Inserite una SQL dichiarazione utilizzando l'MQTTargomento che avete definito per l'ingestione.

      Ad esempio, SELECT * FROM '$aws/rules/things/thing_name/logs'.

   2. Scegli Next (Successivo).

4. Inserisci le azioni delle regole.

   1. Nel menu Azione 1, scegliete CloudWatch registri.

   2. Scegli l'opzione Log group name (Nome del gruppo di log) quindi seleziona il gruppo di log che hai creato.

   3. Seleziona Use batch mode (Utilizza la modalità batch).

   4. Specificate il IAM ruolo della regola.

      Se hai un IAM ruolo per la regola, procedi come segue.

      1. Nel menu del IAMruolo, scegli il tuo IAM ruolo.

      Se non hai un IAM ruolo per la regola, procedi come segue.

      1. Scegli Create new role (Crea nuovo ruolo).

      2. In Role name (Nome ruolo), inserisci un nome univoco e scegli Create (Crea).

      3. Verifica che il nome del IAM ruolo sia corretto nel campo del IAMruolo.

   5. Scegli Next (Successivo).

5. Rivedi la configurazione del modello.

   1. Rivedi le impostazioni del modello di processo per verificare che siano corrette.

   2. Al termine, selezionare Create (Crea).

AWS CLI

Per creare un IAM ruolo e una regola tematica utilizzando AWS CLI

1. Creare un IAM ruolo che conceda i diritti sulla AWS IoT regola.

   1. Creare una policy IAM.

      Per creare una IAM politica, esegui il comando seguente. Assicurati di aggiornare il valore del parametro policy-name. Per ulteriori informazioni, vedere create-policynella Guida ai comandi AWS CLI v2.

      Nota

      Se stai utilizzando un sistema operativo Microsoft Windows, potrebbe essere necessario sostituire l'indicatore di fine riga (\) con un segno di spunta (`) o un altro carattere.

      aws iam create-policy \
          --policy-name uploadLogsPolicy \
          --policy-document \
      '{
          "Version": "2012-10-17",
          "Statement": {
              "Effect": "Allow",
              "Action": [
                  "iot:CreateTopicRule",
                  "iot:Publish",
                  "logs:CreateLogGroup",
                  "logs:CreateLogStream",
                  "logs:PutLogEvents",
                  "logs:GetLogEvents"
              ],
              "Resource": "*"
          }
      }'

   2. Copia la policy ARN dall'output in un editor di testo.

      Output di esempio:

      {
          "Policy": {
              "PolicyName": "uploadLogsPolicy",
              "PermissionsBoundaryUsageCount": 0,
              "CreateDate": "2023-01-23T18:30:10Z",
              "AttachmentCount": 0,
              "IsAttachable": true,
              "PolicyId": "AAABBBCCCDDDEEEFFFGGG",
              "DefaultVersionId": "v1",
              "Path": "/",
              "Arn": "arn:aws:iam::111122223333:policy/uploadLogsPolicy",
              "UpdateDate": "2023-01-23T18:30:10Z"
          }
      }

   3. Crea una politica in materia di IAM ruolo e fiducia.

      Per creare una IAM politica, esegui il comando seguente. Assicurati di aggiornare il valore del parametro role-name. Per ulteriori informazioni, vedere create-rolenella Guida ai comandi AWS CLI v2.

      aws iam create-role \
      --role-name uploadLogsRole \
      --assume-role-policy-document \
      '{
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Sid": "",
                  "Effect": "Allow",
                  "Principal": {
                      "Service": "iot.amazonaws.com"
                  },
                  "Action": "sts:AssumeRole"
              }
          ]
      }'
      

   4. Allega la IAM politica alla regola.

      Per creare una IAM politica, esegui il comando seguente. Assicurati di aggiornare i valori dei parametri role-name e policy-arn. Per ulteriori informazioni, vedere attach-role-policynella Guida ai comandi AWS CLI v2.

      aws iam attach-role-policy \
      --role-name uploadLogsRole \
      --policy-arn arn:aws:iam::111122223333:policy/uploadLogsPolicy

   5. Rivedi il ruolo.

      Per confermare che il IAM ruolo è stato creato correttamente, esegui il comando seguente. Assicurati di aggiornare il valore del parametro role-name. Per ulteriori informazioni, vedere get-rolenella Guida ai comandi AWS CLI v2.

      aws iam get-role --role-name uploadLogsRole

      Output di esempio:

      {
          "Role": {
              "Path": "/",
              "RoleName": "uploadLogsRole",
              "RoleId": "AAABBBCCCDDDEEEFFFGGG",
              "Arn": "arn:aws:iam::111122223333:role/uploadLogsRole",
              "CreateDate": "2023-01-23T19:17:15+00:00",
              "AssumeRolePolicyDocument": {
                  "Version": "2012-10-17",
                  "Statement": [
                      {
                          "Sid": "Statement1",
                          "Effect": "Allow",
                          "Principal": {
                              "Service": "iot.amazonaws.com"
                          },
                          "Action": "sts:AssumeRole"
                      }
                  ]
              },
              "Description": "",
              "MaxSessionDuration": 3600,
              "RoleLastUsed": {}
          }
      }

2. Crea una regola AWS IoT tematica in. AWS CLI

   1. Per creare una regola AWS IoT tematica, esegui il comando seguente. Assicurati di aggiornare i valori dei parametri --rule-name, istruzione sql, description, roleARN e logGroupName. Per ulteriori informazioni, vedere create-topic-rulenella Guida ai comandi AWS CLI v2.

      aws iot create-topic-rule \
      --rule-name uploadLogsRule \
      --topic-rule-payload \
      	'{
      		"sql":"SELECT * FROM 'rules/things/thing_name/logs'",
      		"description":"Upload logs test rule",
      		"ruleDisabled":false,
      		"awsIotSqlVersion":"2016-03-23",
      		"actions":[
      			{"cloudwatchLogs":
      				{"roleArn":"arn:aws:iam::111122223333:role/uploadLogsRole",
      				"logGroupName":"uploadLogsGroup",
      				"batchMode":true}
      				}
      			]
      }'

   2. Per confermare che la regola è stata creata correttamente, esegui il seguente comando. Assicurati di aggiornare il valore del parametro role-name. Per ulteriori informazioni, vedere get-topic-rulenella Guida ai comandi AWS CLI v2.

      aws iot get-topic-rule --rule-name uploadLogsRule

      Output di esempio:

      {
          "ruleArn": "arn:aws:iot:us-east-1:111122223333:rule/uploadLogsRule",
          "rule": {
              "ruleName": "uploadLogsRule",
              "sql": "SELECT * FROM rules/things/thing_name/logs",
              "description": "Upload logs test rule",
              "createdAt": "2023-01-24T16:28:15+00:00",
              "actions": [
                  {
                      "cloudwatchLogs": {
                          "roleArn": "arn:aws:iam::111122223333:role/uploadLogsRole",
                          "logGroupName": "uploadLogsGroup",
                          "batchMode": true
                      }
                  }
              ],
              "ruleDisabled": false,
              "awsIotSqlVersion": "2016-03-23"
          }
      }

Invio dei log lato dispositivo a AWS IoT

Per inviare i log lato dispositivo a AWS IoT

1. A cui inviare i log cronologici AWS IoT, comunica con i tuoi dispositivi per garantire quanto segue.

   • Le informazioni di log vengono inviate allo spazio dei nomi degli argomenti corretto come specificato nella sezione Prerequisiti di questa procedura.

     Ad esempio, $aws/rules/things/thing_name/logs.

   • Il payload del MQTT messaggio è formattato correttamente. Per ulteriori informazioni sull'MQTTargomento e sulla convenzione di denominazione consigliata, consulta la sezione all'Argomenti MQTTinterno. Carica i log lato dispositivo su Amazon CloudWatch

2. Conferma che i MQTT messaggi siano stati ricevuti all'interno del AWS IoT MQTT client.

   1. Apri AWS Management Console e vai a AWS IoT.

   2. Per visualizzare il client di MQTT test, nella barra di navigazione, scegli Test, MQTTtest client.

   3. In Subscribe to a topic (Sottoscrizione a un argomento), Topic filter (Filtro di argomenti), inserisci lo spazio dei nomi dell'argomento.

   4. Scegliere Subscribe (Effettua sottoscrizione).

      MQTTi messaggi vengono visualizzati nella tabella Sottoscrizioni e argomenti, come illustrato di seguito. La visualizzazione di questi messaggi può richiedere fino a cinque minuti.

      

Visualizzazione dei dati di log

Per esaminare i record di registro in Logs CloudWatch

1. Apri e AWS Management Console accedi a. CloudWatch

2. Nella barra di navigazione, scegli Logs (Log), Logs Insights (Informazioni dettagliate sui log).

3. Nel menu Seleziona gruppi di log, scegli il gruppo di log specificato nella AWS IoT regola.

4. Nella pagina Logs insights (Informazioni dettagliate sui log), scegli Run query (Esegui query).