MQTT 커넥터를 등록하여 규칙 트리거 시 외부 MQTT 브로커로 메시지를 발행할 수 있습니다.
MQTT 커넥터는 지정된 브로커에 연결됩니다. 브로커의 네트워크 접근이 필요합니다.
MQTT 커넥터 관리 페이지
파이프라인 > 액션 > 서비스 연동 설정 > MQTT 커넥터 관리로 이동합니다.
등록된 커넥터 정보가 표시됩니다:
- 커넥터 이름
- 그룹
- 브로커 주소 및 포트
- TLS 사용 여부
- 사용자명 (인증 사용 시)
커넥터 추가
커넥터 추가 버튼을 클릭하여 새 MQTT 커넥터를 등록합니다.
| 항목 | 설명 |
|---|---|
| 그룹 | 커넥터가 속할 그룹 선택 |
| 커넥터 이름 | IOTOWN에서 사용할 커넥터 이름 (예: 테스트 커넥터 2) |
| 호스트 | MQTT 브로커 주소 (예: town.coxlab.kr) |
| 포트 | MQTT 브로커 포트 (기본: 1883, TLS: 8883) |
| TLS 사용 | TLS/SSL 암호화 연결 사용 여부 |
| 사용자명 | 브로커 인증 사용자명 (선택) |
| 비밀번호 | 브로커 인증 비밀번호 (선택) |
MQTT 액션 생성
커넥터가 등록되면 MQTT 타입의 액션을 생성할 수 있습니다.
- 파이프라인 > 액션 > 액션 생성 클릭
- 액션 타입에서 MQTT 선택
- 설정 탭에서:
- 사용할 MQTT 커넥터 선택
- 발행할 MQTT 토픽 입력
- 페이로드 템플릿 탭에서 메시지 템플릿 작성 (선택)
- 생성 클릭
토픽 설정
토픽에 템플릿 변수를 사용하여 동적으로 토픽을 지정할 수 있습니다.
| 변수 | 설명 |
|---|---|
| {{group.id}} | 그룹 ID |
| {{device.id}} | 장치 ID |
예시: devices/{{device.id}}/alerts
IOTOWN 브로커 사용 시 토픽 형식: iotown/{{group.id}}/{{device.id}}/action
페이로드 템플릿 예시
JSON
규칙에 액션 연결
생성한 MQTT 액션을 규칙에 연결합니다.
- 파이프라인 > 규칙 > 규칙 선택 또는 새 규칙 생성
- 액션 단계에서 MQTT 액션 선택
- 저장
이제 규칙 조건이 충족되면 지정된 MQTT 브로커로 메시지가 발행됩니다.
문제 해결
연결 실패
- 브로커 주소와 포트가 정확한지 확인하세요
- IOTOWN 서버에서 브로커 네트워크에 접근 가능한지 확인하세요
- TLS 설정이 브로커 설정과 일치하는지 확인하세요
인증 실패
- 사용자명과 비밀번호가 정확한지 확인하세요
- 브로커의 ACL(접근 제어 목록) 설정을 확인하세요
메시지가 발행되지 않음
- 커넥터가 활성화 상태인지 확인하세요
- 액션이 활성화 상태인지 확인하세요
- 규칙이 활성화 상태인지 확인하세요
- 토픽에 발행 권한이 있는지 확인하세요