Configurare il componente AWS IoT SiteWise Publisher - AWS IoT SiteWise

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

Configurare il componente AWS IoT SiteWise Publisher

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. Utilizzate il componente publisher per abilitare funzionalità aggiuntive o configurare le impostazioni predefinite. Per ulteriori informazioni, consulta AWS IoT SiteWise Publisher nella AWS IoT Greengrass Version 2 Developer Guide.

Console

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione, scegli Edge gateway.

  3. Seleziona il gateway SiteWise Edge per il quale desideri configurare l'editore.

  4. Nella sezione Configurazione di Publisher, scegli Modifica

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

  6. (Facoltativo) Se non desideri che il gateway SiteWise Edge comprima i tuoi dati, deseleziona Attiva la compressione durante il caricamento dei dati.

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

  8. (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.

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

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

  9. Seleziona Salva.

AWS CLI

È possibile utilizzare il UpdateGatewayCapabilityConfigurationAPIper configurare l'editore. Imposta il parametro capabilityNamespace su iotsitewise:publisher:2.

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.

dropPolicy

(Facoltativo) Una policy che controlla quali dati vengono pubblicati sul cloud.

cutoffAge

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 mh, 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 sull'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 mh, 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 mh, 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 per i 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

Esempio configurazione dell'editore:

Lo spazio dei nomi dell'editore: iotsitewise:publisher:2

{
    "SiteWisePublisherConfiguration": {                               
        "publishingOrder": "TIME_ORDER",
        "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
                }
            }
        ]
    }
}