Penerbit IoT SiteWise - AWS IoT Greengrass
VersiJenisSistem operasiPersyaratanDependensiKonfigurasiData inputBerkas 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.

Penerbit IoT SiteWise

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

Untuk informasi selengkapnya tentang AWS IoT SiteWise gateway, lihat Menggunakan AWS IoT SiteWise di tepi di AWS IoT SiteWise Panduan Pengguna.

Versi

Komponen ini memiliki versi berikut:

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Jenis

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti 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)

    • OS: Perusahaan Red Hat 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 tindakan. iotsitewise:BatchPutAssetPropertyValue Untuk informasi selengkapnya, lihat Mengotorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

    contoh kebijakan izin
    {
    "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 Wajib Deskripsi

data.iotsitewise.region.amazonaws.com

 443 Ya

Publikasikan data ke AWS IoT SiteWise.

Dependensi

Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga 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 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 manajer AWS IoT Greengrass aliran. Untuk informasi selengkapnya, lihat PutAssetPropertyValueEntrydi Referensi AWS IoT SiteWise API.

Berkas 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 mencakup 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 instruksi pemecahan masalah. Informasi pemecahan masalah disediakan bersama 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

3.1.3
Perbaikan bug dan peningkatan

  • Menyelesaikan masalah di mana file log peristiwa berada 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.

  • Menyelesaikan masalah di mana BatchCreateJob API masih akan 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
Perbaikan bug dan peningkatan

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

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

  • Memperbaiki masalah saat Publisher mencampur pos pemeriksaan StreamManager aliran 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 konsumsi 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 menampilkan 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 membuatnya lebih mudah untuk mengidentifikasi dan memperbaiki masalah.

Perbaikan bug dan peningkatan

  • Meningkatkan pemulihan pos pemeriksaan Publisher.

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

2.3.1
Fitur baru

  • Menambahkan dukungan untuk menginstal Data Collection Pack pada arsitektur Linux ARMv8.

  • Persyaratan minimum untuk Linux ARMv8:

    • Memori: 4 GB

    • CPU: ARM Cortex-A72 atau spesifikasi yang setara

2.2.3
Perbaikan bug dan peningkatan

  • Menghapus coba lagi untuk pengecualian generik yang tidak ada dalam daftar pengecualian yang dapat diambil.

2.2.2
Perbaikan bug dan peningkatan

  • Memperkenalkan kembali dukungan unggahan data ke 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 mengaktifkan 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 mengirimnya ke AWS IoT SiteWise layanan.

    • Dalam kebanyakan kasus, perubahan ini mengurangi penggunaan bandwidth hingga 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 pos pemeriksaan 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 (AS-Timur). Versi komponen ini membutuhkan Java versi 11 atau lebih untuk dijalankan. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini.

Perbaikan bug dan peningkatan

  • Memperbaiki pesan galat saat Anda menerapkan komponen ini pada perangkat yang tidak didukung.

  • Pembaruan untuk mencatat kesalahan saat pengunggahan data gagal.

2.1.2
Perbaikan bug dan peningkatan

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

2.1.1

Perbaikan bug dan perbaikan.

2.1.0
Fitur baru

  • Menambahkan dukungan untuk mempublikasikan 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