View a markdown version of this page

SiteWise Penerbit IoT - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiData inputFile log lokalPemecahan masalah dan debuggingLisensiChangelogLihat juga

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

SiteWise Penerbit IoT

Komponen SiteWise penerbit IoT (aws.iot.SiteWiseEdgePublisher) memungkinkan AWS IoT SiteWise gateway untuk mengekspor data dari tepi ke AWS Cloud.

Untuk informasi selengkap AWS IoT SiteWise nya tentang gateway, AWS IoT SiteWise lihat Menggunakan di tepi dalam Panduan AWS IoT SiteWise Pengguna.

Versi

Komponen ini memiliki versi berikut:

  • 4.1.x

  • 4.0.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). In ti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Perangkat inti Greengrass harus berjalan di salah satu platform berikut:

    • os: Ubuntu 18.04 atau yang lebih baru

      arsitektur: x86_64 (AMD64) atau ARMv8 (Aarch64)

    • Sistem operasi: Red Hat Enterprise Linux (RHEL) 8

      arsitektur: x86_64 (AMD64) atau ARMv8 (Aarch64)

    • OS: Amazon Linux 2

      arsitektur: x86_64 (AMD64) atau ARMv8 (Aarch64)

    • OS: Debian 11

      arsitektur: x86_64 (AMD64) atau ARMv8 (Aarch64)

    • os: Windows Server 2019 atau yang lebih baru

      arsitektur: x86_64 (AMD64)

  • Perangkat inti Greengrass harus terhubung ke Internet.

  • Perangkat inti Greengrass harus diberi wewenang untuk melakukan iotsitewise:BatchPutAssetPropertyValue tindakan. Untuk informasi selengkapnya, lihat Mengotorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

    contoh kebijakan izin
    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik akhir Port Diperlukan Deskripsi

data.iotsitewise.region.amazonaws.com

 443 Ya

Publikasikan data ke AWS IoT SiteWise.

Dependensi

Saat Anda menerapkan komponen, AWS IoT Greengrass juga menerapkan versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

Tabel berikut mencantumkan dependensi untuk versi 2.0.x hingga 2.2.x dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > = 2.3.0 <3.0.0 Keras
Manajer pengaliran > = 2.0.10 <3.0.0 Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini tidak memiliki parameter konfigurasi apapun.

Anda dapat menggunakan AWS IoT SiteWise konsol atau API untuk mengonfigurasi komponen SiteWise penerbit IoT. Untuk informasi selengkapnya, lihat Langkah 3: Mengkonfigurasi penerbit - opsional di Panduan AWS IoT SiteWise Pengguna.

Data input

Komponen ini membaca PutAssetPropertyValueEntry pesan dari AWS IoT Greengrass pengelola aliran. Untuk informasi selengkapnya, lihat PutAssetPropertyValueEntry di dalam Referensi API AWS IoT SiteWise .

File log lokal

Komponen ini menggunakan file log berikut.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait

Pemecahan masalah dan debugging

Komponen ini menyertakan log peristiwa baru untuk membantu pelanggan mengidentifikasi dan memperbaiki masalah. File log terpisah dari file log lokal, dan ditemukan di lokasi berikut. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Log ini mencakup informasi terperinci dan petunjuk pemecahan masalah. Informasi pemecahan masalah disediakan di samping diagnostik, dengan deskripsi tentang cara memperbaiki masalah, dan terkadang dengan tautan ke informasi lebih lanjut. Informasi diagnostik meliputi:

  • Tingkat kepelikan

  • Stempel waktu

  • Informasi khusus acara tambahan

contoh Contoh log
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

Lisensi

Komponen ini dirilis menurut Perjanjian Lisensi Perangkat Lunak Greengrass Core.

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

4.1.4
Perbaikan bug dan peningkatan

  • SiteWise Penerbit IoT sekarang melaporkan metrik kesehatan sistem, seperti memori dan penggunaan CPU SiteWise penerbit IoT, ke CloudWatch.

  • Memperbarui pelaporan kesalahan AWS IoT Greengrass sehingga SiteWise penerbit IoT dimulai ulang jika alur kerja startup mengalami kegagalan sebagian.

4.1.3
Perbaikan bug dan peningkatan

  • Memperbaiki kebocoran memori dalam proses checkpointing data.

  • Memperbaiki kerentanan keamanan.

4.1.2
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang terkait dengan sinkronisasi konfigurasi besar.

  • Keterlambatan berlangganan AWS IoT Core tidak lagi mempengaruhi proses start up.

  • Penundaan dalam inisialisasi pos pemeriksaan tidak lagi mempengaruhi proses start up.

4.1.1
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang menyebabkan penggunaan CPU dan memori tinggi pada aliran Klasik, gateway V2 saat mengirim data melalui buffer menggunakan tujuan Amazon S3 setelah memulai ulang penerbit. AWS IoT SiteWise

  • Menambahkan dukungan untuk mengganti perilaku pencatatan komponen default dengan membuat file opsional yang terletak di:/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/log4j2.xml.

4.1.0
Fitur baru

  • Menambahkan alat baris perintah untuk mengelola pengguna broker EMQX MQTT bawaan. Antarmuka ini memungkinkan manajemen akun pengguna dan mengonfigurasi kebijakan kontrol akses untuk penerbitan topik MQTT dan izin berlangganan.

Perbaikan bug dan peningkatan

  • Memperbaiki perhitungan yang menentukan berapa banyak alias unik yang dapat dimasukkan ke dalam satu file Parquet penyerapan Buffered.

4.0.3
Perbaikan bug dan peningkatan

  • Memperbarui maksimum alias unik per file penyer AWS IoT SiteWise apan buffer agar sesuai dengan batas cloud 10.000.

  • Memperbaiki masalah AWS IoT Greengrass pencatatan yang salah melaporkan status layanan yang tidak valid.

  • Menambahkan validasi untuk mencegah nama aliran duplikat di seluruh konfigurasi tujuan Amazon S3 di aliran Klasik, gateway V2.

  • Memperbaiki masalah kompatibilitas dengan penyer AWS IoT SiteWise apan buffer di AWS partisi non-standar.

  • Memperbaiki masalah yang menyebabkan konsumsi data duplikat.

4.0.2
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang mencegah pengunggahan data setelah waktu tunggu batch berakhir.

  • Menambahkan validasi untuk memverifikasi bahwa setiap tujuan dalam MQTT-enabled, konfigurasi gateway V3 adalah unik.

4.0.1
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang mencegah pengunggahan data AWS IoT SiteWise saat Anda menonaktifkan konfigurasi waktu tunggu batch maksimum.

  • Memperbaiki masalah di mana IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker metrik secara tidak akurat melaporkan jumlah topik unik yang berlangganan ke broker MQTT.

4.0.0
Fitur baru

Menambahkan dukungan untuk MQTT-enabled, gateway V3 selain aliran Klasik, gateway V2 (sebelumnya dikenal sebagai gateway SiteWise Edge yang dihosting sendiri).

Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat PublishSuccessCount metrik melaporkan nilai negatif.

  • Memperbaiki masalah ketika penerbit tidak memulai dalam waktu 100 detik dan memasuki BROKEN status.

  • Memperbaiki kerentanan keamanan.

3.2.0
Fitur baru
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang menyebabkan file database pos pemeriksaan rusak.

  • Memperbaiki masalah yang menghasilkan metrik duplikat.

3.1.4
Awas

Versi 3.1.4 dihentikan pada 20 Februari 2025. Perbaikan dalam versi ini tersedia di versi komponen ini yang lebih baru.

Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang dapat menyebabkan waktu startup lebih lama dari yang diharapkan setelah offline.

3.1.3
Perbaikan bug dan peningkatan

  • Memperbaiki masalah di mana file log peristiwa yang terletak di /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log dibuat tetapi tidak ada peristiwa yang dicatat.

  • Menambahkan CloudWatch metrik berikut untuk memantau koneksi dengan broker MQTT:

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

    Untuk informasi selengkapnya tentang metrik ini, lihat metrik AWS IoT Greengrass Version 2 gateway.

  • Memperbaiki masalah di mana BatchCreateJob API masih dipanggil meskipun mengunggah file parket ke S3 gagal.

3.1.2
Perbaikan bug dan peningkatan

  • Memperbaiki masalah penggunaan CPU tinggi yang diperkenalkan di versi 3.1.1.

3.1.1
Awas

Versi 3.1.1 dihentikan pada 12 Maret 2024. Perbaikan dalam versi ini tersedia di versi komponen ini yang lebih baru.

Perbaikan bug dan peningkatan

  • Menambahkan logging tambahan yang mengidentifikasi alias data yang terpengaruh saat terjadi kesalahan.

  • Menambahkan penegakan lokal batas AWS IoT SiteWise API pada usia data yang dicerna.

  • Memperbaiki masalah ketika Publisher mencampurkan pos pemeriksaan StreamManager streaming saat ada beberapa tujuan Amazon S3.

  • Memperbaiki hambatan kinerja dengan cara penerbit membaca dari aliran StreamManager .

3.1.0
Fitur baru

  • Menambahkan dukungan untuk mempublikasikan data sebagai file parket ke Amazon S3.

  • Menambahkan dukungan untuk konsumsi AWS IoT SiteWise buffer.

3.0.0
Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang terkait dengan dukungan proxy.

Fitur baru

  • Memungkinkan dukungan penyerapan data dari broker MQTT.

2.4.1
Perbaikan bug dan peningkatan

  • Aktifkan komponen untuk bekerja dengan Java Corretto 11 versi 11.0.20.8.1 dan yang lebih baru. Versi komponen 2.4.0 dan 2.3.3 menunjukkan pesan "Could not find or load main class" kesalahan saat digunakan dengan Java Corretto versi 11.0.20.8.1.

2.4.0
Fitur baru

  • Menambahkan log peristiwa baru untuk memudahkan mengidentifikasi dan memperbaiki masalah.

Perbaikan bug dan peningkatan

  • Meningkatkan pemulihan pos pemeriksaan Penerbit.

2.3.3
Perbaikan bug dan peningkatan

  • Meningkatkan kemampuan untuk mendukung throughput tinggi.

2.3.2
Perbaikan bug dan peningkatan

  • Memperbaiki dukungan proxy HTTP saat mengunduh konfigurasi Publisher.

2.3.1
Fitur baru

  • Menambahkan dukungan untuk menginstal Paket Pengumpulan Data pada arsitektur Linux ARMv8.

  • Persyaratan minimum untuk Linux ARMv8:

    • Memori: 4 GB

    • CPU: ARM Cortex-A72 atau spesifikasi setara

2.2.3
Perbaikan bug dan peningkatan

  • Menghapus percobaan ulang untuk pengecualian umum yang tidak ada dalam daftar pengecualian yang dapat diambil.

2.2.2
Perbaikan bug dan peningkatan

  • Memperkenalkan kembali dukungan upload data AWS IoT SiteWise melalui server proxy HTTP.

2.2.1
catatan

Versi ini tidak mendukung konfigurasi proxy HTTP. Versi 2.2.2 dan yang lebih tinggi memperkenalkan kembali dukungan untuk fitur ini.

Fitur baru

  • Menambahkan dukungan ke komponen ini untuk beralih kompresi saat mengunggah data ke AWS IoT SiteWise.

2.2.0
catatan

Versi ini tidak mendukung konfigurasi proxy HTTP. Versi 2.2.2 dan yang lebih tinggi memperkenalkan kembali dukungan untuk fitur ini.

Fitur baru

  • Memperbarui komponen ini untuk mengompres data sebelum mengirimkannya ke AWS IoT SiteWise layanan.

    • Dalam kebanyakan kasus, perubahan ini mengurangi penggunaan bandwidth sebesar 75 persen dibandingkan dengan versi sebelumnya dari komponen ini.

    • Dalam kebanyakan kasus, perubahan ini meningkatkan penggunaan CPU hingga 5 persen. Pada gateway yang memproses data dalam jumlah besar, perubahan ini dapat meningkatkan penggunaan CPU hingga 15 persen.

    • Perubahan ini tidak memengaruhi biaya AWS IoT SiteWise layanan atau penggunaan kuota layanan.

    • Menambahkan dukungan untuk Windows Server 2019 atau lebih tinggi.

Perbaikan bug dan peningkatan

  • Memperbaiki masalah yang mencegah komponen ini dimulai saat file checkpoint rusak.

2.1.4
Perbaikan bug dan peningkatan

  • Memperbaiki kompatibilitas dengan Java versi 8.

2.1.3
Awas

Versi ini tidak lagi tersedia, kecuali di Wilayah AS Timur (Ohio), Kanada (Tengah), dan AWS GovCloud (US-East). Versi komponen ini membutuhkan Java versi 11 atau lebih tinggi untuk dijalankan. Perbaikan dalam versi ini tersedia di versi komponen ini yang lebih baru.

Perbaikan bug dan peningkatan

  • Meningkatkan pesan kesalahan saat Anda menerapkan komponen ini pada perangkat yang tidak didukung.

  • Pembaruan untuk kesalahan log saat unggahan data gagal.

2.1.2
Perbaikan bug dan peningkatan

  • Pembaruan untuk memanggil fitur ekspor data kedaluwarsa segera setelah data kedaluwarsa.

2.1.1

Perbaikan bug dan perbaikan.

2.1.0
Fitur baru

  • Menambahkan dukungan untuk menerbitkan data terbaru ke cloud terlebih dahulu.

  • Menambahkan dukungan untuk tidak menerbitkan data kedaluwarsa ke cloud.

  • Menambahkan dukungan untuk menyimpan data kedaluwarsa secara lokal.

Perbaikan bug dan peningkatan

  • Mengurangi disk I/O dan latensi yang sesuai.

2.0.2

Perbaikan bug dan perbaikan.

2.0.1

Versi awal.

Lihat juga