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

# Detektor IP
<a name="ip-detector-component"></a>

Komponen detektor IP (`aws.greengrass.clientdevices.IPDetector`) melakukan hal berikut:
+ Memantau informasi konektivitas jaringan perangkat inti Greengrass. Informasi ini mencakup titik akhir jaringan perangkat inti dan port tempat broker MQTT beroperasi.
+ Memperbarui informasi konektivitas perangkat inti di layanan AWS IoT Greengrass cloud.

Perangkat klien dapat menggunakan penemuan cloud Greengrass untuk mengambil informasi konektivitas perangkat inti terkait. Kemudian, perangkat klien dapat mencoba untuk menyambung ke setiap perangkat inti sampai berhasil terhubung.

**catatan**  <a name="client-device-component-context"></a>
Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan perangkat IoT lokal](interact-with-local-iot-devices.md).

Komponen detektor IP menggantikan informasi konektivitas perangkat inti yang ada dengan informasi dideteksinya. Karena komponen ini menghapus informasi yang ada, Anda dapat menggunakan komponen detektor IP, atau secara manual mengelola informasi konektivitas.

**Topics**
+ [Versi](#ip-detector-component-versions)
+ [Tipe](#ip-detector-component-type)
+ [Sistem operasi](#ip-detector-component-os-support)
+ [Persyaratan](#ip-detector-component-requirements)
+ [Dependensi](#ip-detector-component-dependencies)
+ [Konfigurasi](#ip-detector-component-configuration)
+ [Berkas log lokal](#ip-detector-component-log-file)
+ [Changelog](#ip-detector-component-changelog)

## Versi
<a name="ip-detector-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipe
<a name="ip-detector-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

<a name="public-component-type-plugin-para2"></a>Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md).

<a name="public-component-type-more-information"></a>Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types).

## Sistem operasi
<a name="ip-detector-component-os-support"></a>

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

## Persyaratan
<a name="ip-detector-component-requirements"></a>

Komponen ini memiliki persyaratan sebagai berikut:
+ [Peran layanan Greengrass](greengrass-service-role.md) harus dikaitkan dengan Akun AWS Anda dan mengizinkan serta izin. `iot:GetThingShadow` `iot:UpdateThingShadow`
+  AWS IoT Kebijakan perangkat inti harus mengizinkan `greengrass:UpdateConnectivityInfo` izin. Untuk informasi selengkapnya, lihat [AWS IoT kebijakan untuk operasi pesawat data](device-auth.md#iot-policies) dan [AWS IoT Kebijakan minimal untuk mendukung perangkat klien](device-auth.md#client-device-support-minimal-iot-policy).
+ Jika Anda mengonfigurasi komponen broker MQTT perangkat inti untuk menggunakan port selain port default 8883, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker beroperasi.
+ Jika Anda memiliki penataan jaringan yang kompleks, komponen detektor IP mungkin tidak dapat mengidentifikasi titik akhir di mana perangkat klien dapat menyambung ke perangkat inti. Jika komponen detektor IP tidak dapat mengelola titik akhir, Anda harus secara manual mengelola titik akhir perangkat inti sebagai gantinya. Sebagai contoh, jika perangkat inti berada di belakang router yang meneruskan port broker MQTT ke sana, Anda harus menentukan alamat IP router sebagai titik akhir untuk perangkat inti. Untuk informasi selengkapnya, lihat [Kelola titik akhir perangkat inti](manage-core-device-endpoints.md).
+ Komponen detektor IP didukung untuk berjalan di VPC.

## Dependensi
<a name="ip-detector-component-dependencies"></a>

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](#ip-detector-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**.

------
#### [ 2.2.3 ]

Tabel berikut mencantumkan dependensi untuk versi 2.2.3 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.17.0 | Lunak | 

------
#### [ 2.2.2 ]

Tabel berikut mencantumkan dependensi untuk versi 2.2.2 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.16.0 | Lunak | 

------
#### [ 2.2.1 ]

Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.15.0 | Lunak | 

------
#### [ 2.2.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.14.0 | Lunak | 

------
#### [ 2.1.8 – 2.1.9 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.8 dan 2.1.9 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.13.0 | Lunak | 

------
#### [ 2.1.7 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.12.0 | Lunak | 

------
#### [ 2.1.6 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.11.0 | Lunak | 

------
#### [ 2.1.5 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.10.0 | Lunak | 

------
#### [ 2.1.4 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Lunak | 

------
#### [ 2.1.3 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Lunak | 

------
#### [ 2.1.2 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Lunak | 

------
#### [ 2.1.1 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Lunak | 

------
#### [ 2.1.0 and 2.0.2 ]

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 dan 2.0.2 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Lunak | 

------
#### [ 2.0.1 ]

Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Lunak | 

------
#### [ 2.0.0 ]

Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Lunak | 

------

Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies).

## Konfigurasi
<a name="ip-detector-component-configuration"></a>

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

------
#### [ 2.2.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<a name="ip-detector-component-configuration-default-port-definition"></a>(Opsional) Port broker MQTT untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883.  
Default: `8883`

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama.  
Default: `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis.  
Default: `false`

`includeIPv6LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan uji di mana perangkat inti dan perangkat klien berjalan pada sistem yang sama. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini.  
Default: `false`

`includeIPv6LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Protokol Konfigurasi Host Dinamis (DHCP) atau alamat IP yang ditetapkan secara statis. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini.  
Default: `false`

`includeIPv4Addrs`  <a name="ip-detector-component-configuration-include-ipv4-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Opsional) Default diatur ke`true`. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti.  
Default: `true`

`includeIPv6Addrs`  <a name="ip-detector-component-configuration-include-ipv6-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan di perangkat inti. Setel `includeIPv4Addrs` `false` untuk menggunakan opsi ini.  
Default: `false`

------
#### [ 2.1.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<a name="ip-detector-component-configuration-default-port-definition"></a>(Opsional) Port broker MQTT untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883.  
Default: `8883`

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama.  
Default: `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis.  
Default: `false`

------
#### [ 2.0.x ]

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama.  
Default: `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis.  
Default: `false`

------

## Berkas log lokal
<a name="ip-detector-component-log-file"></a>

Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="ip-detector-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.


|  **Versi**  |  **Perubahan**  | 
| --- | --- | 
|  2.2.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis.  | 
|  2.2.2  | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | 
|  2.2.1  | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | 
|  2.2.0  | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.9  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.8  | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | 
|  2.1.7  | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | 
|  2.1.6  | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | 
|  2.1.5  | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | 
|  2.1.4  | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | 
|  2.1.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.  | 
|  2.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.1  |  Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.0.2  |  Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.  | 
|  2.0.1  |  Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.  | 
|  2.0.0  |  Versi awal.  |