장애 대응용 플러그인 동작 로그를 단말기 내부에 일정 기간 보관

[HO]

어떤 제품을 사용하나요?

• 제품: POS 플러그인 (워커 플러그인)
• SDK 또는 API 버전: @tossplace/pos-plugin-sdk 0.0.27
• 환경: 개발, 운영

무엇이 궁금한가요?

장애 대응을 위해 sentry외 추가적인 백업용 플러그인 동작 로그를 단말기 내부에 일정 기간(약 7일) 보관하려고 합니다. 아래 내용을 문의드립니다.

1. IndexedDB

• 워커 플러그인에서 브라우저 표준 IndexedDB(indexedDB.open)를 사용해도 되나요?
• 사용할 수 있다면 용량 제한이 있나요?
• 플러그인 버전 업데이트, 포스 재시작, 포스 앱 업데이트 후에도 데이터가 유지되나요?
• 가능하면 많이 보관하고싶은데, 7일 이상도 가능하거나 권장일이 있을까요?

2. SDK Storage API (get/set/del)

• 키 개수, 값 하나의 최대 크기, 전체 용량 제한이 있나요?
• 플러그인 버전 업데이트, 포스 재시작, 포스 앱 업데이트, 재설치 후에도 데이터가 유지되나요?
• 저장 범위는 단말기 단위인가요, 매장 단위인가요?
• Storage 호출도 Rate Limit(60초 100회, 30분 200회)에 포함되나요?

3. 위 두 방식 모두 권장하지 않는다면, 플러그인 로그를 단말기에 보관하는 권장 방법이 있을까요?

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

문의하신 POS 워커 플러그인의 로그 보관 방식에 대해 안내 드립니다.

1. IndexedDB 사용 및 보관 범위
IndexedDB는 브라우저 표준 기능이며, 토스플레이스 SDK에서 공식 제공하는 저장소 기능은 아닙니다.
IndexedDB 이용에 따른 데이터 보존·삭제와 동작 안정성은 토스플레이스에서 보장하는 범위가 아니므로, 상세 답변 드리기 어려운 점 양해 부탁 드립니다.
사용 가능 용량, 플러그인 업데이트·POS 재시작·POS 앱 업데이트 후 데이터 유지, 7일 이상 보관 여부나 권장 보관 기간도 보장하여 안내 드리기는 어렵습니다.

2. SDK Storage API
Storage API는 간단한 문자열 데이터를 저장·조회·삭제하는 기능입니다. 객체나 배열은 문자열로 변환해 저장할 수 있습니다.

• 저장 범위: 각 POS 단말의 앱별 저장소입니다. 같은 매장의 다른 POS나 다른 앱과 자동 공유되지 않습니다.
• 용량: 키 개수, 값 하나의 크기, 전체 용량의 수치 상한은 공개 가이드에 명시되어 있지 않습니다. 무제한 저장이 가능하다는 의미는 아닙니다.
• 데이터 유지: 단순 POS 재시작이나 동일 앱의 플러그인 버전 변경만으로 초기화하는 방식은 아닙니다. 다만 POS 앱 업데이트 전후나 삭제·재설치 후의 보존을 보장하는 공개 기준은 없으므로, 장기 보관이 필요한 로그의 유일한 백업 수단으로 사용하지 않도록 권장합니다.
• 호출 제한: 공개 가이드는 이벤트 구독 외 요청에 60초 100회, 30분 200회 제한을 안내하며, Storage에 대한 예외는 명시하지 않습니다. 해당 기준을 고려해 호출량을 관리해 주세요.

대용량 로그를 안정적으로 저장·조회하는 용도로 제공되는 기능은 아닌 점 고려해 주세요.
Storage API 가이드와 호출 제한 가이드를 참고해 주세요. 앱별 저장소가 분리되는 점은 기존 포럼 답변의 2번 항목에서도 안내 드렸습니다.

3. 로그 보관 권장 방식
공개 가이드에서 권장하는 방식은 Sentry 또는 솔루션사 로그 수집 서버를 이용하는 것입니다. 단말 내부에서 로그를 7일 이상 보관하도록 보장하는 별도 SDK 기능은 안내되어 있지 않습니다.
7일 이상 보관해야 하는 백업 로그는 별도 수집 서버에서 보관 기간과 용량을 관리하는 구성을 권장합니다.
개인정보·카드번호·결제 인증정보 등 민감정보는 로그에 기록하지 않도록 해 주세요. POS 로그 수집 가이드를 참고 부탁 드립니다.