Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Aggiungi una AWS IoT SiteWise destinazione Edge in tempo reale Il tipo di destinazione in tempo reale consente di trasmettere i dati IoT direttamente dai dispositivi e dai gateway AWS IoT SiteWise allo storage in tempo reale. Questa opzione è ideale per i casi d'uso che richiedono l'inserimento e l'elaborazione immediati dei dati man mano che vengono generati, senza la necessità di operazioni di batch o buffering. È possibile configurare una sola destinazione in tempo reale in ogni gateway, poiché trasmette i dati in modo continuo. AWS IoT SiteWise **Nota** La duplicazione TQVs può comportare un doppio addebito. **Per aggiungere una destinazione in tempo reale** Usa la AWS IoT SiteWise console o aggiungi una destinazione in tempo reale AWS CLI al tuo gateway abilitato per SiteWise Edge MQTT. ------ #### [ Console ] 1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/). 1. **Nel riquadro di navigazione, scegli Edge gateway.** 1. Seleziona il gateway a cui desideri aggiungere una destinazione. 1. Nella sezione **Destinazioni**, scegli **Aggiungi destinazione**. 1. Nella pagina **Aggiungi destinazione**, inserisci **i dettagli della destinazione**: 1. Un nome per la destinazione nel campo **Nome destinazione**. 1. Seleziona il **AWS IoT SiteWise tempo reale** per il **tipo di destinazione**. 1. Configura l'ordine di pubblicazione del gateway impostando l'**ordine di pubblicazione** su **Pubblica prima i dati più vecchi o Pubblica prima** **i dati più recenti**. Per impostazione predefinita, il gateway pubblica per primi i dati più vecchi. 1. Utilizza **Tempo di attesa massimo per il batch** per impostare il tempo massimo di attesa per l'editore prima di inviare un batch di dati a AWS IoT SiteWise. Questa impostazione si applica a ogni alias. I dati vengono archiviati localmente fino a quando: + Il tempo impostato è trascorso, oppure + Sono state time-quality-value ricevute 10 voci (TQV) per l'alias La condizione soddisfatta per prima attiva l'invio del batch al cloud. 1. Per comprimere i dati caricati, seleziona la casella di controllo **Attiva la compressione durante il caricamento dei** dati. Consentire al gateway di comprimere i dati prima di caricarli sul cloud riduce l'utilizzo della larghezza di banda. 1. Per filtrare i dati scaduti degli editori, seleziona la casella di controllo **Escludi** dati scaduti. Questa selezione invia solo i dati attivi e correnti a. AWS IoT SiteWise 1. Nel campo **Periodo limite**, inserisci la frequenza con cui i dati devono essere considerati scaduti all'interno del set di dati. È possibile determinare se i dati vengono conteggiati in termini di minuti o giorni. Il periodo limite minimo è di cinque minuti. Il periodo limite massimo è di sette giorni. 1. Configura facoltativamente le impostazioni di **archiviazione locale**: 1. Imposta la frequenza del **periodo di conservazione**: la quantità di tempo in cui il gateway archivia localmente i dati più vecchi del periodo limite. Il periodo di conservazione minimo è di un minuto. Il periodo di conservazione massimo è di 30 giorni ed è maggiore o uguale al periodo di rotazione. 1. Imposta il **periodo di rotazione**: l'intervallo di tempo da specificare quando si salvano dati precedenti al periodo limite per un singolo file. Il gateway trasferisce un batch di dati nella seguente directory locale alla fine di ogni periodo di rotazione:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports` La conservazione deve essere superiore a un minuto e pari al periodo di conservazione. 1. Fornisci il valore **della capacità di archiviazione (GB)** per impostare la dimensione massima dei dati archiviati localmente in GB. Se i dati superano la dimensione massima di archiviazione locale determinata, il gateway inizia a eliminare prima i dati più vecchi. Il gateway continua a eliminare finché la dimensione dei dati archiviati localmente non è uguale o inferiore alla quota. La capacità di archiviazione deve essere maggiore o uguale a un GB. 1. Aggiungi filtri di percorso alla tua destinazione. Per ulteriori informazioni, consultare [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md). Per ulteriori informazioni, consulta [Tipi di destinazione](gw-destinations.md#destination-types). ------ #### [ AWS CLI ] **Example : crea una nuova destinazione AWS IoT SiteWise in tempo reale** Utilizza l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API per configurare l'editore. Imposta il parametro `capabilityNamespace` su `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_REALTIME", "name": "your-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Per aggiornare una destinazione esistente AWS IoT SiteWise in tempo reale, utilizza innanzitutto l'`DescribeGatewayCapabilityConfiguration`API per trovare il`destinationId`. **Example : aggiorna una destinazione AWS IoT SiteWise in tempo reale** Utilizza l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API per configurare l'editore. Imposta il parametro `capabilityNamespace` su `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "your-existing-destination-id", "type": "SITEWISE_REALTIME", "name": "your-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "dropPolicy": { "cutoffAge": "7d", "exportPolicy": { "retentionPeriod": "7d", "rotationPeriod": "6h", "exportSizeLimitGB": 10 } }, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Le seguenti opzioni di configurazione sono specifiche per i gateway che utilizzano lo `iotsitewise:publisher:3` spazio dei nomi. `sources` Definisce le fonti di dati a cui trasferire i dati dalle apparecchiature industriali. AWS IoT SiteWise Per i gateway compatibili con MQTT, utilizzare. `MQTT` Tipo: matrice di oggetti Obbligatorio: sì `destinations` Definisce dove inviare i dati. Le destinazioni sono in tempo reale o memorizzate nel buffer utilizzando Amazon S3. È richiesto almeno un oggetto di destinazione, ma puoi aggiungere un array vuoto. È possibile avere una destinazione in tempo reale per ogni gateway. Per ulteriori informazioni, consulta [Comprendi le destinazioni Edge AWS IoT SiteWise](gw-destinations.md#source-destination). Tipo: matrice di oggetti Obbligatorio: sì `id` L'identificatore univoco della destinazione. Puoi fornire un ID di destinazione esistente o lasciarlo vuoto. Se non si specifica un ID, per impostazione predefinita viene generato un UUID. ▬Tipo: stringa Obbligatorio: no `type` Tipo di destinazione. Le opzioni includono: `SITEWISE_REALTIME` e. `SITEWISE_BUFFERED` + `SITEWISE_REALTIME`— Invia i dati direttamente allo AWS IoT SiteWise storage in tempo reale. + `SITEWISE_BUFFERED`— Invia dati ad Amazon S3 in batch in formato Parquet, quindi importali nello storage. AWS IoT SiteWise Tipo: stringa Obbligatorio: sì `name` Un nome univoco per la destinazione. Tipo: stringa Obbligatorio: sì `config` Configurazione specifica per il tipo di destinazione in formato JSON. La configurazione varia tra destinazioni in tempo reale e destinazioni con buffer. Tipo: oggetto Obbligatorio: sì Ordine di pubblicazione Determina l'ordine in cui i dati vengono pubblicati. I dati vengono pubblicati in base al relativo timestamp. Le opzioni includono e. `TIME_ORDER` `RECENT_DATA` + `TIME_ORDER`(impostazione predefinita): pubblica prima i dati più vecchi. + `RECENT_DATA`— Pubblica prima i dati più recenti. ▬Tipo: stringa Obbligatorio: no Abilita la compressione Se impostato su`true`, abilita la compressione dei dati prima dell'invio a. AWS IoT SiteWise Consentire al gateway di comprimere i dati prima di caricarli sul cloud riduce l'utilizzo della larghezza di banda. Il valore predefinito è `true`. Tipo: Booleano Obbligatorio: no DropPolicy Definisce come gestire i dati più vecchi. Tipo: oggetto Obbligatorio: no + `cutoffAge` L'età massima dei dati da pubblicare specificata in giorni, ore e minuti. Ad esempio `7d` o `1d7h16m`. I dati più vecchi di quelli specificati non vengono inviati a AWS IoT SiteWise. I dati precedenti al periodo limite non vengono pubblicati nel cloud. L'età limite deve essere compresa tra cinque minuti e sette giorni. È possibile utilizzare `m``h`, e `d` quando si specifica un'età limite. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni. Tipo: stringa Obbligatorio: sì + `exportPolicy` Definisce come gestire i dati che superano l'età limite. Tipo: oggetto Obbligatorio: no + `retentionPeriod` Il gateway SiteWise Edge elimina tutti i dati sull'edge che sono precedenti al periodo limite dall'archiviazione locale dopo che sono stati archiviati per il periodo di conservazione specificato. Il periodo di conservazione deve essere compreso tra un minuto e 30 giorni e deve essere superiore o uguale al periodo di rotazione. È possibile utilizzare `m``h`, e `d` quando si specifica un periodo di conservazione. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni. ▬Tipo: stringa Obbligatorio: no + `rotationPeriod` L'intervallo di tempo durante il quale raggruppare e salvare i dati precedenti al periodo limite in un singolo file. Il gateway SiteWise Edge trasferisce un batch di dati nella seguente directory locale alla fine di ogni periodo di rotazione:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports` Il periodo di rotazione deve essere maggiore di un minuto, e uguale o inferiore al periodo di conservazione. È possibile utilizzare `m``h`, e `d` quando si specifica un periodo di rotazione. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni. ▬Tipo: stringa Obbligatorio: no + `exportSizeLimitGB` La dimensione massima consentita dei dati archiviati localmente, in GB. Se questa quota viene violata, il gateway SiteWise Edge inizia a eliminare i primi dati fino a quando la dimensione dei dati archiviati localmente non è uguale o inferiore alla quota. Il valore di questo parametro deve essere maggiore o uguale a 1. Tipo: Integer Obbligatorio: no `maxBatchWaitTime` Imposta un tempo massimo di attesa per l'editore prima di inviare un batch di dati a AWS IoT SiteWise. Questa impostazione si applica a ogni alias. I dati vengono archiviati localmente fino a quando: + Il tempo impostato è trascorso, oppure + Sono state time-quality-value ricevute 10 voci (TQV) per l'alias Usare `m``h`, e `d` per specificare un orario limite. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni. ▬Tipo: stringa Obbligatorio: no `filters` Filtri da applicare ai dati. È richiesto almeno un filtro. Tipo: stringa Obbligatorio: sì `type` Tipo di filtro. Utilizza `PATH`. Tipo: stringa Obbligatorio: sì `config` Configurazione specifica per il tipo di filtro in formato JSON. È richiesto almeno un oggetto, ma l'array può essere vuoto. Tipo: oggetto Obbligatorio: sì + `paths` Una serie di filtri di percorso. Per ulteriori informazioni, consulta [Comprendi i filtri di percorso per AWS IoT SiteWise le destinazioni EdgeUnderstand path filters](gw-destinations.md#destinations-path-filters). Il percorso predefinito è `#`. Tipo: array di stringhe Obbligatorio: sì ------