기본 제공 직접 메서드를 사용하여 여 edgeAgent와 통신
적용 대상:
IoT Edge 1.5 IoT Edge 1.4
Important
IoT Edge 1.5 LTS 및 IoT Edge 1.4 LTS는 지원되는 릴리스입니다. IoT Edge 1.4 LTS는 2024년 11월 12일에 수명이 종료됩니다. 이전 릴리스에 있는 경우 IoT Edge 업데이트를 참조하세요.
IoT Edge 에이전트 모듈에 포함된 직접 메서드를 사용하여 IoT Edge 배포를 모니터링하고 관리합니다. 직접 메서드는 디바이스에서 구현된 다음 클라우드에서 호출할 수 있습니다. IoT Edge 에이전트에는 IoT Edge 디바이스를 원격으로 모니터링하고 관리하는 데 도움이 되는 직접 메서드가 포함되어 있습니다.
직접 메서드, 그 사용 방법 및 사용자 고유의 모듈에서 이를 구현하는 방법에 대한 자세한 내용은 IoT Hub에서의 직접 메서드 인식 및 호출을 참조하세요.
직접 메서드의 이름은 대/소문자를 구분하지 않고 처리됩니다.
Ping
Ping 메서드는 IoT Edge가 디바이스에서 실행되고 있는지 여부 또는 디바이스에 IoT Hub에 대한 열린 연결이 있는지 여부를 확인하는 데 유용합니다. 이 직접 메서드를 사용하여 IoT Edge 에이전트를 ping하고 해당 상태를 가져옵니다. 성공적인 ping은 빈 페이로드 및 “status”: 200을 반환합니다.
예시:
az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'
Azure Portal에서 메서드 이름이 ping이며 빈 JSON 페이로드({})가 있는 메서드를 호출합니다.
모듈 다시 시작
RestartModule 메서드는 IoT Edge 디바이스에서 실행되는 모듈의 원격 관리를 허용합니다. 모듈이 실패 상태 또는 기타 비정상 동작을 보고하는 경우 IoT 모듈을 다시 시작하도록 IoT Edge 에이전트를 트리거할 수 있습니다. 성공적으로 다시 시작하는 명령은 빈 페이로드 및 “status”: 200을 반환합니다.
RestartModule 메서드는 IoT Edge 버전 1.0.9 이상에서 사용할 수 있습니다.
팁
Azure Portal의 IoT Edge 문제 해결 페이지에서는 모듈을 다시 시작하기 위한 간소화된 환경을 제공합니다. 자세한 내용은 Azure Portal에서 IoT Edge 디바이스 모니터링 및 문제 해결을 참조하세요.
edgeAgent 모듈 자체를 포함하여 IoT Edge 디바이스에서 실행되는 모든 모듈에서 RestartModule 직접 메서드를 사용할 수 있습니다. 단, 이 직접 메서드를 사용하여 edgeAgent를 종료하는 경우 모듈을 다시 시작하는 동안 연결이 중단되므로 성공 결과를 수신할 수 없습니다.
예시:
az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
{
"schemaVersion": "1.0",
"id": "<module name>"
}
'
Azure Portal에서 메서드 이름이 RestartModule이며 다음과 같은 JSON 페이로드가 있는 메서드를 호출합니다.
{
"schemaVersion": "1.0",
"id": "<module name>"
}
진단 직접 메서드
- GetModuleLogs: 직접 메서드의 응답에서 모듈 로그를 인라인으로 검색합니다.
- UploadModuleLogs: 모듈 로그를 검색하고 Azure Blob Storage에 업로드합니다.
- UploadSupportBundle: 지원 번들을 사용하여 모듈 로그를 검색하고 Azure Blob Storage에 zip 파일을 업로드합니다.
- GetTaskStatus: 업로드 로그 또는 지원 번들 요청의 상태를 확인합니다.
1.0.10 릴리스부터 진단 직접 메서드를 사용할 수 있습니다.