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à. # Configura il componente publisher AWS IoT SiteWise Dopo aver creato un gateway AWS IoT SiteWise Edge e installato il software, puoi configurare il componente publisher in modo che il gateway SiteWise Edge possa esportare i dati nel AWS Cloud. Utilizza il componente publisher per abilitare funzionalità aggiuntive o configurare le impostazioni predefinite. Per ulteriori informazioni, consulta [AWS IoT SiteWise Publisher](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-publisher-component.html) nella *AWS IoT Greengrass Version 2 Developer Guide*. **Nota** La configurazione dell'editore varia in base al tipo di gateway utilizzato. Per i gateway Classic Stream, V2, usa lo spazio dei nomi. `iotsitewise:publisher:2` Per i gateway V3 abilitati per MQTT, utilizzate lo spazio dei nomi. `iotsitewise:publisher:3` ------ #### [ Console ] 1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. **Nel riquadro di navigazione, scegli Edge gateway.** 1. Seleziona il gateway SiteWise Edge per il quale desideri configurare l'editore. 1. Nella sezione **Configurazione di Publisher**, scegli **Modifica** 1. Per **Ordine di pubblicazione**, scegliete una delle seguenti opzioni: + **Pubblica prima i dati più vecchi**: per impostazione predefinita, il gateway SiteWise Edge pubblica prima i dati più vecchi sul cloud. + **Pubblica prima i dati più recenti**: il gateway SiteWise Edge pubblica prima i dati più recenti sul cloud. 1. (Facoltativo) Se non desideri che il gateway SiteWise Edge comprima i tuoi dati, deseleziona **Attiva** la compressione durante il caricamento dei dati. 1. (Facoltativo) Se non desideri pubblicare vecchi dati, scegli **Escludi dati scaduti** e procedi come segue: 1. Per **Periodo limite**, inserisci un valore e scegli un'unità. Il periodo limite deve essere compreso tra cinque minuti e sette giorni. Ad esempio, se il periodo limite è di tre giorni, i dati più vecchi di tre giorni non vengono pubblicati sul cloud. 1. (Facoltativo) Per configurare impostazioni personalizzate sulla gestione dei dati sul dispositivo locale, scegli **Impostazioni di archiviazione locale ed esegui le** seguenti operazioni: 1. Per **Periodo di conservazione**, inserisci un numero e scegli un'unità. Il periodo di conservazione deve essere compreso tra un minuto e 30 giorni e deve essere superiore o uguale al periodo di rotazione. Ad esempio, se il periodo di conservazione è di 14 giorni, il gateway SiteWise Edge elimina tutti i dati sull'edge che sono più vecchi del periodo limite specificato dopo che sono stati archiviati per 14 giorni. 1. Per **Periodo di rotazione**, inserisci un numero e scegli un'unità. Il periodo di rotazione deve essere superiore a un minuto e pari o inferiore al periodo di conservazione. Ad esempio, supponiamo che il periodo di rotazione sia di due giorni, il gateway SiteWise Edge raggruppa e salva i dati più vecchi del periodo limite in un unico file. Per i gateway ospitati autonomamente AWS IoT Greengrass V2, il gateway SiteWise Edge trasferisce un batch di dati nella seguente directory locale una volta ogni due giorni:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports` 1. Per **Capacità di archiviazione**, inserisci un valore maggiore o uguale a 1. Se la capacità di archiviazione è di 2 GB, il gateway SiteWise Edge inizia a eliminare i dati quando più di 2 GB di dati vengono archiviati localmente. 1. Scegli **Save** (Salva). ------ #### [ AWS CLI ] 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:2`. **Example : configurazione Publisher per i gateway Classic Stream, V2** Lo spazio dei nomi dell'editore: `iotsitewise:publisher:2` ``` { "SiteWisePublisherConfiguration": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "dropPolicy": { "cutoffAge": "7d", "exportPolicy": { "retentionPeriod": "7d", "rotationPeriod": "6h", "exportSizeLimitGB": 10 } } }, "SiteWiseS3PublisherConfiguration": { "accessRoleArn": "arn:aws:iam:123456789012:role/roleName", "streamToS3ConfigMapping": [ { "streamName": "S3_OPC-UA_Data_Collector", "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/dataCollector", "publishPolicy": { "publishFrequency": "10m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true } } ] } } ``` L'editore fornisce i seguenti parametri di configurazione che è possibile personalizzare: `SiteWisePublisherConfiguration` `publishingOrder` L'ordine in cui i dati vengono pubblicati nel cloud. Il valore di questo parametro può essere uno dei seguenti: + `TIME_ORDER`(**Pubblica prima i dati più vecchi**): per impostazione predefinita, i dati più vecchi vengono pubblicati per primi nel cloud. + `RECENT_DATA`(**Pubblica prima i dati più recenti**): i dati più recenti vengono pubblicati prima nel cloud. `enableCompression` Imposta questa opzione per `true` comprimere i dati prima della pubblicazione. La compressione dei dati può ridurre l'utilizzo della larghezza di banda. `dropPolicy` (Facoltativo) Una policy che controlla quali dati vengono pubblicati sul cloud. `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. `exportPolicy` (Facoltativo) Una policy che gestisce l'archiviazione dei dati all'edge. Questa politica si applica ai dati precedenti alla data limite. `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. `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. `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. `SiteWiseS3PublisherConfiguration` `accessRoleArn` Il ruolo di accesso che AWS IoT SiteWise autorizza la gestione del bucket Amazon S3 su cui stai pubblicando. `streamToS3ConfigMapping` Una serie di configurazioni che associa uno stream a una configurazione Amazon S3. `streamName` Lo stream da cui leggere e pubblicare nella configurazione di Amazon S3. `targetBucketArn` Il bucket in ARN cui pubblicare. `publishPolicy` `publishFrequency` La frequenza con cui il gateway SiteWise Edge pubblica nel bucket Amazon S3. `localSizeLimitGB` La dimensione massima dei file scritti sul disco locale. Se questa soglia viene superata, l'editore pubblica tutti i dati memorizzati nel buffer nella relativa destinazione. `siteWiseImportPolicy` `enableSiteWiseStorageImport` Imposta questa opzione `true` su per importare i dati da un bucket Amazon S3 allo storage. AWS IoT SiteWise `enableDeleteAfterImport` Imposta questa opzione `true` su per eliminare il file nel bucket Amazon S3 dopo l'ingestione nello storage. AWS IoT SiteWise ------