Diagnosticare e risolvere i problemi di un ambiente Azure Time Series Insights Gen2

Nota

Il servizio Time Series Insights (TSI) non sarà più supportato dopo marzo 2025. Prendere in considerazione la migrazione degli ambienti TSI esistenti alle soluzioni alternative non appena possibile. Per altre informazioni sulla deprecazione e la migrazione, visitare la documentazione.

Questo articolo riepiloga diversi problemi comuni che potrebbero verificarsi quando si lavora con l'ambiente Azure Time Series Insights Gen2. L'articolo descrive anche possibili cause e soluzioni per ogni problema.

Problema: non è possibile trovare l'ambiente in Gen2 Explorer

Questo problema potrebbe verificarsi se non si dispone delle autorizzazioni per accedere all'ambiente Time Series Insights. Gli utenti necessitano di un ruolo di lettore a livello di accesso per visualizzare l'ambiente Time Series Insights. Per verificare i livelli di accesso correnti e concedere l'accesso aggiuntivo, passare alla sezione Criteri di accesso ai dati nella risorsa Time Series Insights nella portale di Azure.

Problema: nessun dato viene visualizzato in Esplora gen2

Esistono diversi motivi comuni per cui i dati potrebbero non essere visualizzati in Esplora Azure Time Series Insights Gen2.

• L'origine evento potrebbe non ricevere correttamente i dati.

  Verificare che l'origine evento, ovvero un hub eventi o un hub IoT, riceva dati da tag o istanze. Per verificare ciò, passare alla pagina di panoramica della risorsa nel portale di Azure.

  

• I dati dell'origine evento non sono in formato JSON.

  Time Series Insights supporta solo dati in formato JSON. Per esempi JSON, leggere Forme JSON supportate.

• Alla chiave dell'origine evento manca un'autorizzazione obbligatoria.

  • Per un hub IoT è necessario fornire la chiave con l'autorizzazione di connessione al servizio.

    

    • Entrambi i criteri iothubowner e servizio funzionano perché dispongono dell'autorizzazione di connessione del servizio .

  • Per un hub eventi è necessario fornire la chiave con l'autorizzazione di ascolto.

    

    • Entrambi i criteri di lettura e gestione funzionano perché dispongono dell'autorizzazione Listen .

• Il gruppo di consumer specificato non è esclusivo di Time Series Insights.

  Durante la registrazione di un hub IoT o un hub eventi viene specificato il gruppo di consumer da usare per la lettura dei dati. Questo gruppo di consumer deve essere univoco per ogni ambiente. Se viene condiviso, l'hub eventi sottostante disconnette automaticamente uno dei lettori in modo casuale. Specificare un gruppo di consumer univoco per la lettura dei dati da parte di Time Series Insights.

• La proprietà ID di Time Series specificata al momento del provisioning è errata, mancante o null.

  Questo problema può verificarsi se la proprietà ID di Time Series non è configurata in modo corretto al momento del provisioning dell'ambiente. Per altre informazioni, vedere Procedure consigliate per la scelta di un ID serie temporale. In questo momento, non è possibile aggiornare un ambiente Time Series Insights esistente per usare un ID Time Series differente.

Problema: alcuni dati mostrano, ma alcuni sono mancanti

È possibile che si stia inviando i dati senza ID Time Series.

• Questo problema può verificarsi quando si inviano gli eventi senza il campo ID Time Series nel payload. Per altre informazioni, vedere Forme JSON supportate.

• Questo problema può verificarsi perché l'ambiente è limitato nelle richieste.

  Nota

  In questo momento Time Series Insights supporta una velocità massima di inserimento di 1 Mbps.

Problema: i dati sono stati visualizzati, ma ora l'inserimento è stato arrestato

• La chiave di origine evento potrebbe essere stata rigenerata e l'ambiente Gen2 necessita della nuova chiave di origine eventi.

Questo problema si verifica quando la chiave fornita durante la creazione dell'origine evento non è più valida. I dati di telemetria vengono visualizzati nell'hub, ma non vengono ricevuti messaggi in ingresso in Time Series Insights. Se non si è certi che la chiave sia stata rigenerata, è possibile cercare il log attività dell'hub eventi per "Creare o aggiornare le regole di autorizzazione dello spazio dei nomi" o cercare "Creare o aggiornare la risorsa IotHub" per l'hub IoT.

Per aggiornare l'ambiente Time Series Insights Gen2 con la nuova chiave aprire la risorsa hub nella portale di Azure e copiare la nuova chiave. Passare alla risorsa TSI e fare clic su Origini eventi.

Selezionare le origini eventi da cui l'inserimento è stato arrestato, incollare nella nuova chiave e fare clic su Salva.

Problema: il nome della proprietà Timestamp dell'origine evento non funziona

Verificare che il nome e il valore siano conformi alle regole seguenti:

• Il nome della proprietà Timestamp fa distinzione fra maiuscole e minuscole.
• Il valore della proprietà Timestamp proveniente dall'origine evento come stringa JSON ha il formato yyyy-MM-ddTHH:mm:ss.FFFFFFFK. Un esempio di tale stringa è "2008-04-12T12:53Z".

Il modo più semplice per assicurarsi che il nome della proprietà Timestamp venga acquisito e che funzioni correttamente consiste nell'usare Time Series Insights Gen2 Explorer. In Time Series Insights Gen2 Explorer usare il grafico per selezionare un periodo di tempo dopo aver specificato il nome della proprietà Timestamp. Fare clic con il pulsante destro del mouse sulla selezione e selezionare l'opzione Esplora eventi. L'intestazione della prima colonna contiene il nome della proprietà Timestamp. Deve avere ($ts) accanto alla parola Timestamp, invece di:

• (abc), che indica che Time Series Insights legge i valori dei dati come stringhe.
• Icona del calendario , che indica che Time Series Insights legge il valore dei dati come datetime.
• #, che indica che Time Series Insights legge i valori dei dati come integer.

Se la proprietà Timestamp non è specificata in modo esplicito, viene usato come timestamp predefinito l'hub IoT di un evento o l'hub eventi Enqueued Time.

Problema: non è possibile visualizzare i dati dall'archivio ad accesso frequente in Esplora risorse

• È possibile che sia stato effettuato il provisioning dell'archivio ad accesso frequente di recente e che i dati siano ancora in flusso.
• Potrebbe essere stato eliminato l'archivio ad accesso frequente, nel qual caso si sarebbero persi i dati.

Problema: non è possibile visualizzare o modificare il modello Time Series

• È possibile accedere a un ambiente Time Series Insights S1 o S2.

  I modelli di serie temporali sono supportati solo negli ambienti con pagamento in base al consumo. Per altre informazioni su come accedere all'ambiente S1 o S2 da Time Series Insights Gen2 Explorer, vedere Visualizzare i dati in Esplora risorse.

  

• Non si dispone delle autorizzazioni per visualizzare e modificare il modello.

  Gli utenti devono accedere a livello di collaboratore per modificare e visualizzare il modello Time Series. Per verificare i livelli di accesso correnti e concedere l'accesso aggiuntivo, passare alla sezione Criteri di accesso ai dati nella risorsa Time Series Insights nell'portale di Azure.

Problema: tutte le istanze di Esplora gen2 non hanno un elemento padre

Questo problema potrebbe verificarsi se l'ambiente non ha una gerarchia di modelli time series definita. Per altre informazioni, vedere come usare i modelli time series.

Passaggi successivi

• Informazioni su come usare i modelli time series.

• Informazioni sulle forme JSON supportate.

• Esaminare la pianificazione e i limiti in Azure Time Series Insights Gen2.