블로그›2026. 6. 16.

EASY LOGGER API 설정 사용방법

EASY LOGGER API 설정 사용방법

EASY LOGGER 사용법: EASY LOGGER API 설정 사용자 메뉴얼

안녕하세요. 오늘은 EASY LOGGER를 현장에서 사용할 때 꼭 알아두면 좋은 기능과 설정 흐름을 블로그 포스팅 형식으로 정리했습니다. 기존 사용자메뉴얼의 실제 화면 캡처는 그대로 유지하고, 처음 보는 분도 흐름을 이해할 수 있도록 핵심 사용 순서를 먼저 배치했습니다.

EASY LOGGER DB CSV API 연동 흐름

이런 분께 추천합니다

  • PLC, 센서, 설비 데이터를 수집해야 하는 현장 담당자
  • 생산수량, 온도, 습도, 설비 상태를 DB/CSV/API로 관리하려는 사용자
  • EASY LOGGER 화면을 보면서 빠르게 설정 절차를 확인하고 싶은 사용자

이 기능의 핵심 특징

  • 외부 서버, MES, ERP, Node-RED와 HTTP API 연동
  • 수집값 POST 전송과 WRITE CALLBACK 지원
  • Endpoint Preview로 연동 주소 확인
  • Payload Log로 최근 전송/수신 내용 점검

사용 흐름 요약

  1. 외부 서버 주소와 포트를 등록합니다.
  2. POST/WRITE CALLBACK 사용 여부를 선택합니다.
  3. Endpoint Preview로 연동 주소를 확인합니다.
  4. Payload Log에서 송수신 상태를 점검합니다.

실제 화면으로 보는 사용 방법

아래 내용은 원본 사용자메뉴얼의 화면 캡처와 절차를 유지하면서, 블로그에서 읽기 쉽게 정리한 본문입니다.

📌 이 메뉴얼의 목적

[!abstract] 사용 목적 이 메뉴얼은 EASY LOGGER가 수집한 PLC/Modbus 값을 외부 HTTP API 서버로 전송하고, 외부 시스템에서 WRITE CALLBACK을 통해 값을 쓸 수 있도록 설정하는 방법을 설명합니다. 실제 운용에 필요한 URL, Port, Timeout, POST/WRITE 설정, Endpoint Preview, Payload Log 확인 기준을 중심으로 설명합니다.

API 설정은 외부 서버, MES, Node-RED, 자체 수집 서버와 HTTP 방식으로 데이터를 주고받는 기능입니다.

👤 사용 대상

대상설명
주 사용자외부 연동 담당자, 설비 담당자
필요 권한EASY LOGGER admin 또는 editor 권한
제한 권한monitor 권한은 API 설정 화면 접근이 제한될 수 있습니다.
사전 지식외부 API 서버 IP/Port, 수신 Endpoint, WRITE 사용 여부
사용 빈도초기 연동 / 외부 서버 변경 / 장애 대응

✅ 사용 전 확인사항

  • MAIN 설정의 수집 조건이 RUNNING입니다.
  • 외부 API 서버가 실행 중입니다.
  • EASY LOGGER에서 외부 서버 IP와 Port로 접속할 수 있습니다.
  • 외부 서버가 EASY LOGGER의 POST JSON 형식을 받을 준비가 되어 있습니다.
  • WRITE CALLBACK을 켤 경우 외부 서버에서 쓰기 요청을 보낼 대상과 권한을 확인했습니다.

🚪 접속 및 로그인

항목값
웹 접속 URLhttp://EASY_LOGGER_IP:8000
사용 메뉴API 설정
권장 브라우저Chrome / Edge
  1. 로그인 후 왼쪽 메뉴에서 API 설정을 선택합니다.
  2. API Callback Configuration에서 외부 서버 정보를 확인합니다.
  3. 설정 변경 후 Runtime Status와 Payload Log를 확인합니다.

🧭 API 화면 구성

실제 화면 예시:

API 설정 전체 화면

화면 영역용도운용자가 확인할 것
API Callback Configuration외부 API 서버 주소와 전송 옵션 설정API URL/Host, Port, Timeout, POST, WRITE CALLBACK
API Runtime Status전송과 WRITE queue 상태 확인ENABLED, QUEUED WRITES, LAST POST, LAST WRITE, LAST ERROR
Automatic Endpoint Preview수집 설정별 자동 Endpoint 확인POST ENDPOINT, GET LATEST, WRITE CALLBACK
API Payload Log최근 API WRITE 수신 내용 확인Timestamp, Endpoint, Json

🔁 기본 설정 순서

  1. MAIN 설정에서 수집 조건이 정상인지 확인합니다.
  2. API URL / Host와 Port를 입력합니다.
  3. Timeout을 설정합니다.
  4. 수집값을 외부 서버로 보낼 경우 POST를 켭니다.
  5. 외부 WRITE를 허용할 경우 WRITE CALLBACK을 켭니다.
  6. 설정 저장을 누릅니다.
  7. Enable을 켭니다.
  8. Automatic Endpoint Preview에서 생성된 Endpoint를 확인합니다.
  9. 외부 서버에서 수신 여부를 확인합니다.

🛠 기능별 사용 방법

1. API Callback 설정

사용 목적:
EASY LOGGER가 외부 API 서버로 수집값을 POST하고, 외부 WRITE CALLBACK을 받을 수 있게 합니다.

화면 예시:

API Callback Configuration 화면

사용 절차:

  1. API URL / Host에 외부 서버 IP 또는 도메인을 입력합니다.
  2. Port를 입력합니다.
  3. Timeout을 초 단위로 입력합니다.
  4. 수집값 전송이 필요하면 POST를 체크합니다.
  5. 외부 WRITE가 필요하면 WRITE CALLBACK을 체크합니다.
  6. Endpoint Preview의 주소를 확인합니다.
  7. 설정 저장을 누릅니다.

정상 결과:

  • POST ENDPOINT와 WRITE CALLBACK 주소가 자동 표시됩니다.
  • Runtime Status의 LAST POST가 갱신됩니다.
  • 외부 서버에서 JSON 수신이 확인됩니다.

2. Runtime Status 확인

화면 예시:

API Runtime Status 화면

항목의미정상 기준
ENABLEDAPI 기능 사용 여부ON 또는 활성
QUEUED WRITESWRITE 처리 대기 수0 또는 작은 값
DROPPED WRITES버려진 WRITE 수0
LAST POST마지막 POST 대상최근 Endpoint
LAST WRITE마지막 WRITE 수신WRITE 사용 시 갱신
LAST ERROR마지막 오류-

3. Endpoint Preview 확인

화면 예시:

API Automatic Endpoint Preview 화면

컬럼의미
CONFIG수집 설정 이름
POST ENDPOINTEASY LOGGER가 외부 서버로 값을 보낼 주소
GET LATEST외부에서 최신값을 조회할 수 있는 주소
WRITE CALLBACK외부에서 값을 쓸 때 사용할 주소

Endpoint는 MAIN 설정의 PLC NAME과 CONFIG NAME을 기준으로 자동 생성됩니다.

4. API Payload Log 확인

화면 예시:

API Payload Log 화면

WRITE CALLBACK을 받으면 최근 payload가 이 영역에 표시됩니다. 외부에서 WRITE를 보냈는데 값이 바뀌지 않으면 먼저 이 로그에 기록이 있는지 확인합니다.

📦 API JSON 기준

POST 예시:

{
  "D100": 1,
  "D102": 23.77,
  "write_callback_url": "http://LOGGER_HOST:8000/api/write/PLC/CONFIG"
}

WRITE CALLBACK은 외부 서버가 EASY LOGGER의 write API로 값을 다시 보내는 구조입니다. WRITE를 사용할 때는 대상 PLC 주소와 데이터 타입이 MAIN 설정 범위에 맞아야 합니다.

⚠️ 오류 및 장애 대응

1. 외부 서버로 POST가 안 됨

  • API Enable이 켜져 있는지 확인합니다.
  • POST가 체크되어 있는지 확인합니다.
  • 외부 서버 IP와 Port가 맞는지 확인합니다.
  • Timeout이 너무 짧지 않은지 확인합니다.
  • 외부 서버 방화벽과 수신 Endpoint를 확인합니다.
  • Runtime Status의 LAST ERROR를 확인합니다.

2. WRITE CALLBACK이 동작하지 않음

  • WRITE CALLBACK이 체크되어 있는지 확인합니다.
  • 외부 서버가 올바른 WRITE endpoint로 요청했는지 확인합니다.
  • API Payload Log에 기록이 있는지 확인합니다.
  • MAIN 설정의 주소 범위와 데이터 타입이 맞는지 확인합니다.
  • PLC 통신 상태가 RUNNING인지 확인합니다.

3. LAST ERROR가 반복됨

오류 메시지의 URL, Timeout, HTTP 상태 코드를 확인합니다. 외부 서버가 응답하지 않거나 JSON 형식이 맞지 않을 수 있습니다.

🔐 보안 운영 기준

  • 외부 WRITE를 사용하지 않는 현장은 WRITE CALLBACK을 끕니다.
  • API 서버는 내부망 또는 신뢰 가능한 망에서 운영합니다.
  • 방화벽에서 필요한 Port만 엽니다.
  • 외부 서버 변경 시 Endpoint Preview를 다시 확인합니다.

🧰 정기 점검

주기점검 항목정상 기준
매일API Runtime StatusLAST ERROR 없음
매일LAST POST최근 POST 갱신
WRITE 사용 시API Payload Log수신 기록 정상
변경 시Endpoint Preview외부 서버 설정과 일치

📎 관련 메뉴얼

  • MAIN설정사용자메뉴얼
  • DB설정조회사용자메뉴얼
  • API설정사용자메뉴얼
  • MQTT사용자메뉴얼
  • OPC-UA사용자매뉴얼
  • 시퀀스사용자메뉴얼
  • 대시보드사용자메뉴얼
  • SW업데이트사용자메뉴얼
  • 네트워크설정사용자메뉴얼

📝 변경 이력

날짜버전변경 내용작성/수정
2026-05-25V1.08API 설정 운용자용 사용자 메뉴얼 최초 작성 및 실제 화면 캡처 추가운영팀

현장 적용 팁

  • 설정 변경 전에는 현재 운전 상태와 저장 설정을 먼저 확인하세요.
  • 외부 연동 기능은 처음에는 읽기 전용 또는 테스트 환경에서 검증한 뒤 현장에 적용하는 것이 안전합니다.
  • DB/CSV/API/MQTT/OPC-UA처럼 외부 시스템과 연결되는 기능은 Runtime Status와 Log를 함께 확인하세요.

마무리

EASY LOGGER는 PLC와 센서에서 나오는 현장 데이터를 수집하고, 저장·조회·외부 연동·대시보드 표시까지 이어주는 현장 데이터 허브 역할을 합니다. 이 글의 화면 순서대로 확인하면 처음 설정하는 사용자도 필요한 메뉴를 빠르게 찾고, 현장 데이터 흐름을 안정적으로 구성할 수 있습니다.

#EASYLOGGER #스마트팩토리 #PLC #데이터로거 #설비모니터링 #산업용통신 #원격모니터링

#EASYLOGGER#EASY LOGGER#API 설정#PLC API#HTTP POST#REST API#API Callback#PLC 데이터 수집#스마트팩토리#산업용 IoT#Node-RED 연동#MES 연동#PLC WRITE#외부 시스템 연동#데이터 연동
← 목록으로 돌아가기