Diagnosticare e risolvere i problemi nell'ambiente Azure Time Series Insights Gen1

Questo articolo descrive dei problemi che si possono riscontrare nell'ambiente Azure Time Series Insights. L'articolo descrive le possibili cause e le relative soluzioni.

Video

Informazioni sulle problematiche e le mitigazioni comuni di Azure Time Series Insights

Problema: non viene visualizzato alcun dato

Se non vengono visualizzati dati nello strumento di esplorazione di Azure Time Series Insights, prendere in considerazione queste cause comuni.

Motivo A: i dati dell'origine evento non sono in formato JSON

Azure Time Series Insights supporta solo dati in formato JSON. Per alcuni esempi di dati in formato JSON, vedere Forme JSON supportate.

Motivo B: alla chiave dell'origine manca un'autorizzazione obbligatoria

• Per un hub IoT in Hub IoT di Azure è necessario indicare la chiave con le autorizzazioni di connessione al servizio. Selezionare i criteri iothubowner o del servizio. Entrambi dispongono delle autorizzazioni di connessione del servizio.

  

• Per un hub eventi in Hub eventi di Azure è necessario indicare la chiave che dispone delle autorizzazioni di ascolto. I criteri read e manage funzioneranno in quanto entrambi dispongono delle autorizzazioni di ascolto.

  

Causa C: Il gruppo di consumer fornito non è esclusivo di Azure Time Series Insights

Quando si registra un hub IoT o un hub eventi, è importante impostare il gruppo di consumer che si desidera usare per leggere i dati. Questo gruppo non può essere condiviso. Se viene condiviso, l'hub IoT o l'hub eventi sottostante disconnette automaticamente in modo casuale uno dei lettori. Specificare un gruppo di consumer univoco per la lettura dei dati da parte di Azure Time Series Insights.

Causa D: è stato appena effettuato il provisioning dell'ambiente

I dati verranno visualizzati nello strumento di esplorazione di Azure Time Series Insights entro pochi minuti dalla creazione dell'ambiente e dei relativi dati.

Problema: vengono visualizzati solo alcuni dati

Quando i dati vengono visualizzati solo parzialmente e i dati sembrano in ritardo, considerare questi possibili problemi.

Motivo A: l'ambiente è limitato nelle richieste

La limitazione delle richieste è un problema comune quando gli ambienti vengono sottoposti a provisioning dopo che è stata creata un'origine evento che contiene dati. Hub IoT di Azure e Hub eventi di Azure archiviano i dati per un massimo di sette giorni. Azure Time Series Insights inizia sempre con l'evento meno recente nell'origine evento (First-In, First-Out o FIFO).

Se ad esempio nell'origine evento sono presenti 5 milioni di eventi quando ci si connette a un S1, un ambiente Azure Time Series Insights a unità singola, Azure Time Series Insights legge circa 1 milione di eventi al giorno. Potrebbe sembrare che Azure Time Series Insights riscontri cinque giorni di latenza. Tuttavia quello che accade in effetti è che l'ambiente viene limitato nelle richieste.

In presenza di eventi meno recenti nell'origine eventi, è possibile scegliere tra due approcci:

• Modificare i limiti di conservazione dell'origine eventi per eliminare gli eventi meno recenti che non si vuole visualizzare in Azure Time Series Insights.
• Eseguire il provisioning di un ambiente di dimensioni maggiori, in termini di numero di unità, per aumentare la velocità effettiva per gli eventi meno recenti. Nell'esempio precedente, se lo stesso ambiente S1 venisse esteso a cinque unità per un giorno, sarebbe possibile recuperare entro tale giorno. Se la produzione di eventi di stato costante è di circa 1 milione o meno di eventi al giorno, è possibile ridurre la capacità dell'evento tornando a una unità dopo che Azure Time Series Insights viene aggiornato.

L'applicazione della limitazione delle richieste è basata sulla capacità e sul tipo di SKU dell'ambiente. Tutte le origini evento all'interno dell'ambiente condividono questa capacità. Se l'origine evento dell'hub IoT e dell'hub eventi esegue il push dei dati oltre il limite imposto, si verificheranno una limitazione nelle richieste e un ritardo.

Il diagramma seguente mostra un ambiente Azure Time Series Insights con uno SKU S1 e una capacità pari a 3. È consentito l'ingresso di 3 milioni di eventi al giorno.

Si immagini un ambiente che inserisce messaggi da un hub eventi. Ha una velocità di ingresso giornaliera di circa 67.000 messaggi. Questa velocità si traduce approssimativamente in 46 messaggi al minuto.

• Se ogni messaggio dell'hub eventi viene appiattito a un singolo evento Azure Time Series Insights, non si verifica alcuna limitazione.
• Se ogni messaggio dell'hub eventi viene appiattito a 100 eventi Azure Time Series Insights, vengono inseriti 4.600 eventi ogni minuto.

Un ambiente SKU S1 con una capacità pari a 3 consente l'ingresso di soli 2.100 eventi al minuto (1 milione di eventi al giorno = 700 eventi al minuto in tre unità = 2.100 eventi al minuto).

Per una descrizione generale di come funziona la logica di appiattimento, vedere Forme JSON supportate.

Risoluzioni consigliate per la limitazione eccessiva

Per correggere il ritardo, aumentare la capacità SKU dell'ambiente. Per altre informazioni, leggere Ridimensiona un ambiente Azure Time Series Insights.

Motivo B: l'inserimento iniziale dei dati storici rallenta in ingresso

Se ci si connette a un'origine evento esistente, è probabile che l'hub IoT o l'hub eventi contenga già dati. L'ambiente inizia a eseguire il pull dei dati dall'inizio del periodo di conservazione dei messaggi dell'origine evento. Non è possibile eseguire l'override di questa elaborazione predefinita. È possibile coinvolgere la limitazione delle richieste. La limitazione delle richieste può richiedere tempo per recuperare mentre si inseriscono i dati cronologici.

Risoluzioni consigliate per un inserimento iniziale di grandi quantità di dati

Per correggere il ritardo:

1. Aumentare la capacità SKU fino al valore massimo consentito (10 in questo caso). Dopo aver aumentato la capacità, il processo di inserimento inizia a velocizzarsi. La maggiore capacità sarà addebitata. Per vedere tale rapidità, è possibile visualizzare il grafico della disponibilità nello strumento di esplorazione di Time Series Insights di Azure.

2. Dopo avere recuperato il ritardo, diminuire nuovamente la capacità SKU alla velocità di ingresso normale.

Problema: i dati sono stati visualizzati in precedenza ma non sono più visualizzati

Se Azure Time Series Insights non inserisce più dati, ma gli eventi sono ancora in streaming nell'hub Iot o nell'hub eventi, prendere in considerazione questa potenziale causa.

Causa A: La chiave di accesso dell'hub è stata rigenerata e l'ambiente deve essere aggiornato

Questo problema si verifica quando la chiave specificata quando è stata creata l'origine evento non è più valida. I dati di telemetria vengono visualizzati nell'hub, ma non vengono ricevuti messaggi in ingresso in Azure Time Series Insights. Se non si è certi che la chiave sia stata rigenerata, è possibile cercare "Create or Update Namespace Authorization Rules" nel log attività dell'hub eventi. Per un hub IoT, cercare "Creare o aggiornare la risorsa IotHub".

Per aggiornare l'ambiente Azure Time Series Insights con la nuova chiave, aprire la risorsa hub nel portale di Azure e copiare la nuova chiave. Passare alla risorsa di Azure Time Series Insights e selezionare Origini eventi:

Selezionare l'origine evento o le origini da cui l'inserimento è stato arrestato, incollare la nuova chiave e quindi selezionare Salva:

Problema: l'impostazione del nome della proprietà Timestamp dell'origine evento non funziona

Assicurarsi che il valore della proprietà timestamp, proveniente dall'origine evento come stringa JSON, abbia il formato aaaa-MM-ggTHH:mm:ss.FFFFFFFK. Ecco un esempio: 2008-04-12T12:53Z.

Tenere presente che il nome della proprietà timestamp fa distinzione tra maiuscole e minuscole.

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 Azure Time Series Insights. All'interno dello strumento di esplorazione di Time Series Insights fi Azure, 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 Esplora eventi.

L'intestazione della prima colonna deve essere il nome della proprietà timestamp. Accanto alla parola Timestamp verrà visualizzato ($ts).

I valori seguenti non verranno visualizzati:

• (abc): indica che Azure Time Series Insights sta leggendo i valori dei dati come stringhe.
• Icona Calendario: indica che Azure Time Series Insights legge i valori dei dati come valori datetime.
• #: indica che Azure Time Series Insights sta leggendo i valori dei dati come numeri interi.

Passaggi successivi

• Informazioni su come ridurre la latenza in Azure Time Series Insights.

• Informazioni su come scalare l'ambiente Azure Time Series Insights | Microsoft Docs.