

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Konfigurasikan AWS IoT SiteWise komponen penerbit
<a name="configure-publisher-component"></a>

Setelah Anda membuat gateway AWS IoT SiteWise Edge dan menginstal perangkat lunak, Anda dapat mengatur komponen penerbit sehingga gateway SiteWise Edge Anda dapat mengekspor data ke AWS Cloud. Gunakan komponen penerbit untuk mengaktifkan fitur tambahan atau mengkonfigurasi pengaturan default. Untuk informasi selengkapnya, lihat [AWS IoT SiteWise penerbit](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-publisher-component.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.

**catatan**  
Konfigurasi penerbit berbeda berdasarkan jenis gateway yang Anda gunakan. Untuk aliran Klasik, gateway V2, gunakan namespace. `iotsitewise:publisher:2` Untuk gateway V3 berkemampuan MQTT, gunakan namespace. `iotsitewise:publisher:3`

------
#### [ Console ]

1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. Di panel navigasi, pilih **gateway Edge**.

1. Pilih gateway SiteWise Edge yang ingin Anda konfigurasikan penerbit.

1. **Di bagian **konfigurasi Publisher**, pilih Edit**

1. Untuk **pesanan Penerbitan**, pilih salah satu dari berikut ini:
   + **Publikasikan data tertua terlebih dahulu** — Gateway SiteWise Edge menerbitkan data tertua ke cloud terlebih dahulu secara default.
   + **Publikasikan data terbaru terlebih dahulu** — Gateway SiteWise Edge menerbitkan data terbaru ke cloud terlebih dahulu.

1. (Opsional) Jika Anda tidak ingin gateway SiteWise Edge mengompres data Anda, batalkan pilihan **Aktifkan kompresi saat mengunggah** data.

1. (Opsional) Jika Anda tidak ingin mempublikasikan data lama, pilih **Kecualikan data kedaluwarsa** dan lakukan hal berikut:

   1. Untuk **periode Cutoff**, masukkan nilai dan pilih unit. Periode batas harus antara lima menit dan tujuh hari. Misalnya, jika batas waktu adalah tiga hari, data yang lebih tua dari tiga hari tidak dipublikasikan ke cloud.

1. (Opsional) Untuk mengatur pengaturan kustom tentang bagaimana data ditangani pada perangkat lokal Anda, pilih **Pengaturan penyimpanan lokal** dan lakukan hal berikut:

   1. Untuk **periode Retensi**, masukkan nomor dan pilih unit. Periode retensi harus antara satu menit dan 30 hari, dan lebih besar dari atau sama dengan periode rotasi. Misalnya, jika periode retensi adalah 14 hari, gateway SiteWise Edge menghapus data apa pun di tepi yang lebih lama dari periode batas yang ditentukan setelah disimpan selama 14 hari.

   1. Untuk **periode Rotasi**, masukkan nomor dan pilih unit. Periode rotasi harus lebih besar dari satu menit, dan sama dengan, atau kurang dari, periode retensi. Misalnya, katakanlah periode rotasi adalah dua hari, gateway SiteWise Edge mengumpulkan dan menyimpan data yang lebih lama dari periode cutoff ke satu file. Untuk gateway yang dihosting sendiri AWS IoT Greengrass V2, gateway SiteWise Edge mentransfer sekumpulan data ke direktori lokal berikut setiap dua hari sekali:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`

   1. Untuk **kapasitas Penyimpanan**, masukkan nilai yang lebih besar dari atau sama dengan 1. Jika kapasitas penyimpanan 2 GB, gateway SiteWise Edge mulai menghapus data ketika lebih dari 2 GB data disimpan secara lokal. 

1. Pilih **Simpan**.

------
#### [ AWS CLI ]

Gunakan [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API untuk mengonfigurasi penerbit.

Atur parameter `capabilityNamespace` ke `iotsitewise:publisher:2`.

**Example : Konfigurasi penerbit untuk Classic Stream, gateway V2**  
Namespace penerbit: `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
                }
            }
        ]
    }
}
```

Publisher menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan:

`SiteWisePublisherConfiguration`    
`publishingOrder`  
Urutan di mana data dipublikasikan ke cloud. Nilai parameter ini dapat berupa salah satu dari yang berikut:  
+ `TIME_ORDER`(**Publikasikan data tertua terlebih dahulu**) — Data paling awal dipublikasikan ke cloud terlebih dahulu, secara default.
+ `RECENT_DATA`(**Publikasikan data terbaru terlebih dahulu**) — Data terbaru dipublikasikan ke cloud terlebih dahulu.  
`enableCompression`  
Setel ini untuk `true` mengompres data sebelum dipublikasikan. Kompresi data dapat mengurangi penggunaan bandwidth.  
`dropPolicy`  
(Opsional) Kebijakan yang mengontrol data apa yang dipublikasikan ke cloud.    
`cutoffAge`  
Usia maksimum data yang akan dipublikasikan ditentukan dalam hari, jam, dan menit. Misalnya, `7d` atau `1d7h16m`. Data yang lebih tua dari yang Anda tentukan tidak dikirim ke AWS IoT SiteWise.   
Data yang lebih awal dari periode cutoff tidak dipublikasikan ke cloud. Usia batas harus antara lima menit dan tujuh hari.  
Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan batas usia. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari.  
`exportPolicy`  
(Opsional) Kebijakan yang mengelola penyimpanan data di tepi. Kebijakan ini berlaku untuk data yang lebih awal dari batas usia.    
`retentionPeriod`  
Gateway SiteWise Edge Anda menghapus data apa pun di tepi yang lebih awal dari periode cutoff dari penyimpanan lokal setelah disimpan untuk periode retensi yang ditentukan. Periode retensi harus antara satu menit dan 30 hari, dan lebih besar dari atau sama dengan periode rotasi.  
Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan periode retensi. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari.  
`rotationPeriod`  
Interval waktu untuk mengumpulkan dan menyimpan data yang lebih awal dari periode cutoff ke satu file. Gateway SiteWise Edge mentransfer satu batch data ke direktori lokal berikut pada akhir setiap periode rotasi:`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. Periode rotasi harus lebih besar dari satu menit, dan sama dengan atau kurang dari periode retensi.  
Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan periode rotasi. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari.  
`exportSizeLimitGB`  
Ukuran maksimum yang diizinkan dari data yang disimpan secara lokal, dalam GB. Jika kuota ini dilanggar, gateway SiteWise Edge mulai menghapus data paling awal hingga ukuran data yang disimpan secara lokal sama dengan atau kurang dari kuota. Nilai parameter ini harus lebih besar dari atau sama dengan 1.

`SiteWiseS3PublisherConfiguration`    
`accessRoleArn`  
Peran akses yang memberikan AWS IoT SiteWise izin untuk mengelola bucket Amazon S3 yang Anda terbitkan.  
`streamToS3ConfigMapping`  
Array konfigurasi yang memetakan aliran ke konfigurasi Amazon S3.    
`streamName`  
Aliran untuk membaca dan mempublikasikan ke konfigurasi Amazon S3.  
`targetBucketArn`  
Ember ARN untuk dipublikasikan ke.  
`publishPolicy`  
    
`publishFrequency`  
Frekuensi penerbitan gateway SiteWise Edge ke bucket Amazon S3.   
`localSizeLimitGB`  
Ukuran maksimum file yang ditulis ke disk lokal. Jika ambang batas ini dilanggar, penerbit menerbitkan semua data buffer ke tujuannya.  
`siteWiseImportPolicy`  
    
`enableSiteWiseStorageImport`  
Setel ini `true` untuk mengimpor data dari bucket Amazon S3 ke AWS IoT SiteWise penyimpanan.  
`enableDeleteAfterImport`  
Setel ini `true` untuk menghapus file di bucket Amazon S3 setelah tertelan ke dalam penyimpanan. AWS IoT SiteWise 

------