쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

IP 감지기

포커스 모드

이 페이지에서

IP 감지기 - AWS IoT Greengrass

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

IP 감지기 구성 요소(aws.greengrass.clientdevices.IPDetector)는 다음을 수행합니다.

  • Greengrass 코어 디바이스의 네트워크 연결 정보를 모니터링합니다. 이 정보에는 코어 디바이스의 네트워크 엔드포인트와 MQTT브로커가 작동하는 포트가 포함됩니다.

  • AWS IoT Greengrass 클라우드 서비스에서 코어 디바이스의 연결 정보를 업데이트합니다.

클라이언트 디바이스는 Greengrass 클라우드 검색을 사용하여 관련 코어 디바이스의 연결 정보를 검색할 수 있습니다. 그런 다음 클라이언트 디바이스는 연결될 때까지 각 코어 디바이스에 대한 연결을 시도할 수 있습니다.

참고

클라이언트 디바이스는 Greengrass 코어 디바이스에 연결하여 처리할 MQTT 메시지와 데이터를 전송하는 로컬 IoT 디바이스입니다. 자세한 내용은 로컬 IoT 디바이스와 상호 작용 단원을 참조하십시오.

IP 감지기 구성 요소는 코어 디바이스의 기존 연결 정보를 감지하는 정보로 대체합니다. 이 구성 요소는 기존 정보를 제거하므로 IP 감지기 구성 요소를 사용하거나 연결 정보를 수동으로 관리할 수 있습니다.

버전

이 구성 요소에는 다음과 같은 버전이 있습니다.

  • 2.2.x

  • 2.1.x

  • 2.0.x

유형

이 구성 요소는 플러그인 구성 요소(aws.greengrass.plugin)입니다. Greengrass 핵은 핵과 동일한 Java 가상 머신(JVM)에서이 구성 요소를 실행합니다. 코어 디바이스에서 구성 요소의 버전을 변경하면 nucleus가 다시 시작됩니다.

이 구성 요소에서는 Greengrass nucleus와 동일한 로그 파일이 사용됩니다. 자세한 내용은 AWS IoT Greengrass 로그 모니터링 단원을 참조하십시오.

자세한 내용은 구성 요소 유형 단원을 참조하십시오.

운영 체제

이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.

  • Linux

  • Windows

요구 사항

이 구성 요소에는 다음과 같은 요구 사항이 있습니다.

  • Greengrass 서비스 역할은에 연결되어 iot:GetThingShadow 있어야 AWS 계정 하며 및 iot:UpdateThingShadow 권한을 허용해야 합니다.

  • 코어 디바이스의 AWS IoT 정책은 greengrass:UpdateConnectivityInfo 권한을 허용해야 합니다. 자세한 내용은 데이터 영역 작업에 대한 AWS IoT 정책클라이언트 디바이스가 지원되는 최소 AWS IoT 정책 단원을 참조하세요.

  • 기본 포트 8883 이외의 포트를 사용하도록 코어 디바이스의 MQTT브로커 구성 요소를 구성하는 경우 IP 감지기 v2.1.0 이상을 사용해야 합니다. 브로커가 작동하는 포트를 보고하도록 구성합니다.

  • 네트워크 설정이 복잡한 경우 IP 감지기 구성 요소에서 클라이언트 디바이스가 코어 디바이스에 연결할 수 있는 엔드포인트를 식별하지 못할 수 있습니다. IP 탐지기 구성 요소가 엔드포인트를 관리할 수 없는 경우 대신 코어 디바이스 엔드포인트를 수동으로 관리해야 합니다. 예를 들어 코어 디바이스가 MQTT브로커 포트를 전달하는 라우터 뒤에 있는 경우 라우터의 IP 주소를 코어 디바이스의 엔드포인트로 지정해야 합니다. 자세한 내용은 코어 디바이스 엔드포인트 관리 단원을 참조하십시오.

  • IP 감지기 구성 요소는에서 실행할 수 있습니다VPC.

종속성

구성 요소를 배포할 때는 호환되는 버전의 종속성 AWS IoT Greengrass 도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 모든 해당 종속성에 대한 요구 사항을 충족해야 합니다. 이 단원에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 의미 체계 버전 제약 조건이 나열되어 있습니다. AWS IoT Greengrass 콘솔에서도 각 구성 요소 버전에 대한 종속성을 볼 수 있습니다. 구성 요소 세부 정보 페이지에서 종속성 목록을 찾습니다.

2.2.1

다음 표에는 이 구성 요소의 버전 2.2.1에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.15.0 소프트
2.2.0

다음 표에는 이 구성 요소의 버전 2.2.0에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.14.0 소프트
2.1.8 – 2.1.9

다음 표에는 이 구성 요소의 버전 2.1.8 및 2.1.9에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.13.0 소프트
2.1.7

다음 표에는 이 구성 요소의 버전 2.1.7에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.12.0 소프트
2.1.6

다음 표에는 이 구성 요소의 버전 2.1.6에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.11.0 소프트
2.1.5

다음 표에는 이 구성 요소의 버전 2.1.5에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.10.0 소프트
2.1.4

다음 표에는 이 구성 요소의 버전 2.1.4에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.9.0 소프트
2.1.3

다음 표에는 이 구성 요소의 버전 2.1.3에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.8.0 소프트
2.1.2

다음 표에는 이 구성 요소의 버전 2.1.2에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.7.0 소프트
2.1.1

다음 표에는 이 구성 요소의 버전 2.1.1에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.6.0 소프트
2.1.0 and 2.0.2

다음 표에는 이 구성 요소의 버전 2.1.0 및 2.0.2에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.5.0 소프트
2.0.1

다음 표에는 이 구성 요소의 버전 2.0.1에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.4.0 소프트
2.0.0

다음 표에는 이 구성 요소의 버전 2.0.0에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.3.0 소프트

다음 표에는 이 구성 요소의 버전 2.2.1에 대한 종속성이 나열되어 있습니다.

종속성 호환 버전 종속성 유형
Greengrass nucleus >=2.2.0 <2.15.0 소프트

구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하세요.

구성

이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음 구성 파라미터를 제공합니다.

2.2.x
defaultPort

(선택 사항)이 구성 요소가 IP 주소를 감지할 때 보고할 MQTT브로커 포트입니다. 기본 포트 8883과 다른 포트를 사용하도록 MQTT브로커를 구성하는 경우이 파라미터를 지정해야 합니다.

기본값: 8883

includeIPv4LoopbackAddrs

(선택 사항)이 옵션을 활성화하여 IPv4 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.

기본값: false

(선택 사항)이 옵션을 활성화하여 IPv4 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜(DHCP) 또는 정적으로 할당된 IP 주소가 없는 경우이 옵션을 사용합니다.

기본값: false

includeIPv6LoopbackAddrs

(선택 사항)이 옵션을 활성화하여 IPv6 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrsfalse, includeIPv6Addrstrue로 설정해야 합니다.

기본값: false

(선택 사항)이 옵션을 활성화하여 IPv6 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜(DHCP) 또는 정적으로 할당된 IP 주소가 없는 경우이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrsfalse, includeIPv6Addrstrue로 설정해야 합니다.

기본값: false

includeIPv4Addrs

(선택 사항) 기본값은 true로 설정됩니다. 이 옵션을 활성화하여 코어 디바이스에 있는 IPv4 주소를 게시할 수 있습니다.

기본값: true

includeIPv6Addrs

(선택 사항)이 옵션을 활성화하여 코어 디바이스에 있는 IPv6 주소를 게시할 수 있습니다. 이 옵션을 사용하려면 includeIPv4Addrsfalse로 설정합니다.

기본값: false

2.1.x
defaultPort

(선택 사항)이 구성 요소가 IP 주소를 감지할 때 보고할 MQTT브로커 포트입니다. 기본 포트 8883과 다른 포트를 사용하도록 MQTT브로커를 구성하는 경우이 파라미터를 지정해야 합니다.

기본값: 8883

includeIPv4LoopbackAddrs

(선택 사항)이 옵션을 활성화하여 IPv4 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.

기본값: false

(선택 사항)이 옵션을 활성화하여 IPv4 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜(DHCP) 또는 정적으로 할당된 IP 주소가 없는 경우이 옵션을 사용합니다.

기본값: false

2.0.x
includeIPv4LoopbackAddrs

(선택 사항)이 옵션을 활성화하여 IPv4 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.

기본값: false

(선택 사항)이 옵션을 활성화하여 IPv4 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜(DHCP) 또는 정적으로 할당된 IP 주소가 없는 경우이 옵션을 사용합니다.

기본값: false

defaultPort

(선택 사항)이 구성 요소가 IP 주소를 감지할 때 보고할 MQTT브로커 포트입니다. 기본 포트 8883과 다른 포트를 사용하도록 MQTT브로커를 구성하는 경우이 파라미터를 지정해야 합니다.

기본값: 8883

includeIPv4LoopbackAddrs

(선택 사항)이 옵션을 활성화하여 IPv4 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.

기본값: false

(선택 사항)이 옵션을 활성화하여 IPv4 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜(DHCP) 또는 정적으로 할당된 IP 주소가 없는 경우이 옵션을 사용합니다.

기본값: false

includeIPv6LoopbackAddrs

(선택 사항)이 옵션을 활성화하여 IPv6 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: localhost)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrsfalse, includeIPv6Addrstrue로 설정해야 합니다.

기본값: false

(선택 사항)이 옵션을 활성화하여 IPv6 링크-로컬 주소를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 동적 호스트 구성 프로토콜(DHCP) 또는 정적으로 할당된 IP 주소가 없는 경우이 옵션을 사용합니다. 이 옵션을 사용하려면 includeIPv4Addrsfalse, includeIPv6Addrstrue로 설정해야 합니다.

기본값: false

includeIPv4Addrs

(선택 사항) 기본값은 true로 설정됩니다. 이 옵션을 활성화하여 코어 디바이스에 있는 IPv4 주소를 게시할 수 있습니다.

기본값: true

includeIPv6Addrs

(선택 사항)이 옵션을 활성화하여 코어 디바이스에 있는 IPv6 주소를 게시할 수 있습니다. 이 옵션을 사용하려면 includeIPv4Addrsfalse로 설정합니다.

기본값: false

로컬 로그 파일

이 구성 요소는 Greengrass nucleus 구성요소와 동일한 로그 파일을 사용합니다.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
/greengrass/v2/logs/greengrass.log
이 구성 요소의 로그를 보려면
  • 코어 디바이스에서 다음 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다. /greengrass/v2 또는를 AWS IoT Greengrass 루트 폴더의 경로C:\greengrass\v2로 바꿉니다.

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

Changelog

다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.

버전

변경 사항

2.2.1

Greengrass 핵 버전 2.14.0 릴리스에 대한 버전이 업데이트되었습니다.

2.2.0

Greengrass nucleus 버전 2.13.0 릴리스용으로 업데이트된 버전입니다.

새로운 특성
  • IPv6에 대한 지원을 추가합니다. 이제를 로컬 메시징IPv6에 사용할 수 있습니다.

2.1.9

버그 수정 및 개선 사항
  • 디버그 로그 수준에서만 로그를 전송하도록 IP 획득 단계가 조정됩니다.

2.1.8

Greengrass nucleus 버전 2.12.0 릴리스용으로 업데이트된 버전입니다.

2.1.7

Greengrass nucleus 버전 2.11.0 릴리스용으로 업데이트된 버전입니다.

2.1.6

Greengrass nucleus 버전 2.10.0 릴리스용으로 업데이트된 버전입니다.

2.1.5

Greengrass nucleus 버전 2.9.0 릴리스용으로 업데이트된 버전입니다.

2.1.4

Greengrass nucleus 버전 2.8.0 릴리스용으로 업데이트된 버전입니다.

2.1.3

Greengrass nucleus 버전 2.7.0 릴리스용으로 업데이트된 버전입니다.

2.1.2

버그 수정 및 개선 사항
  • 특정 시나리오에서 이 구성 요소가 기록하는 오류 메시지가 개선됩니다.

  • Greengrass nucleus 버전 2.6.0 릴리스용으로 업데이트된 버전입니다.

2.1.1

Greengrass nucleus 버전 2.5.0 릴리스용으로 업데이트된 버전입니다.

2.1.0

개선 사항
  • 기본이 아닌 MQTT브로커 포트를 사용할 수 있는 defaultPort 파라미터를 추가합니다.

  • 로그 메시지가 더 명확하도록 업데이트됩니다.

2.0.2

Greengrass nucleus 버전 2.4.0 릴리스용으로 업데이트된 버전입니다.

2.0.1

Greengrass nucleus 버전 2.3.0 릴리스용으로 업데이트된 버전입니다.

2.0.0

초기 버전입니다.

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.