Definizione del modello ThingWorx in Composer > Archiviazione dati > Provider di persistenza > Utilizzo di InfluxDB come provider di persistenza > Configurazione di Influx2PersistenceProviderPackage
Configurazione di Influx2PersistenceProviderPackage
Per configurare Influx2PersistenceProviderPackage, attenersi alla procedura descritta di seguito.
1. In ThingWorx Composer creare un nuovo provider di persistenza.
2. Nel campo Package provider di persistenza selezionare Influx2PersistenceProviderPackage.
3. Fare clic su Salva.
4. Fare clic sulla scheda Configurazione, configurare le informazioni di connessione in base alle esigenze, quindi salvare. Fare riferimento alle opzioni di configurazione nelle tabelle riportate di seguito. Se si utilizza un'istanza del provider di persistenza (creata utilizzando il package del provider di persistenza InfluxDB) come provider di persistenza di default, è possibile modificare le impostazioni di configurazione delle code di stream e stream di valori riportate di seguito, che verranno applicate a tutti gli stream e stream di valori. Non è possibile modificare queste impostazioni per uno stream o uno stream di valori specifico.
* 
Quando si cambia il provider di persistenza di uno stream di valori (ad esempio si passa da ThingworxPersistenceProvider a InfluxPersistenceProviderPackage), qualsiasi oggetto che implementi uno stream di valori deve chiamare il servizio RestartThing per recuperare le voci scritte nel nuovo provider di persistenza. Se gli oggetti non vengono riavviati, le voci potrebbero essere scritte nel database, ma non vengono recuperate fino al riavvio dell'oggetto.
Informazioni di connessione per Influx 2.x
Nome
Descrizione
Valore di default
URL connessione
L'URL del database da cui le connessioni devono essere acquisite.
http://localhost:8086
Token
Token di sicurezza per l'accesso al sistema, utilizzato al posto della password (esattamente come una chiave di accesso).
Nome organizzazione
Nome dell'organizzazione
Nome bucket
Nome del bucket di dati (schema in cui sono memorizzati tutti i dati).
Creazione automatica bucket
Se è impostata su true, crea il bucket specificato in bucketName, se non esiste già. In caso contrario, si verifica un errore se il bucket non esiste.
False
Periodo di conservazione (giorni)
Il numero di giorni in cui dati vengono conservati, trascorsi i quali vengono eliminati. Il valore di default 0 prevede che i dati vengano mantenuti per sempre.
0
Dimensione batch
Si tratta della dimensione batch utilizzata dal client Influx. Invia sempre i punti dati in batch per migliorare le prestazioni. Si somma alla dimensione batch stream. Quando il numero di punti dati della dimensione batch è pronto per l'invio, invia i dati a Influx.
* 
Il valore non è in uso e verrà rimosso in una release futura.
1000
Intervallo di scaricamento
Indica la frequenza con cui il client Influx esegue lo scaricamento dei dati se non hanno raggiunto la dimensione batch. Il valore è specificato in millisecondi.
* 
Il valore non è in uso e verrà rimosso in una release futura.
1000 o una volta al secondo
Dimensione recupero dati da provider di persistenza
Conteggio delle righe da recuperare in batch invece di memorizzare nella cache tutte le righe sul lato client.
5000
Timeout connessione
Tempo concesso per tentare una connessione a Influx. Il valore è specificato in secondi.
10
Timeout lettura
Tempo concesso per leggere i dati da Influx per una richiesta. Il valore è specificato in secondi.
10
Timeout scrittura
Tempo concesso per provare a scrivere i dati in Influx. Il valore è specificato in secondi.
* 
Per InFluxDB Cloud, PTC consiglia di impostare il valore di Timeout scrittura su 20 secondi.
20
Livello di registrazione
Il livello di registrazione del client Influx e i log vengono inviati all'output della console. I valori possono essere NONE, BASIC, HEADERS o BODY e ogni livello fornisce informazioni aggiuntive.
NONE
Impostazioni di Elaborazione stream per Influx 2.x
Nome
Descrizione
Tipo di base
Valore di default
Dimensione max coda
Numero massimo di voci dello stream da mettere in coda. Una volta raggiunto il valore specificato, le voci successive vengono rifiutate.
Number
1000000
Tempo max di attesa prima di scaricare il buffer dello stream (millisec)
Numero di millisecondi che il sistema attende prima di scaricare il buffer dello stream.
Number
2000
Numero di thread di elaborazione
Numero dei thread di elaborazione dedicati allo stream.
* 
Il provider InfluxPersistenceProviderPackage funziona meglio con un numero minore di thread. È altamente ottimizzato per gestire i dati da un numero inferiore di canali.
Per quanto riguarda Influx2PersistenceProviderPackage, non è più il caso. PTC consiglia di aumentare il numero di thread per un throughput migliore. Per InfluxDB Cloud, PTC consiglia di aumentare il valore di Numero di thread di elaborazione a 10, Dimensione max coda a 100000 e Numero max di scritture dello stream di valori da elaborare in blocco a 25000, per raggiungere un throughput di 80.000 wps.
Number
10
Numero max di elementi prima di scaricare il buffer dello stream
Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream.
Number
1000
Numero max di scritture dello stream da elaborare in blocco
Numero massimo di scritture dello stream da elaborare in un unico blocco.
Number
25000
Numero max di scritture dello stream da elaborare
Numero di nuovi tentativi di scrittura di batch in caso di errore di scrittura.
* 
Il nuovo tentativo non è immediato, ma si verifica al tentativo di scrittura successivo, come specificato dall'impostazione di configurazione Frequenza analisi stato buffer (millisec). I tentativi di ripetizione possono risolvere il problema di brevi interruzioni momentanee della rete, ma non sono efficaci in caso di lunghi periodi di assenza di connessione. Se la frequenza con cui arrivano i dati non è elevata e si necessita di un intervallo di tempo maggiore tra i tentativi di ripetizione, è possibile modificare l'impostazione Frequenza analisi stato buffer (millisec) per ridurre la frequenza dei tentativi di scrittura.
Frequenza analisi stato buffer (millisec)
Lo stato del buffer viene controllato in base al valore della frequenza specificata in millisecondi.
Number
5
Impostazioni di Elaborazione stream di valori per Influx 2.x
Nome
Descrizione
Tipo di base
Valore di default
Dimensione max coda
Numero massimo di voci dello stream di valori da mettere in coda. Una volta raggiunto il valore specificato, le voci seguenti vengono rifiutate.
Number
1000000
Tempo max di attesa prima di scaricare il buffer dello stream di valori (millisec)
Numero di millisecondi che il sistema attende prima di scaricare il buffer dello stream di valori.
Number
10000
Numero di thread di elaborazione
Numero di thread di elaborazione allocati allo stream di valori.
* 
Il provider InfluxPersistenceProviderPackage funziona meglio con un numero minore di thread. È altamente ottimizzato per gestire i dati da un numero inferiore di canali.
Per quanto riguarda Influx2PersistenceProviderPackage, non è più il caso. PTC consiglia di aumentare il numero di thread per un throughput migliore. Per InfluxDB Cloud, PTC consiglia di aumentare il valore di Numero di thread di elaborazione a 10, Dimensione max coda a 100000 e Numero max di scritture dello stream di valori da elaborare in blocco a 25000, per raggiungere un throughput di 80.000 wps.
Number
10
Numero max di elementi prima di scaricare il buffer dei valori
Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream di valori.
Number
1000
Numero max di scritture dello stream di valori da elaborare in blocco
Numero massimo di elementi da elaborare in un unico blocco.
Number
25000
Numero max di scritture dello stream da elaborare
Numero di nuovi tentativi di scrittura di batch in caso di errore di scrittura.
* 
Il nuovo tentativo non è immediato, ma si verifica al tentativo di scrittura successivo, come specificato dall'impostazione di configurazione Frequenza analisi stato buffer (millisec) I tentativi di ripetizione possono risolvere il problema di brevi interruzioni momentanee della rete, ma non sono efficaci in caso di lunghi periodi di assenza di connessione. Se la frequenza con cui arrivano i dati non è elevata e si necessita di un intervallo di tempo maggiore tra i tentativi di ripetizione, è possibile modificare l'impostazione Frequenza analisi stato buffer (millisec) per ridurre la frequenza dei tentativi di scrittura.
Frequenza analisi stato buffer (millisec)
Lo stato del buffer viene controllato in base al valore della frequenza specificata in millisecondi.
Number
5
5. Fare clic sulla scheda Informazioni generali e selezionare la casella di controllo Attivo.
6. Fare clic su Salva.
È stato utile?