VDA5050 MQTT 연결 관리: 토픽 구조, QoS, connection 토픽과 LWT, 재연결

이 글의 핵심

VDA5050은 MQTT 위에서 order, instantActions, state, visualization, connection, factsheet 여섯 토픽으로 통신합니다. 표준은 order·state·visualization에 QoS 0, connection에 QoS 1과 retained, last will(CONNECTIONBROKEN)을 요구합니다. libVDA5050++ v2.11.3 시뮬레이터에서는 프로세스를 멈추면 keepalive 60초의 1.5배인 약 90초 뒤, 강제 종료하면 즉시 CONNECTIONBROKEN이 발행되었고, connection을 포함한 모든 토픽이 QoS 0으로 나갔습니다.

VDA5050 통신에서 제일 먼저 막히는 곳은 order 필드가 아니라 연결입니다. 토픽 이름이 한 글자만 달라도 메시지는 조용히 사라지고, 차량이 끊겼는지 알려 주는 방법이 따로 정해져 있습니다. 이 글은 VDA5050 2.0.0 문서(공식 저장소 2.0.0 태그의 VDA5050_EN_V1.md, 머리말에 “RELEASE CANDIDATE, FOR REVIEW”로 표기)의 6.2~6.5절, 6.13절, 6.14절을 기준으로 MQTT 연결 관리를 정리하고, 실제 어댑터가 어떻게 동작하는지 기록합니다.

실험 환경은 libVDA5050++ v2.11.3 위에서 만든 시뮬레이터(Ubuntu 24.04 aarch64 컨테이너), 브로커는 eclipse-mosquitto:2(Docker, 기본 설정에 익명 허용, 영속성 끔)입니다. 시리얼 번호는 blog001, 제조사는 sim입니다. 다른 구현이나 다른 브로커 설정에서는 결과가 다를 수 있습니다.

토픽 구조

표준 6.3절은 토픽 레벨을 이렇게 제안합니다.

interfaceName/majorVersion/manufacturer/serialNumber/topic
예: uagv/v2/KIT/0001/order

“제안”이라는 점이 중요합니다. 클라우드 브로커는 토픽 구조가 정해져 있는 경우가 있어서 표준은 구조를 강제하지 않고, 끝의 토픽 이름만 필수로 둡니다. 레벨별 규칙은 다음과 같습니다.

레벨내용
interfaceName사용하는 인터페이스 이름 (예: uagv)
majorVersion메이저 버전 앞에 v를 붙임 (예: v2)
manufacturer차량 제조사
serialNumber영문 대소문자, 숫자, _, ., :, -만 사용
topicorder, state 등 6.5절의 이름

슬래시는 토픽 계층 구분자이므로 어느 레벨에도 쓰면 안 되고, 브로커 내부용 토픽이 $로 시작하는 경우가 있어 $도 피하라고 합니다.

6.5절의 여섯 토픽은 다음과 같습니다.

토픽발행구독용도구현
order관제AGV주행 order 전달필수
instantActions관제AGV즉시 실행할 액션필수
stateAGV관제차량 상태필수
visualizationAGV시각화 시스템시각화 전용 고빈도 위치선택
connection브로커/AGV관제연결 끊김 표시필수
factsheetAGV관제관제 쪽 차량 설정필수

connection에는 주의 문구가 붙어 있습니다. 관제가 차량 건강 상태를 확인하는 용도로 쓰면 안 되고, MQTT 프로토콜 수준의 연결 확인용으로 추가한 토픽이라는 설명입니다. 차량이 정상인지는 state가 계속 오는지, 그 안의 errors가 무엇인지로 판단하라는 뜻입니다.

시뮬레이터에서 실제로 어떤 토픽이 어떤 속성으로 나가는지 mosquitto_sub -F '%t qos=%q retain=%r'로 확인했습니다. 구독을 QoS 2로 걸어도 발행 QoS보다 높게 전달되지는 않으므로, 이 값이 발행 쪽 QoS입니다.

uagv/v2/sim/blog001/connection     qos=0 retain=1
uagv/v2/sim/blog001/state          qos=0 retain=0
uagv/v2/sim/blog001/visualization  qos=0 retain=0

state와 visualization은 약 1초 간격으로 나왔고, visualization 메시지의 최상위 키는 agvPosition과 헤더(headerId, manufacturer, serialNumber, timestamp, version)뿐이었습니다. 표준 6.13절대로 위치(와 속도)만 담고, 발행 주기는 통합자가 정합니다.

QoS: 표준과 구현이 다른 곳

표준 6.2절은 QoS를 이렇게 정합니다.

  • order, state, visualization: QoS 0 (최대 한 번, 통신 부담을 줄이기 위해)
  • connection: QoS 1 (최소 한 번)

시뮬레이터가 쓰는 라이브러리 소스(core/messages/mqtt_module.h)에는 const int k_qos = 0;이 하나 있고, 구독과 발행, last will 모두 이 값을 씁니다. 위 출력에서 connection도 QoS 0으로 나간 것이 그 결과입니다. 표준과 다른 부분이므로, connection의 QoS 1에 기대는 관제를 만든다면 어댑터가 실제로 어떤 QoS로 발행하는지 확인해야 합니다. 표준이 QoS 0을 고른 이유(통신 부담)대로, order가 유실될 수 있다는 점은 아래 실험에서 직접 확인했습니다.

connection 토픽과 last will

6.14절의 connection 메시지는 헤더 필드에 connectionState 하나가 더해진 구조입니다.

connectionState의미
ONLINEAGV와 브로커의 연결이 살아 있음
OFFLINEAGV가 합의된 방식으로 연결을 끊음
CONNECTIONBROKEN연결이 예기치 않게 끊김

표준이 정한 절차는 다음과 같습니다.

  1. 연결할 때 last will을 uagv/v2/제조사/SN/connection, connectionState: CONNECTIONBROKEN으로 등록한다.
  2. 연결된 뒤 같은 토픽에 ONLINE을 발행한다.
  3. 정상 종료할 때는 OFFLINE을 먼저 발행하고 MQTT DISCONNECT를 보낸다. 이 경우 브로커는 last will을 발행하지 않는다.
  4. 예기치 않게 끊기면 브로커가 등록된 last will(CONNECTIONBROKEN)을 발행한다.

이 토픽의 모든 메시지는 retained 플래그를 붙이라고 합니다. 새로 구독한 관제가 가장 최근 연결 상태를 바로 받기 위해서입니다. 끊김 감지는 브로커와 클라이언트 사이의 heartbeat(keepalive)로 이루어지고, 간격은 브로커마다 설정할 수 있으며 15초 정도를 권장합니다.

표준에는 한계도 적혀 있습니다. last will은 접속하는 순간에 만들어 등록하기 때문에 timestamp와 headerId는 항상 오래된 값이 됩니다.

실험: 연결이 끊기는 방식에 따라 달라지는 것

시뮬레이터를 브로커에 연결하고 connection 토픽을 구독한 채로 끊김을 네 가지 방식으로 만들었습니다. 시각은 구독 쪽이 받은 시각(UTC)입니다.

상황방법결과
시작컨테이너 실행ONLINE, headerId 1, retained 플래그 1
프로세스 멈춤 (네트워크 연결은 유지)docker pause03:55:07에 멈춤, 03:56:37에 CONNECTIONBROKEN: 90초 뒤
멈춘 프로세스 재개docker unpause약 10초 뒤 ONLINE 재발행 (headerId 2)
정상 종료docker stop (SIGTERM)즉시 OFFLINE(headerId 3), CONNECTIONBROKEN 없음
강제 종료docker kill (SIGKILL)1초 안에 CONNECTIONBROKEN(headerId 0)

핵심은 두 가지입니다.

첫째, 끊김 감지 시간은 끊기는 방식에 달려 있습니다. 프로세스가 죽으면 OS가 TCP 연결을 닫아서 브로커가 바로 알고, will이 즉시 나갑니다. 반면 프로세스가 멈췄거나 네트워크가 사라져서 TCP가 닫히지 않으면 브로커는 keepalive 간격의 1.5배가 지나야 끊김으로 판단합니다. 이 라이브러리는 설정 파일의 keep_alive_interval_ms를 지정하지 않으면 Paho 기본값을 쓰는데, 관찰한 90초는 60초의 1.5배와 맞습니다(기본값이 60초라는 점은 소스를 읽지 않고 이 측정값으로 추정했습니다). 즉 아무 설정 없이 쓰면 무선 구간이 끊긴 차량을 관제가 알기까지 1분 반이 걸립니다. 표준의 15초 권장을 따르려면 어댑터의 keepalive를 명시해야 합니다.

둘째, 정상 종료와 강제 종료는 connection에 서로 다른 값을 남깁니다. 관제는 OFFLINE을 “예정된 종료”로, CONNECTIONBROKEN을 “장애”로 구분해서 처리할 수 있습니다. 두 값 모두 retained로 남기 때문에 나중에 구독한 쪽도 마지막 상태를 받습니다. 정상 종료 직후 브로커에 남은 retained 메시지는 OFFLINE(headerId 3)이었습니다.

관찰한 will 메시지의 내용도 표준의 설명 그대로입니다.

{"connectionState":"CONNECTIONBROKEN","headerId":0,"manufacturer":"sim","serialNumber":"blog001","timestamp":"2026-10-31T03:54:22.175Z","version":"2.0.0"}

headerId는 0이고 timestamp는 연결을 시작한 시각이라서 바로 뒤에 보낸 ONLINE(03:54:23.188)보다 오래된 값입니다. 관제가 timestamp로 메시지 순서를 가리면 CONNECTIONBROKEN이 ONLINE보다 먼저 일어난 일처럼 보입니다. 순서는 브로커가 전달한 도착 순서로 판단해야 합니다.

재연결

docker unpause로 되살린 프로세스는 로그에 connection lost를 남기고 약 4초 뒤 MqttModule: online으로 돌아왔고, ONLINE이 headerId 2로 다시 발행되었습니다. 소스를 보면 이 라이브러리는 자동 재연결을 켜고(최소 2초, 최대 16초 간격 기본값) clean_session을 false로 둡니다. 프로세스가 같은 시리얼로 완전히 재시작하면 headerId는 1부터 다시 시작했습니다(connection 토픽 기준). 관제가 headerId로 중복이나 순서를 걸러낸다면 재시작을 고려해야 합니다.

헤더를 어디까지 검사하는가

표준 6.4절의 헤더는 headerId, timestamp, version, manufacturer, serialNumber입니다. 버전은 의미 있는 버전 표기(메이저.마이너.패치)를 따르고, headerId는 토픽별로 메시지를 보낼 때마다 1씩 증가합니다(받지 못한 메시지도 센다).

이 검사를 order에 대해 시뮬레이터에서 시험했습니다. 매번 차량이 선 자리에서 시작하는 정상 order를 보내고 헤더나 토픽만 바꿨습니다. “수락”은 state의 orderId가 바뀐 것을 기준으로 했습니다.

변경수락state의 새 오류
정상예없음
토픽 uagv/v1/...아니오없음
토픽 UAGV/v2/... (대문자)아니오없음
토픽의 시리얼이 다른 차량아니오없음
헤더 serialNumber 불일치아니오Header.serialNumber is "other999", requires "blog001"
헤더 manufacturer 불일치아니오Header.manufacturer is "acme", requires "sim"
헤더 version 9.9.9아니오Header.version is 9.9.9, requires one of {"2.0.0"}
헤더 version 2.0.1아니오위와 같은 형식
헤더 version 1.1.0아니오위와 같은 형식
timestamp 없음아니오Deserialzation Error: MqttModule could not parse message...
headerId 없음아니오위와 같음
headerId가 직전(900)보다 작은 0예없음
timestamp가 "yesterday"예없음
timestamp에 밀리초 없음예없음

토픽이 다른 메시지는 구독 자체가 되지 않아서 차량이 존재를 알지 못하므로 오류도 남지 않습니다. 관제 쪽에서 보면 “보냈는데 아무 반응이 없다”는 증상이 되는 가장 흔한 원인입니다. 토픽 오타나 인터페이스 이름 대소문자, 메이저 버전 접두어가 어긋난 경우를 먼저 확인하세요.

헤더 쪽에서는 세 가지가 눈에 띕니다.

  • 버전은 문자열이 정확히 2.0.0이어야 했습니다. 표준은 패치 버전을 “정밀도 향상 같은 호환되는 변경”으로 설명하는데, 이 구현은 2.0.1도 거절합니다. 관제 쪽에서 패치 버전이 올라간 차량과 섞어 쓸 때 주의할 부분입니다.
  • headerId는 필수 필드이지만 값의 증가 여부는 검사하지 않습니다. 순서를 보장하지 않는 QoS 0 환경에서 headerId는 관제가 중복과 순서를 판단할 유일한 근거인데, 어댑터는 그 판단을 해 주지 않습니다.
  • timestamp도 필드 존재만 확인하고 형식은 검사하지 않았습니다. 표준은 ISO 8601 UTC 형식을 요구합니다. 관제가 시계를 맞추어 보내는 책임은 그대로 남습니다.

거절 오류 문구 자체는 order 거절 오류 모음에서 다른 시나리오와 함께 정리했습니다.

연결이 끊긴 동안의 order

표준 6.2절은 AGV가 브로커와 끊어져도 order 정보를 유지하고, 마지막 released 노드까지 order를 수행한다고 정합니다. 연결이 끊겼다고 차량이 멈추는 것이 아니라는 뜻입니다. 그래서 관제는 CONNECTIONBROKEN을 받았을 때 “차량이 멈췄다”고 가정하면 안 됩니다. 이 부분은 표준 문장을 옮긴 것이고, 연결을 끊은 채 주행하는 동작은 시뮬레이터에서 시험하지 않았습니다.

order가 전달되는 방식은 시험했습니다. 시뮬레이터를 정지한 상태에서 order를 발행하고 다시 시작해 state를 확인했습니다.

시나리오재시작 후 state
retained 아닌 order를 AGV가 꺼진 동안 발행orderId 비어 있음. 유실
retained로 order 발행 후 AGV 시작orderId: ret-1, 마지막 노드 n1. order가 실행됨
retained order가 남은 채 AGV 다시 재시작또 orderId: ret-1 실행. 매번 다시 처리됨

QoS 0이면서 구독이 새 세션인 경우(컨테이너를 새로 만든 경우) 꺼진 동안의 메시지는 브로커가 쌓아 두지 않습니다. 이 점이 두 가지 결론으로 이어집니다.

  • 관제는 ONLINE을 받거나 state가 다시 오기 시작하면, 차량이 어떤 order를 알고 있는지 state의 orderId와 orderUpdateId로 확인한 뒤 필요한 order를 다시 보내야 합니다. “보내 두면 켜질 때 받겠지”는 통하지 않습니다.
  • order를 retained로 발행하면 안 됩니다. 차량이 재시작할 때마다 이미 끝난 order가 다시 들어옵니다. 실수로 retained로 발행했다면 같은 토픽에 빈 페이로드를 retained로 발행해서 지워야 합니다(이 실험에서 mosquitto_pub -r -n으로 지웠습니다).

관제 구현 체크리스트

표준과 위 실험에서 도출한 해석입니다. 표준이 직접 요구하는 문장이 아닌 항목은 그렇게 표시합니다.

  • 구독: 차량마다 .../connection(retained를 받으므로 구독 직후 마지막 상태를 얻음)과 .../state를 구독한다. 차량 수가 많으면 와일드카드(uagv/v2/+/+/state)를 쓴다.
  • connection을 건강 지표로 쓰지 않는다 (표준): 차량 상태는 state가 계속 오는지, errors가 무엇인지로 본다. state가 일정 시간 오지 않는 것을 별도로 감시한다. 이 기준 시간은 통합자가 정한다.
  • 끊김 시간 정하기 (해석): 어댑터의 keepalive와 브로커 설정을 확인한다. 기본값을 쓰는 어댑터라면 감지 지연이 keepalive의 1.5배라는 점을 측정해 둔다. 표준은 15초 정도를 권장한다.
  • 상태 구분 (해석): OFFLINE과 CONNECTIONBROKEN을 구분해서 알림을 다르게 낸다. 둘 다 retained이므로 관제를 재시작해도 마지막 값을 받는다.
  • 순서 판단 (해석): connection의 순서는 timestamp가 아니라 도착 순서로 본다. will의 timestamp는 접속 시각이다.
  • 재연결 후 (해석): ONLINE을 받으면 state의 orderId, orderUpdateId, lastNodeId를 보고 order를 다시 보낼지 정한다. order와 instantActions는 retained로 발행하지 않는다.
  • 헤더 (실험 기반): version은 차량이 지원하는 값과 정확히 같게 보낸다. manufacturer와 serialNumber는 토픽과 같은 값으로 채운다. headerId는 토픽별로 증가시키고 값이 줄어들 수 있다는 가정 하에 중복 처리를 설계한다.
  • 토픽 검증: 인터페이스 이름, 메이저 버전, 제조사, 시리얼의 대소문자까지 차량 쪽과 같은지 확인한다. 어긋나면 오류 없이 메시지가 사라진다.

한계

표준은 2.0.0 문서(릴리스 후보 표기)를 기준으로 했고, 이후 버전에서 연결 관련 규정이 바뀌었는지는 확인하지 않았습니다. 실험은 libVDA5050++ v2.11.3 위의 시뮬레이터 하나와 Mosquitto 2의 기본 설정에서만 했습니다. 다음은 확인하지 못했습니다.

  • 연결이 끊긴 채로 차량이 order를 이어서 수행하는지 (표준 문장만 인용)
  • TLS, 사용자 인증, 브로커 ACL (표준은 “보안은 브로커 설정으로 다룬다”고만 합니다)
  • QoS 1 이상으로 order를 보내는 경우와 영속 세션에서의 메시지 큐잉
  • 클라우드 브로커(AWS IoT Core, Azure IoT Hub 등)의 토픽 제약
  • 라이브러리 소스에 retained로 설정된 factsheet는 이번 시뮬레이터의 브로커에서 retained 메시지로 확인되지 않았습니다(남아 있던 retained는 connection 하나였습니다). 어떤 시점에 발행되는지는 factsheet 해설을 참고하세요.
  • visualization의 발행 주기 설정 방법

이 글의 OFFLINE, CONNECTIONBROKEN, QoS 값은 위 환경에서 구독자가 받은 값이며, 구현이나 브로커가 바뀌면 다시 측정해야 합니다.


같이 보면 좋은 글