Guida alla risoluzione dei problemi di indicizzazione del parco istanze

Risoluzione dei problemi delle query di aggregazione per il servizio di indicizzazione del parco istanze

Se riscontri errori di mancata corrispondenza dei caratteri, puoi utilizzare CloudWatch Logs per risolvere il problema. CloudWatch I registri devono essere abilitati prima che i registri vengano scritti dal servizio Fleet Indexing. Per ulteriori informazioni, consulta Monitoraggio tramite log AWS IoT CloudWatch .

Per eseguire query di aggregazione su campi non gestiti, devi specificare un campo definito nell'argomento customFields passato a UpdateIndexingConfiguration o update-indexing-configuration. Se il valore del campo non è coerente con il tipo di dati di campo configurato, questo valore viene ignorato quando si esegue una query di aggregazione.

Se un campo non può essere indicizzato a causa di un tipo non corrispondente, il servizio Fleet Indexing invia un log degli errori a Logs. CloudWatch Il log degli errori contiene il nome del campo, il valore che non può essere convertito e il nome dell'oggetto per il dispositivo. Di seguito è riportato un esempio di log degli errori.

{
  "timestamp": "2017-02-20 20:31:22.932",
  "logLevel": "ERROR",
  "traceId": "79738924-1025-3a00-a669-7bec69f7f07a",
  "accountId": "000000000000",
  "status": "SucceededWithIssues",
  "eventType": "IndexingCustomFieldFailed",
  "thingName": "thing0",
  "failedCustomFields": [
    {
      "Name": "attributeName1",
      "Value": "apple",
      "ExpectedType": "String"
    },
    {
      "Name": "attributeName2",
      "Value": "2",
      "ExpectedType": "Boolean"
    }
  ]
}

Se un dispositivo è stato disconnesso per circa un'ora, il valore timestamp dello stato connettività potrebbe mancare. Per le sessioni persistenti, il valore potrebbe mancare dopo che un client è stato disconnesso più a lungo del periodo configurato time-to-live (TTL) per la sessione persistente. I dati sulo stato della connessione sono indicizzati solo per le connessioni in cui l'ID client dispone di un nome oggetto corrispondente. (L'ID client è il valore utilizzato per connettere un dispositivo.) AWS IoT Core

Risoluzione dei problemi di configurazione dell'indicizzazione del parco istanze

Impossibile eseguire il downgrade della configurazione di indicizzazione del parco istanze

Il downgrade della configurazione di indicizzazione del parco istanze non è supportato quando desideri rimuovere le origini dati associate a un parametro del parco istanze o a un gruppo dinamico.

Ad esempio, se la configurazione di indicizzazione include dati di registro, dati shadow e dati di connettività ed esiste un parametro del parco istanze con la query thingName:TempSensor* AND shadow.desired.temperature>80, l'aggiornamento della configurazione di indicizzazione per includere solo i dati del registro genera un errore.

La modifica dei campi personalizzati utilizzati dai parametri esistenti del parco istanze non è supportata.

Impossibile aggiornare la configurazione di indicizzazione a causa di parametri del parco istanze o gruppi dinamici incompatibili

Se non è possibile aggiornare la configurazione di indicizzazione a causa di parametri del parco istanze o gruppi dinamici incompatibili, elimina il parametri del parco istanze o i gruppi dinamici incompatibili prima di aggiornare la configurazione di indicizzazione.

Risoluzione dei problemi relativi all'indicizzazione della posizione e alle geoquery

Per risolvere gli errori di tipo non corrispondenti nell'indicizzazione della posizione e nelle geoquery, puoi abilitare i log. CloudWatch Per ulteriori informazioni su come monitorare l'utilizzo, segui la guida. AWS IoT CloudWatch step-by-step

Quando si indicizzano i dati sulla posizione utilizzando le geoquery, i campi di posizione specificati geoLocations devono corrispondere ai campi di posizione a cui si passa. UpdateIndexingConfiguration In caso di mancata corrispondenza, l'indicizzazione della flotta invia un errore di tipo non corrispondente a. CloudWatch Il log degli errori contiene il nome del campo, il valore che non può essere convertito e il nome dell'oggetto per il dispositivo.

Di seguito è riportato un esempio di log degli errori.

{
"timestamp": "2023-11-09 01:39:43.466",
    "logLevel": "ERROR",
    "traceId": "79738924-1025-3a00-a669-7bec69f7f07a",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "IndexingGeoLocationFieldFailed",
    "thingName": "thing0",
    "failedGeolocationFields": [
        {
"Name": "attributeName1",
            "Value": "apple",
            "ExpectedType": "Geopoint"
        }
    ],
    "reason": "failed to index the field because it could not be converted to one of the expected geoLocation formats."
}

Per ulteriori informazioni, consulta Indicizzazione dei dati sulla posizione.

Risoluzione dei problemi dei parametri del parco istanze

Impossibile visualizzare i punti dati in CloudWatch

Se riesci a creare una metrica del parco dati ma non riesci a visualizzarne i punti dati CloudWatch, è probabile che tu non abbia nulla che soddisfi i criteri della stringa di query.

Visualizza questo comando di esempio per creare un parametro del parco istanze:

aws iot create-fleet-metric --metric-name "example_FM" --query-string "thingName:TempSensor* AND attributes.temperature>80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count

Se non si dispone di un oggetto che soddisfa i criteri della stringa di query --query-string "thingName:TempSensor* AND attributes.temperature>80":

• Convalues=count, sarai in grado di creare una metrica della flotta e ci saranno punti dati in cui mostrare. CloudWatch I punti dati del valore count è sempre 0.

• Con values other thancount, sarai in grado di creare una metrica della flotta ma non visualizzerai la metrica della flotta CloudWatch e non ci saranno punti dati da mostrare. CloudWatch