Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Device-side metrik
catatan
Fitur AWS deteksi IoT Device Defender tidak akan lagi tersedia untuk pelanggan baru mulai 31 Agustus 2026. Jika Anda ingin menggunakan fitur deteksi, daftar sebelum 31 Agustus 2026. Untuk mempelajari tentang alternatif deteksi AWS IoT Device Defender, lihat AWS IoT Device Defender mendeteksi perubahan ketersediaan fitur. Tidak ada perubahan pada ketersediaan audit AWS IoT Device Defender.
Saat membuat Profil Keamanan, Anda dapat menentukan perilaku yang diharapkan perangkat IoT Anda dengan mengonfigurasi perilaku dan ambang batas untuk metrik yang dihasilkan oleh perangkat IoT. Berikut ini adalah metrik sisi perangkat, yang merupakan metrik dari agen yang Anda instal di perangkat Anda.
Byte keluar (aws: all-bytes-out)
Jumlah byte keluar dari perangkat selama periode waktu tertentu.
Gunakan metrik ini untuk menentukan jumlah maksimum atau minimum lalu lintas keluar yang harus dikirim perangkat, diukur dalam byte, dalam periode waktu tertentu.
Kompatibel dengan: Aturan Deteksi | Deteksi ML
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: byte
Durasi: bilangan bulat non-negatif. Nilai yang valid adalah 300, 600, 900, 1800, atau 3600 detik.
contoh
{ "name": "TCP outbound traffic", "metric": "aws:all-bytes-out", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 4096 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan StatisticalThreshold
{ "name": "TCP outbound traffic", "metric": "aws:all-bytes-out", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p50" }, "durationSeconds": 900, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan ML Detect
{ "name": "Outbound traffic ML behavior", "metric": "aws:all-bytes-out", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
Byte dalam (aws: all-bytes-in)
Jumlah byte masuk ke perangkat selama periode waktu tertentu.
Gunakan metrik ini untuk menentukan jumlah maksimum atau minimum lalu lintas masuk yang harus diterima perangkat, diukur dalam byte, dalam periode waktu tertentu.
Kompatibel dengan: Aturan Deteksi | Deteksi ML
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: byte
Durasi: bilangan bulat non-negatif. Nilai yang valid adalah 300, 600, 900, 1800, atau 3600 detik.
contoh
{ "name": "TCP inbound traffic", "metric": "aws:all-bytes-in", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 4096 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan StatisticalThreshold
{ "name": "TCP inbound traffic", "metric": "aws:all-bytes-in", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p90" }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan ML Detect
{ "name": "Inbound traffic ML behavior", "metric": "aws:all-bytes-in", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
Mendengarkan jumlah port TCP (aws:num-listening-tcp-ports)
Jumlah port TCP yang didengarkan perangkat.
Gunakan metrik ini untuk menentukan jumlah maksimum port TCP yang harus dipantau oleh setiap perangkat.
Kompatibel dengan: Aturan Deteksi | Deteksi ML
Unit: kegagalan
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: kegagalan
Durasi: bilangan bulat non-negatif. Nilai yang valid adalah 300, 600, 900, 1800, atau 3600 detik.
contoh
{ "name": "Max TCP Ports", "metric": "aws:num-listening-tcp-ports", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 5 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan StatisticalThreshold
{ "name": "Max TCP Ports", "metric": "aws:num-listening-tcp-ports", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p50" }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan deteksi ML
{ "name": "Max TCP Port ML behavior", "metric": "aws:num-listening-tcp-ports", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
Mendengarkan jumlah port UDP (aws:num-listening-udp-ports)
Jumlah port UDP yang didengarkan perangkat.
Gunakan metrik ini untuk menentukan jumlah maksimum port UDP yang harus dipantau setiap perangkat.
Kompatibel dengan: Aturan Deteksi | Deteksi ML
Unit: kegagalan
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: kegagalan
Durasi: bilangan bulat non-negatif. Nilai yang valid adalah 300, 600, 900, 1800, atau 3600 detik.
contoh
{ "name": "Max UDP Ports", "metric": "aws:num-listening-udp-ports", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 5 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan StatisticalThreshold
{ "name": "Max UDP Ports", "metric": "aws:num-listening-udp-ports", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p50" }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan ML Detect
{ "name": "Max UPD Port ML behavior", "metric": "aws:num-listening-tcp-ports", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
Paket keluar (aws: all-packets-out)
Jumlah paket keluar dari perangkat selama periode waktu tertentu.
Gunakan metrik ini untuk menentukan jumlah maksimum atau minimum total lalu lintas keluar yang harus dikirim perangkat dalam jangka waktu tertentu.
Kompatibel dengan: Aturan Deteksi | Deteksi ML
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: paket
Durasi: bilangan bulat non-negatif. Nilai yang valid adalah 300, 600, 900, 1800, atau 3600 detik.
contoh
{ "name": "TCP outbound traffic", "metric": "aws:all-packets-out", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 100 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan StatisticalThreshold
{ "name": "TCP outbound traffic", "metric": "aws:all-packets-out", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p90" }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan ML Detect
{ "name": "Outbound sent ML behavior", "metric": "aws:all-packets-out", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
Paket dalam (aws: all-packets-in)
Jumlah paket masuk ke perangkat selama periode waktu tertentu.
Gunakan metrik ini untuk menentukan jumlah maksimum atau minimum total lalu lintas masuk yang harus diterima perangkat dalam jangka waktu tertentu.
Kompatibel dengan: Deteksi Aturan | Deteksi ML
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: paket
Durasi: bilangan bulat non-negatif. Nilai yang valid adalah 300, 600, 900, 1800 atau 3600 detik.
contoh
{ "name": "TCP inbound traffic", "metric": "aws:all-packets-in", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 100 }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh
Contoh menggunakan a statisticalThreshold
{ "name": "TCP inbound traffic", "metric": "aws:all-packets-in", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p90" }, "durationSeconds": 300, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan ML Detect
{ "name": "Inbound sent ML behavior", "metric": "aws:all-packets-in", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
IP tujuan (aws: alamat ip tujuan)
Satu set tujuan IP.
Gunakan metrik ini untuk menentukan kumpulan Inter-Domain Routing Tanpa Kelas (CIDR) yang diizinkan (sebelumnya disebut daftar putih) atau ditolak (sebelumnya disebut sebagai daftar hitam) dari mana setiap perangkat harus atau tidak boleh terhubung. AWS IoT
Kompatibel dengan: Aturan Deteksi
Operator: in-cidr-set | not-in-cidr-set
Nilai: daftar CIDR
Unit: n/a
contoh
{ "name": "Denied source IPs", "metric": "aws:destination-ip-address", "criteria": { "comparisonOperator": "not-in-cidr-set", "value": { "cidrs": [ "12.8.0.0/16", "15.102.16.0/24" ] } }, "suppressAlerts": true }
Mendengarkan port TCP (aw s:listening-tcp-ports)
Port TCP yang didengarkan perangkat.
Gunakan metrik ini untuk menentukan kumpulan port TCP yang diizinkan (sebelumnya disebut sebagai daftar putih) atau ditolak (sebelumnya disebut sebagai daftar hitam) di mana setiap perangkat harus atau tidak boleh mendengarkan.
Kompatibel dengan: Aturan Deteksi
Operator: in-port-set | not-in-port-set
Nilai: daftar port
Unit: n/a
contoh
{ "name": "Listening TCP Ports", "metric": "aws:listening-tcp-ports", "criteria": { "comparisonOperator": "in-port-set", "value": { "ports": [ 443, 80 ] } }, "suppressAlerts": true }
Mendengarkan port UDP (aw s:listening-udp-ports)
Port UDP yang didengarkan perangkat.
Gunakan metrik ini untuk menentukan kumpulan port UDP yang diizinkan (sebelumnya disebut sebagai daftar putih) atau ditolak (sebelumnya disebut sebagai daftar hitam) di mana setiap perangkat harus atau tidak boleh mendengarkan.
Kompatibel dengan: Aturan Deteksi
Operator: in-port-set | not-in-port-set
Nilai: daftar port
Unit: n/a
contoh
{ "name": "Listening UDP Ports", "metric": "aws:listening-udp-ports", "criteria": { "comparisonOperator": "in-port-set", "value": { "ports": [ 1025, 2000 ] } } }
Jumlah koneksi TCP yang mapan (aws:num-setuphed-tcp-connection)
Jumlah koneksi TCP untuk perangkat.
Gunakan metrik ini untuk menentukan jumlah maksimum atau minimum koneksi TCP aktif yang harus dimiliki setiap perangkat (Semua status TCP).
Kompatibel dengan: Aturan Deteksi | Deteksi ML
Operator: kurang dari | kurang dari sama | lebih besar-dari | lebih besar-dari sama
Nilai: bilangan bulat non-negatif
Unit: koneksi
contoh
{ "name": "TCP Connection Count", "metric": "aws:num-established-tcp-connections", "criteria": { "comparisonOperator": "less-than-equals", "value": { "count": 3 }, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan StatisticalThreshold
{ "name": "TCP Connection Count", "metric": "aws:num-established-tcp-connections", "criteria": { "comparisonOperator": "less-than-equals", "statisticalThreshold": { "statistic": "p90" }, "durationSeconds": 900, "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1 }, "suppressAlerts": true }
contoh Contoh menggunakan ML Detect
{ "name": "Connection count ML behavior", "metric": "aws:num-established-tcp-connections", "criteria": { "consecutiveDatapointsToAlarm": 1, "consecutiveDatapointsToClear": 1, "mlDetectionConfig": { "confidenceLevel": "HIGH" } }, "suppressAlerts": true }
Spesifikasi dokumen metrik perangkat
|
Nama panjang |
Nama pendek |
Diperlukan |
Tipe |
Batasan |
Catatan |
|---|---|---|---|---|---|
|
header |
het |
Y |
Objek |
Blok lengkap diperlukan untuk laporan yang terbentuk dengan baik. |
|
|
metrik |
bertemu |
Y |
Objek |
Laporan dapat memiliki keduanya atau setidaknya satu |
|
|
kustom_metrik |
Cmet |
Y |
Objek |
Laporan dapat memiliki keduanya atau setidaknya satu |
|
Nama panjang |
Nama pendek |
Diperlukan |
Tipe |
Batasan |
Catatan |
|---|---|---|---|---|---|
|
laporan_id |
menyingkirkan |
Y |
Bilangan Bulat |
Nilai yang meningkat secara monoton. Stempel waktu Epoch direkomendasikan. |
|
|
versi |
v |
Y |
String |
Major.Minor |
Kenaikan kecil dengan penambahan bidang. Kenaikan besar jika metrik dihapus. |
Blok metrik:
|
Nama panjang |
Nama pendek |
Elemen induk |
Diperlukan |
Tipe |
Batasan |
Catatan |
|---|---|---|---|---|---|---|
|
tcp_koneksi |
tc |
metrik |
T |
Objek |
||
|
koneksi yang mapan |
ec |
tcp_koneksi |
T |
Objek |
Status TCP yang didirikan |
|
|
koneksi |
cs |
koneksi yang mapan |
T |
Daftar <Object> |
||
|
remote_addr |
line |
koneksi |
Y |
Bilangan |
ip: pelabuhan |
IP bisa IPv6 atau IPv4 |
|
pelabuhan_lokal |
Lp |
koneksi |
T |
Bilangan |
> = 0 |
|
|
antarmuka lokal |
il |
koneksi |
T |
String |
Nama antarmuka |
|
|
total |
t |
koneksi yang mapan |
T |
Bilangan |
> = 0 |
Jumlah koneksi yang sudah mapan |
|
Nama panjang |
Nama pendek |
Elemen induk |
Diperlukan |
Tipe |
Batasan |
Catatan |
|---|---|---|---|---|---|---|
|
mendengarkan_tcp_ports |
tp |
metrik |
T |
Objek |
||
|
pangkalan |
poin |
mendengarkan_tcp_ports |
T |
Daftar <Object> |
> 0 |
|
|
port |
pt |
pangkalan |
T |
Bilangan |
> 0 |
port harus angka lebih besar dari 0 |
|
antarmuka |
jika |
pangkalan |
T |
String |
Nama antarmuka |
|
|
total |
t |
mendengarkan_tcp_ports |
T |
Bilangan |
> = 0 |
|
Nama panjang |
Nama pendek |
Elemen induk |
Diperlukan |
Tipe |
Batasan |
Catatan |
|---|---|---|---|---|---|---|
|
mendengarkan_udp_ports |
ke atas |
metrik |
T |
Objek |
||
|
pangkalan |
poin |
mendengarkan_udp_ports |
T |
Daftar <Port> |
> 0 |
|
|
port |
pt |
pangkalan |
T |
Bilangan |
> 0 |
Port harus angka lebih besar dari 0 |
|
antarmuka |
jika |
pangkalan |
T |
String |
Nama antarmuka |
|
|
total |
t |
mendengarkan_udp_ports |
T |
Bilangan |
> = 0 |
|
Nama panjang |
Nama pendek |
Elemen induk |
Diperlukan |
Tipe |
Batasan |
Catatan |
|---|---|---|---|---|---|---|
|
Network_stats |
ns |
metrik |
T |
Objek |
||
|
bytes_in |
bi |
Network_stats |
T |
Bilangan |
Delta Metrik, >= 0 |
|
|
bytes_out |
bo |
Network_stats |
T |
Bilangan |
Delta Metrik, >= 0 |
|
|
paket_in |
pi |
Network_stats |
T |
Bilangan |
Delta Metrik, >= 0 |
|
|
paket_keluar |
po |
Network_stats |
T |
Bilangan |
Delta Metrik, >= 0 |
contoh
Struktur JSON berikut menggunakan nama panjang.
{ "header": { "report_id": 1530304554, "version": "1.0" }, "metrics": { "listening_tcp_ports": { "ports": [ { "interface": "eth0", "port": 24800 }, { "interface": "eth0", "port": 22 }, { "interface": "eth0", "port": 53 } ], "total": 3 }, "listening_udp_ports": { "ports": [ { "interface": "eth0", "port": 5353 }, { "interface": "eth0", "port": 67 } ], "total": 2 }, "network_stats": { "bytes_in": 29358693495, "bytes_out": 26485035, "packets_in": 10013573555, "packets_out": 11382615 }, "tcp_connections": { "established_connections": { "connections": [ { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" }, { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" } ], "total": 2 } } }, "custom_metrics": { "MyMetricOfType_Number": [ { "number": 1 } ], "MyMetricOfType_NumberList": [ { "number_list": [ 1, 2, 3 ] } ], "MyMetricOfType_StringList": [ { "string_list": [ "value_1", "value_2" ] } ], "MyMetricOfType_IpList": [ { "ip_list": [ "172.0.0.0", "172.0.0.10" ] } ] } }
contoh Contoh struktur JSON menggunakan nama pendek
{ "hed": { "rid": 1530305228, "v": "1.0" }, "met": { "tp": { "pts": [ { "if": "eth0", "pt": 24800 }, { "if": "eth0", "pt": 22 }, { "if": "eth0", "pt": 53 } ], "t": 3 }, "up": { "pts": [ { "if": "eth0", "pt": 5353 }, { "if": "eth0", "pt": 67 } ], "t": 2 }, "ns": { "bi": 29359307173, "bo": 26490711, "pi": 10014614051, "po": 11387620 }, "tc": { "ec": { "cs": [ { "li": "eth0", "lp": 80, "rad": "192.168.0.1:8000" }, { "li": "eth0", "lp": 80, "rad": "192.168.0.1:8000" } ], "t": 2 } } }, "cmet": { "MyMetricOfType_Number": [ { "number": 1 } ], "MyMetricOfType_NumberList": [ { "number_list": [ 1, 2, 3 ] } ], "MyMetricOfType_StringList": [ { "string_list": [ "value_1", "value_2" ] } ], "MyMetricOfType_IpList": [ { "ip_list": [ "172.0.0.0", "172.0.0.10" ] } ] } }
Mengirim metrik dari perangkat
AWS IoT Device Defender Detect dapat mengumpulkan, mengumpulkan, dan memantau data metrik yang dihasilkan oleh AWS IoT perangkat untuk mengidentifikasi perangkat yang menunjukkan perilaku abnormal. Bagian ini menunjukkan cara mengirim metrik dari perangkat ke AWS IoT Device Defender.
Anda harus menerapkan AWS IoT SDK versi dua dengan aman di perangkat yang AWS IoT terhubung atau gateway perangkat untuk mengumpulkan metrik sisi perangkat. Lihat daftar lengkap SDK di sini.
Anda dapat menggunakan AWS IoT Klien Perangkat untuk mempublikasikan metrik karena menyediakan agen tunggal yang mencakup fitur yang ada di kedua AWS IoT Device Defender dan Manajemen AWS IoT Perangkat. Fitur-fitur ini termasuk pekerjaan, tunneling aman, penerbitan AWS IoT Device Defender metrik, dan banyak lagi.
Anda menerbitkan metrik sisi perangkat ke topik yang dicadangkan AWS IoT AWS IoT Device Defender untuk dikumpulkan dan dievaluasi.
Menggunakan AWS IoT Klien Perangkat untuk mempublikasikan metrik
Untuk menginstal AWS IoT Device Client, Anda dapat mengunduhnya dari Githubdevice-defender bagian:
"device-defender": { "enabled": true, "interval-in-seconds": 300 }
Awas
Anda harus mengatur interval waktu minimal 300 detik. Jika Anda mengatur interval waktu ke kurang dari 300 detik, data metrik Anda mungkin dibatasi.
Setelah memperbarui konfigurasi, Anda dapat membuat profil keamanan dan perilaku di AWS IoT Device Defender konsol untuk memantau metrik yang dipublikasikan perangkat Anda ke cloud. Anda dapat menemukan metrik yang dipublikasikan di AWS IoT Core konsol dengan memilih Pertahankan, Deteksi, dan kemudian Metrik.