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

Nota

Il servizio Time Series Insights verrà ritirato il 7 luglio 2024. Considerare di eseguire la migrazione degli ambienti esistenti a soluzioni alternative il prima possibile. Per altre informazioni sulla deprecazione e sulla migrazione, visitare la nostra documentazione.

Questo articolo riepiloga i diversi problemi comuni che possono verificarsi quando si lavora nell'ambiente di 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 può verificarsi se non si dispone delle autorizzazioni per accedere all'ambiente di 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 un accesso aggiuntivo, navigare alla sezione relativa ai Criteri di accesso ai dati per la risorsa Time Series Insights nel portale di Azure.

Problema: nessun dato viene visualizzato in Gen2 Explorer

Esistono diversi motivi comuni per cui i dati potrebbero non essere visualizzati nello strumento di esplorazione 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 alcuni esempi di dati in formato JSON, consultare 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 il servizio funzionano perché dispongono dell'autorizzazione di connessione del servizio.

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

    

    • I criteri Lettura eGestione funzionano perché dispongono dell'autorizzazione Listen ("In ascolto").

• 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, consultare Best practices for choosing a Time Series ID (Procedure consigliate per la scelta di un ID Time Series). In questo momento, non è possibile aggiornare un ambiente Time Series Insights esistente per usare un ID Time Series differente.

Problema: alcuni dati vengono visualizzati, mentre altri risultano 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, consultare Forme JSON supportate.

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

  Nota

  Attualmente, Time Series Insights supporta una velocità di inserimento massima di 1 MB/s.

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 evento.

Questo problema si verifica quando la chiave specificata 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 "Crea o aggiorna regole di autorizzazione dello spazio dei nomi" nel log attività di Hub eventi oppure cercare "Crea o aggiorna risorsa IotHub" per l'hub IoT.

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

Selezionare le origini evento da cui l'inserimento è stato arrestato, incollare la 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 che proviene dall'origine evento come stringa JSON deve avere il formato yyyy-MM-ddTHH:mm:ss.FFFFFFFK. Un esempio di tale stringa è "2008-04-12T12:53Z".

Il modo più semplice per garantire l'acquisizione e il corretto funzionamento del nome della proprietà Timestamp consiste nell'usare lo strumento di esplorazione di Time Series Insights Gen2. All'interno dello strumento di esplorazione di Time Series Insights Gen2, usando il grafico, 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.
• L'icona del calendario, che indica che Time Series Insights legge i valori 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, l'hub IoT o hub eventi di un evento viene ora usato come timestamp predefinito.

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 continuino a essere trasmessi.
• È possibile che sia 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 Time Series sono supportati solo negli ambienti con pagamento in base al consumo. Per altre informazioni su come accedere all'ambiente S1 o S2 dallo strumento di esplorazione di Azure Time Series Insights Gen2, consultare Visualizzare i dati nello strumento di esplorazione.

  

• 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 un accesso aggiuntivo, navigare alla sezione relativa ai Criteri di accesso ai dati per la risorsa Time Series Insights nel portale di Azure.

Problema: tutte le istanze di Gen2 Explorer non dispongono di un elemento padre

Questo problema può verificarsi se l'ambiente non dispone di una gerarchia di modelli Time Series definita. Per altre informazioni, vedere come usare i modelli Time Series.

Passaggi successivi

• Leggere le 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.