Cloud IoT Core 문제 해결

Classic/VPC 환경에서 이용 가능합니다.

Cloud IoT Core를 이용하면서 사용자가 만날 수 있는 문제 상황과 원인 및 해결 방법을 안내합니다. 하지만 일부 문제 상황은 다음 안내를 숙지하여도 사용자가 직접 해결하기 어려운 과제일 수 있습니다. 이러한 사용자의 어려움을 효율적으로 해결하고자 네이버 클라우드 플랫폼은 다양한 문제 해결 창구도 함께 제공하고 있습니다.

규칙

규칙과 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

규칙이 더 이상 생성되지 않습니다.

• 원인: 생성 가능한 규칙의 개수는 100개입니다.
• 해결 방법: 생성된 규칙의 수가 100개를 초과하였는지 확인해 주십시오.

쿼리검증 버튼을 누르면 오류가 발생합니다.

• 원인: 허용되는 문자 및 데이터베이스에서 사용하는 SQL과 달리 기능 제한이 있을 수 있습니다.
• 해결 방법: 규칙 쿼리 작성에서 내용을 확인한 후 규칙에 맞지 않는 형식이나 특수 문자가 사용되지 않았는지 확인해 주십시오.

쿼리 검증 시 'Unexpected Keyword' 오류가 발생합니다.

• 원인: JSON 필드 Key와 Keyword와 같을 떄 발생하는 오류입니다.
• 해결 방법: JSON 필드 Key가 Keyword와 같으면, __"(Double Quotes)__로 감싸서 JSON 필드 Key 값임을 명시해 주십시오.

액션

액션과 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

재발행 토픽에 # (또는 +)이 입력되지 않습니다.

• 원인: #(해시태그), +(더하기) 문자는 MQTT에서 사용하는 Wildcard로 MQTT 메시지 Publish 토픽으로 적합하지 않습니다. FROM절의 토픽으로 다시 받을 수 있는 토픽으로 재발행 시 지속적인 순환 구조가 발생할 가능성이 있어 입력이 제한됩니다. <예시> FROM "topic/+", 메시지 재발행 액션에 토픽은 topic/home 일 경우 순환 구조 발생
• 해결 방법: 재발행 토픽에 # 또는 +를 사용하지 마십시오.

가상 디바이스 미러

가상 디바이스 미러와 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

가상 디바이스 미러 생성 및 수정 시 오류가 발생합니다.

• 원인: 잘못된 명령어를 입력했거나 내부 서버 오류가 있을 때 발생하는 오류입니다.
• 해결 방법: 다음을 참고해 주십시오.

  코드	오류 메시지	내용
  400	Number of mirrors on the device is over maximum limit	가상 디바이스 하나에 생성 가능한 미러 수를 초과하여 생성 불가(최대 10개)
  400	Invalid json payload	미러 메시지가 JSON 형식이 아님
  400	Missing state message	미러 메시지에 state 메시지가 없음
  400	State message is not json object	미러 메시지의 state 메시지는 JSON Object이어야 함
  400	State message contains an invalid key	미러 메시지에 state 하위에 허용되지 않은 key가 있음(reported와 desired만 허용)
  400	Reported message is not json object	reported 메시지는 JSON Object이어야 함
  400	Desired message is not json object	desired 메시지는 JSON Object이어야 함
  400	Reported, desired contains too many levels of nesting json. Maximum allowed is 6	desired와 reported의 하위 단계 JSON(Nested JSON)은 최대 6단계
  400	Mirror name not allow special character.	가상 디바이스 이름에 '_', '-' 를 제외한 특수 문자는 포함할 수 없음
  400	Invalid version	version 값이 유효하지 않음. 0보다 큰 정수여야 함
  400	Invalid client token	clientToken 값이 유효하지 않음. 1 ~ 64byte String이어야 함
  404	No mirror exist	가상 디바이스 미러가 존재하지 않음
  404	No device exist	가상 디바이스가 존재하지 않음
  413	Payload too big	가상 디바이스 미러 메시지 페이로드가 너무 큼(허용 범위: UTF-8 인코딩 최대 5 Kbyte)
  413	Topic length too long or empty. Maximum allowed is 1 ~ 64	가상 디바이스 미러의 메시지 토픽 길이가 유효하지 않음(허용 범위: 1자~64자)
  409	Version conflict	전송된 version과 저장된 가상 디바이스 미러의 version이 일치하지 않음
  500	Internal server error	내부 서버 오류

Cloud Functions 연동

Cloud Functions 연동과 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

Cloud Functions 연동 시 'Cloud Functions로 데이터 전송' 팝업 창에 아무것도 조회되지 않습니다.

• 원인: Cloud Functions는 사용자가 개발한 코드를 실행하는 서비스로, Cloud Functions에 등록된 Cloud Functions 트리거 및 Cloud Functions 액션이 있어야 연동할 수 있습니다.
• 해결 방법: Cloud Functions에 사용자가 생성한 Cloud Functions 트리거가 있는지 확인해 주십시오.

"Too many concurrent requests in flight..." 오류 메시지가 반환됩니다.

• 원인: Cloud Functions에서는 한 명의 사용자가 동시에 실행할 수 있는 Function의 개수를 제한하고 있습니다.
• 해결 방법: 동시 실행 가능한 Function의 수를 늘려야 할 경우, Cloud Functions 서비스로 문의해 주십시오. 자세한 내용은 Cloud Functions 시스템 제한을 참고해 주십시오.

설정한 배치 시간보다 Cloud Functions 트리거가 빨리 혹은 자주 실행됩니다.

• 원인: Cloud Functions 액션의 파라미터는 1 MB를 초과할 수 없습니다.
• 해결 방법: IoT 배치 메시지가 제한된 크기를 초과할 경우, 설정한 배치 시간과 관계없이 Cloud Functions 액션을 바로 실행합니다.