스마트팩토리 온도 수집 이력을 EASY LOGGER에서 확인하고 HTTP API 연동을 설계하는 방법

스마트팩토리의 온도 값과 운영 기록을 잇는 흐름

온도센서가 있는 생산 구역에서 EASY-TEMP를 현장 값의 발행 측에 둡니다. EASY-LINK는 MQTT로 값을 보내고, EASY LOGGER는 그 값을 구독하는 산업용 IoT 게이트웨이이자 수집 장치로 구성합니다. 이 구성에서는 값의 수신, 저장 이력, 전달 상태를 구분해 확인합니다.

국내 중소기업 전략기술 로드맵은 스마트 제조의 구성요소로 센서·네트워크·플랫폼을 설명하고, MES를 제조현장을 모니터링하는 시스템으로 분류합니다. 여기서는 그 흐름을 한 공정의 온도 기록에 적용합니다. EASY LOGGER 대시보드는 현장 표시를 맡고, MES·CIM과의 데이터 연동은 MQTT·HTTP API·DB 인터페이스 범위에서 설계합니다.

값의 발행, 구독, 저장, 조회가 이어지는 순서를 나타냅니다.

EASY-LINK 구독과 수집 조건을 맞춥니다

MAIN 설정의 PLC 연결 설정에서 CONNECTION PROTOCOL을 EASY-LINK로 고르고 PRODUCT는 TEMP를 선택합니다. EASY-LINK는 PLC처럼 값을 요청받는 방식이 아니라 MQTT 메시지를 보내고, EASY LOGGER는 이를 구독합니다. Self · 관리자 MQTT 재사용은 EASY LOGGER 자체 브로커를 쓰는 구성이고, External · 장치 브로커는 BROKER HOST, PORT, USERNAME, PASSWORD, CLIENT ID, TLS를 입력하는 구성입니다.

수집 조건에서는 SUBSCRIBE TOPIC을 매뉴얼 예시인 EASYLINK/TEMP로 놓고 ROOT KEY는 TEMP 기본값인 EASYTEMP를 확인합니다. ADDRESSES에는 실제 메시지에서 확인한 주소키만 넣습니다. 토픽 스캔으로 들어온 토픽과 키를 확인한 다음 결과를 선택하면 입력란이 채워집니다. 주소키의 실제 이름은 제공된 매뉴얼에 없으므로 현장 메시지를 확인한 뒤 확정합니다.

TRIGGER의 On message는 수신할 때마다 한 행을 기록하고 Timer는 정해진 주기마다 최신값을 기록합니다. STALE AFTER (MS)는 수신이 멈춘 경우 값을 null로 남기고 결함으로 표시하는 기준입니다. WRITE TOPIC은 비워 두며, 매뉴얼에 따라 EASY-LINK TEMP의 쓰기는 대시보드·MQTT·API·OPC-UA에서 거부됩니다.

MySQL 저장 이력과 대시보드를 확인합니다

DB 설정에서는 MariaDB/MySQL 저장과 로컬 CSV 저장 중 하나를 선택합니다. MySQL을 쓰는 경우 ENABLE, DB Name, Host Address, Port, User, Password를 입력한 뒤 연결 테스트와 설정 저장을 진행합니다. 자체 DB저장일 때 Host Address는 127.0.0.1이며, DB와 CSV는 동시에 켤 수 없습니다.

저장 뒤에는 화면 아래 DB·PLC·API·MQTT·OPCUA 상태 표시등과 MAIN 설정의 저장 PLC 목록, 저장 설정 목록을 함께 확인합니다. RUNNING은 통신과 수집이 정상임을 뜻하고, 브로커 연결이 끊기면 해당 EASY-LINK 설정만 SKIPPED가 됩니다. DB 조회에서는 테이블과 기간을 정한 뒤 조회하고, Timestamp·Config·Address·Value를 확인합니다. 필요하면 조회 후 CSV 출력으로 기록을 내려받습니다.

EASY LOGGER 대시보드에서는 게이지와 그래프로 수집값을 표시할 수 있습니다. 화면 표시와 별도로 DB 이력 로그의 전체 처리 건수, 성공률, 마지막 오류 시각을 확인합니다. 이렇게 값의 표시, 저장 이력, 전달 상태를 나누어 점검합니다.

MQTT·HTTP API·MySQL 전달 대상을 비교합니다

이 글의 주 전달 대상은 HTTP API입니다. MES·CIM과 연결할 데이터 인터페이스 후보로 두되, 제공된 매뉴얼 발췌에는 실제 HTTP API 엔드포인트와 본문 형식이 제시되지 않습니다. 주소나 JSON 필드를 임의로 정하지 않고 실제 API 명세를 확인해야 합니다.

MQTT는 브로커를 통해 수집값을 발행할 수 있지만 브로커 연결과 토픽을 점검해야 합니다. MySQL은 저장된 이력을 기간별로 조회할 수 있지만 DB 접속 정보와 보존 기간을 관리해야 합니다. Firebase는 이 발췌에 설정 절차가 없으므로 실제 전달 경로로 단정하지 않습니다. 상위 시스템의 데이터베이스 인터페이스를 정할 때 필요한 자료가 최신값인지 과거 이력인지 먼저 구분합니다.

발행 상태와 저장 결과를 별도로 확인하는 지점을 나타냅니다.

EASY LOGGER HTTP API 예제

HTTP API를 상위 시스템의 주 전달 인터페이스로 잡더라도 제공된 매뉴얼에서 확인 가능한 구체 식별자는 EASY-LINK 수집 토픽뿐입니다. 아래 코드는 실행 요청이 아니라 확인된 수집 설정과 요청된 callback 키를 적은 점검 메모입니다. 상위 시스템의 POST + JSON 계약과 callback endpoint 주소는 실제 API 명세에서 확인해야 하며, 이 예시에 임의 값을 넣지 않습니다.

CONNECTION PROTOCOL: EASY-LINK
PRODUCT: TEMP
SUBSCRIBE TOPIC: EASYLINK/TEMP
ROOT KEY: EASYTEMP
write_callback_url:

화면에서는 MAIN 설정의 저장 설정 목록에서 STATUS를 보고, DB 조회에서 기록을 확인한 다음 화면 아래 API 상태 표시등을 확인합니다. Endpoint Preview와 API Payload Log는 제공된 매뉴얼 발췌에 화면 항목이나 사용 절차가 없으므로 이 글에서 결과를 단정하지 않습니다. 실제 엔드포인트와 payload를 확보한 뒤 상위 시스템의 수신 기록과 대조합니다.

다음 경계는 읽기 전용 TEMP가 아닌, 별도로 허용한 PLC 쓰기 경로를 운영할 때 적용합니다. 테스트 주소만 사용합니다. 최소 권한만 부여합니다. 허용 주소 범위를 제한합니다. PLC 인터록을 확인합니다. 수동 복구 절차를 준비합니다. WRITE CALLBACK을 호출합니다.

한 공정에서 시작하는 운영 점검

처음에는 한 공정의 수집 조건만 등록하고 연결 테스트, 토픽 스캔, STATUS, DB 조회 순서로 확인합니다. PLC 연동이 추가된다면 PLC NAME과 CONFIG NAME이 외부 연동 주소의 기준이 되므로 등록 시점에 이름을 확정합니다. 수집 주기를 짧게 잡을수록 PLC와 네트워크 부하가 늘 수 있으므로 필요한 주소만 남기고 수집 상태를 살핍니다.

운영 중 값이 보이지 않으면 먼저 브로커 접속과 구독 토픽을 확인합니다. SKIPPED는 EASY-LINK 브로커 연결 같은 선행 조건이 없어 건너뛰는 상태이며, 연결이 복구되면 재개됩니다. 저장 결과가 비어 있다면 DB 연결 상태와 수집 설정, 조회 기간을 순서대로 확인합니다. 스마트팩토리의 현장 연결 가능 여부를 먼저 확인한 뒤 같은 방식으로 범위를 넓힙니다.

제품 구성은 홈에서, 다른 인터페이스 사례는 블로그 목록에서 확인할 수 있습니다. 상위 연동의 비교 기준이 필요하다면 스마트팩토리 LOGGER OPC UA·MySQL 연동 글도 함께 참고하십시오.