Persyaratan Parameter Data input Data output Batas Lisensi Changelog Lihat juga

AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Konektor IoT SiteWise

SiteWise Konektor IoT mengirimkan data perangkat dan peralatan lokal ke properti aset di. AWS IoT SiteWise Anda dapat menggunakan konektor ini untuk mengumpulkan data dari beberapa server OPC-UA dan mempublikasikannya ke IoT. SiteWise Konektor mengirimkan data ke properti aset dalam arus Akun AWS dan Wilayah.

catatan

IoT SiteWise adalah layanan yang dikelola sepenuhnya yang mengumpulkan, memproses, dan memvisualisasikan data dari perangkat dan peralatan industri. Anda dapat mengonfigurasi properti aset yang memproses data mentah yang dikirim dari konektor ini ke properti pengukuran aset Anda. Sebagai contoh, Anda dapat menentukan properti transformasi yang mengkonversi Celcius titik data suhu perangkat ke Fahrenheit, atau Anda dapat menentukan properti metrik yang menghitung suhu per jam rata-rata. Untuk informasi lebih lanjut, lihat Apa AWS IoT SiteWise? dalam AWS IoT SiteWise Panduan Pengguna.

Konektor mengirimkan data ke IoT SiteWise dengan jalur aliran data OPC-UA yang dikirim dari server OPC-UA. Sebagai contoh, jalur aliran data /company/windfarm/3/turbine/7/temperature mungkin mewakili sensor suhu turbin #7 dalam ladang angin #3. Jika AWS IoT Greengrass core kehilangan koneksi ke internet, konektor data cache sampai berhasil terhubung ke AWS Cloud. Anda dapat mengonfigurasi ukuran buffer disk maksimum yang digunakan untuk data caching. Jika ukuran cache melebihi ukuran buffer disk maksimum, konektor membuang data terlama dari antrian.

Setelah mengonfigurasi dan menerapkan konektor SiteWise IoT, Anda dapat menambahkan gateway dan sumber OPC-UA di konsol IoT. SiteWise Saat mengonfigurasi sumber di konsol, Anda dapat memfilter atau mengawali jalur aliran data OPC-UA yang dikirim oleh konektor IoT. SiteWise Untuk instruksi untuk menyelesaikan pengaturan gateway dan sumber, lihat Menambahkan gateway dalam AWS IoT SiteWise Panduan Pengguna.

IoT SiteWise menerima data hanya dari aliran data yang telah Anda petakan ke properti pengukuran aset IoT. SiteWise Untuk memetakan aliran data ke properti aset, Anda dapat mengatur alias properti untuk setara dengan jalur aliran data OPC-UA. Untuk mempelajari tentang mendefinisikan model aset dan menciptakan aset, lihat Pemodelan aset industri dalam AWS IoT SiteWise Panduan Pengguna.

Catatan

Anda dapat menggunakan pengelola aliran untuk mengunggah data ke IoT SiteWise dari sumber selain server OPC-UA. Stream manager juga menyediakan dukungan disesuaikan untuk ketahanan dan manajemen bandwidth. Untuk informasi selengkapnya, lihat Mengelola aliran data di AWS IoT Greengrass core.

Konektor ini berjalan dalam mode isolasi Tanpa kontainer ini, sehingga Anda dapat men-deploy ke grup Greengrass yang berjalan pada kontainer Docker.

Konektor ini memiliki versi berikut.

Versi	ARN
12 (disarankan)	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12`
11	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11`
10	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10`
9	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9`
8	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8`
7	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7`
6	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6`
5	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5`
4	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4`
3	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3`
2	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2`
1	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1`

Untuk informasi tentang perubahan versi, lihat Changelog.

Persyaratan

Konektor ini memiliki persyaratan sebagai berikut:

Version 9, 10, 11, and 12

penting

Versi ini memperkenalkan persyaratan baru: AWS IoT Greengrass Perangkat lunak Core v1.10.2 dan pengelola aliran.

AWS IoT Greengrass perangkat lunak Core v1.10.2.
Stream manager diaktifkan pada grup Greengrass.
Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
Konektor ini hanya dapat digunakan di Wilayah Amazon Web Services di mana keduanya AWS IoT Greengrassdan IoT SiteWise didukung.

Sebuah kebijakan IAM ditambahkan ke peran grup Greengrass. Peran ini mengizinkan akses grup AWS IoT Greengrass ke tindakan iotsitewise:BatchPutAssetPropertyValue pada aset root target dan turunannya, seperti yang ditunjukkan dalam contoh berikut. Anda dapat menghapus Condition dari kebijakan untuk memungkinkan konektor mengakses semua aset IoT SiteWise Anda.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Untuk informasi lebih lanjut, lihat Menambahkan dan menghapus kebijakan IAM dalam Panduan Pengguna IAM.

Versions 6, 7, and 8

penting

Versi ini memperkenalkan persyaratan baru: AWS IoT Greengrass Perangkat lunak Core v1.10.0 dan pengelola aliran.

AWS IoT Greengrass perangkat lunak Core v1.10.0.
Stream manager diaktifkan pada grup Greengrass.
Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
Konektor ini hanya dapat digunakan di Wilayah Amazon Web Services di mana keduanya AWS IoT Greengrassdan IoT SiteWise didukung.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Untuk informasi lebih lanjut, lihat Menambahkan dan menghapus kebijakan IAM dalam Panduan Pengguna IAM.

Version 5

AWS IoT Greengrass perangkat lunak Core v1.9.4.
Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
Konektor ini hanya dapat digunakan di Wilayah Amazon Web Services di mana keduanya AWS IoT Greengrassdan IoT SiteWise didukung.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Untuk informasi lebih lanjut, lihat Menambahkan dan menghapus kebijakan IAM dalam Panduan Pengguna IAM.

Version 4

AWS IoT Greengrass perangkat lunak Core v1.10.0.
Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
Konektor ini hanya dapat digunakan di Wilayah Amazon Web Services di mana keduanya AWS IoT Greengrassdan IoT SiteWise didukung.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Untuk informasi lebih lanjut, lihat Menambahkan dan menghapus kebijakan IAM dalam Panduan Pengguna IAM.

Version 3

AWS IoT Greengrass perangkat lunak Core v1.9.4.
Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
Konektor ini hanya dapat digunakan di Wilayah Amazon Web Services di mana keduanya AWS IoT Greengrassdan IoT SiteWise didukung.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Untuk informasi lebih lanjut, lihat Menambahkan dan menghapus kebijakan IAM dalam Panduan Pengguna IAM.

Versions 1 and 2

AWS IoT Greengrass perangkat lunak Core v1.9.4.
Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
Konektor ini hanya dapat digunakan di Wilayah Amazon Web Services di mana keduanya AWS IoT Greengrassdan IoT SiteWise didukung.

Kebijakan IAM ditambahkan ke peran grup Greengrass yang mengizinkan akses ke AWS IoT Core dan iotsitewise:BatchPutAssetPropertyValue tindakan pada aset root target dan anak-anaknya, seperti yang ditunjukkan dalam contoh berikut. Anda dapat menghapus Condition dari kebijakan untuk memungkinkan konektor mengakses semua aset IoT SiteWise Anda.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        },
        {
            "Effect": "Allow",
            "Action": [
                 "iot:Connect",
                 "iot:DescribeEndpoint",
                 "iot:Publish",
                 "iot:Receive",
                 "iot:Subscribe"
            ],
            "Resource": "*"
        }
    ]
}

Untuk informasi lebih lanjut, lihat Menambahkan dan menghapus izin identitas IAM dalam Panduan Pengguna IAM.

Parameter

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12

SiteWiseLocalStoragePath

Direktori pada AWS IoT Greengrass host tempat SiteWise konektor IoT dapat menulis data persisten. Default ke /var/sitewise.

Nama tampilan pada konsol AWS IoT tersebut: Jalur penyimpanan lokal

Wajib: false

Jenis: string

Pola yang valid: ^\s*$|\/.

AWSSecretsArnList

Daftar rahasia dalam AWS Secrets Manager bahwa masing-masing berisi nama pengguna OPC-UA dan kata sandi kunci-nilai pasangan. Setiap rahasia harus menjadi rahasia jenis pasangan yang bernilai kunci.

Nama tampilan pada konsol AWS IoT tersebut: Daftar ARN untuk rahasia nama pengguna/kata sandi OPC-UA

Wajib: false

Jenis: JsonArrayOfStrings

Pola yang valid: \[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

Ukuran maksimum dalam GB untuk penggunaan SiteWise disk IoT. Default untuk 10GB.

Nama tampilan pada konsol AWS IoT tersebut: Ukuran maksimum buffer disk

Wajib: false

Jenis: string

Pola yang valid: ^\s*$|[0-9]+

Version 1

SiteWiseLocalStoragePath

Direktori pada AWS IoT Greengrass host tempat SiteWise konektor IoT dapat menulis data persisten. Default ke /var/sitewise.

Nama tampilan pada konsol AWS IoT tersebut: Jalur penyimpanan lokal

Wajib: false

Jenis: string

Pola yang valid: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

Rahasia dalam AWS Secrets Manager yang berisi nama pengguna OPC-UA dan kata sandi kunci-nilai pasangan. Rahasia ini harus menjadi rahasia jenis pasangan kunci-nilai.

Nama tampilan pada konsol AWS IoT tersebut: ARN rahasia nama pengguna/kata sandi OPC-UA

Wajib: false

Jenis: string

Pola yang valid: ^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

Sumber daya rahasia dalam AWS IoT Greengrass grup yang mereferensikan rahasia nama pengguna dan kata sandi OPC-UA.

Nama tampilan pada konsol AWS IoT tersebut: sumber daya rahasia nama pengguna/kata sandi OPC-UA

Wajib: false

Jenis: string

Pola yang valid: ^$|.+

MaximumBufferSize

Ukuran maksimum dalam GB untuk penggunaan SiteWise disk IoT. Default untuk 10GB.

Nama tampilan pada konsol AWS IoT tersebut: Ukuran maksimum buffer disk

Wajib: false

Jenis: string

Pola yang valid: ^\s*$|[0-9]+

Buat Contoh Konektor (AWS CLI)

AWS CLIPerintah berikut membuat ConnectorDefinition dengan versi awal yang berisi konektor IoT SiteWise .


aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyIoTSiteWiseConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11"
        }
    ]
}'

catatan

Fungsi-fungsi Lambda dalam konektor mempunyai siklus hidup yang berumur panjang ini.

Di konsol AWS IoT Greengrass tersebut, Anda dapat menambahkan konektor dari halaman grup Konektor ini. Untuk informasi lebih lanjut, lihat Memulai dengan konektor Greengrass (konsol).

Data input

Konektor ini tidak menerima pesan MQTT sebagai data input.

Data output

Konektor ini tidak menerbitkankan pesan MQTT sebagai Data output.

Batas

Konektor ini tunduk pada semua batasan berikut yang diberlakukan oleh IoT SiteWise, termasuk yang berikut ini. Untuk informasi lebih lanjut, lihat AWS IoT SiteWisetitik akhir dan kuota di. Referensi Umum AWS

Jumlah maksimum gateway per Akun AWS.
Jumlah maksimum sumber OPC-UA per gateway.
Tingkat maksimum titik data timestamp-quality-value (TQV) yang disimpan per. Akun AWS
Tingkat maksimum titik data TQV yang dipertahankan per properti aset.

Lisensi

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi konektor.

Versi	Perubahan	Tanggal
12	Versi ini berisi perbaikan bug.	Desember 22, 2021
11	Support untuk string yang berisi karakter tersembunyi atau unprintable. Karakter tersembunyi dan unprintable secara otomatis dihapus sebelum string dikirim ke AWS Cloud. Memperbaiki masalah yang menyebabkan SiteWise gateway IoT mencoba ulang permintaan yang tidak valid secara tak terbatas. Memperbaiki masalah yang menyebabkan pos pemeriksaan rusak saat SiteWise gateway IoT terhubung ke sumber data frekuensi tinggi. Peningkatan pesan kesalahan untuk membantu menyelesaikan masalah konfigurasi gateway.	24 Maret 2021
10	Mengonfigurasi `StreamManager` untuk meningkatkan penanganan ketika koneksi sumber hilang dan didirikan kembali. Versi ini juga menerima nilai OPC-UA dengan sebuah `ServerTimestamp` ketika tidak `SourceTimestamp` tersedia.	22 Januari 2021
9	Support diluncurkan untuk tujuan pengaliran `StreamManager` Greengrass kustom, deadbanding OPC-UA, mode pemindaian khusus dan tingkat pemindaian kustom. Juga termasuk peningkatan kinerja selama pembaruan konfigurasi yang dibuat dari gateway IoT SiteWise .	15 Desember 2020
8	Peningkatan stabilitas ketika konektor mengalami konektivitas jaringan intermiten.	19 November 2020
7	Memperbaiki masalah dengan metrik gateway.	14 Agustus 2020
6	Menambahkan dukungan untuk CloudWatch metrik dan penemuan otomatis tag OPC-UA baru. Versi ini membutuhkan pengelola aliran dan Perangkat lunak Core AWS IoT Greengrass v1.10.0 atau yang lebih tinggi.	29 April 2020
5	Memperbaiki masalah kompatibilitas dengan Perangkat lunak Core AWS IoT Greengrass v1.9.4.	12 Februari 2020
4	Memperbaiki masalah dengan rekoneksi server OPC-UA.	7 Februari 2020
3	Menghapus `iot:*` persyaratan izin.	17 Desember 2019
2	Ditambahkan dukungan untuk beberapa sumber daya rahasia OPC-UA.	10 Desember 2019
1	Pelepasan awal.	2 Desember 2019

Sebuah grup Greengrass dapat berisi hanya satu versi konektor pada suatu waktu. Untuk informasi lebih lanjut tentang pembaruan versi konektor, lihat Versi upgrade konektor.

Lihat juga

Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass
Memulai dengan konektor Greengrass (konsol)
Memulai dengan konektor Greengrass (CLI)
Lihat topik berikut dalam Panduan PenggunaAWS IoT SiteWise:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Adaptor Protokol IP Ethernet IoT

Kinesis Firehose