로그

개요

로그 기능은 Starnion 시스템의 모든 활동 기록을 조회하고 분석할 수 있는 모니터링 도구입니다. 닌온과의 대화 이력, 스킬 실행 내역, 시스템 오류 등을 한 곳에서 확인할 수 있어 문제 해결과 사용 패턴 파악에 유용합니다.

주요 특징:

대화 로그: 모든 채팅 이력 검색 및 조회
스킬 실행 로그: 어떤 스킬이 언제 실행됐는지 추적
오류 로그: 시스템 오류 발생 시 상세 내용 확인
다양한 필터: 날짜, 로그 레벨, 스킬 종류별 필터링
내보내기: CSV/JSON 형식으로 로그 다운로드

로그 종류

대화 로그

닌온과 주고받은 모든 메시지 기록입니다.

항목	설명
타임스탬프	메시지가 전송된 정확한 시각
발신자	사용자 또는 AI
채널	Telegram, WebChat 등
내용	메시지 본문
대화 ID	해당 대화 스레드 식별자

스킬 실행 로그

AI가 내부적으로 호출한 스킬(기능)의 실행 기록입니다.

[2024-03-15 14:23:45] SKILL  finance.add_expense  SUCCESS  "삼겹살 32,000원 기록"
[2024-03-15 14:25:12] SKILL  diary.create         SUCCESS  "3/15 일기 저장"
[2024-03-15 14:30:01] SKILL  websearch.search     SUCCESS  "삼성전자 주가 검색"
[2024-03-15 14:35:22] SKILL  memo.create          FAILED   "저장 실패: 메모 한도 초과"

오류 로그

시스템 오류가 발생했을 때 기록되는 상세 로그입니다.

레벨	설명	예시
ERROR	기능 실행 실패	스킬 호출 오류, API 타임아웃
WARN	경고 (기능은 정상)	느린 응답, 재시도 발생
INFO	일반 정보	스킬 실행 완료, 사용자 로그인
DEBUG	디버그 정보	상세 실행 과정 (개발자용)

로그 조회

웹에서 조회

사이드바에서 로그 메뉴를 클릭합니다.
상단의 필터를 설정합니다:
- 날짜 범위: 시작일 ~ 종료일
- 로그 레벨: ERROR, WARN, INFO, DEBUG
- 스킬 종류: 특정 스킬만 필터링
- 채널: Telegram, WebChat 등
결과가 시간순으로 표시됩니다.

필터 활용 예시

오류만 보기:

로그 레벨을 ERROR로 설정하면 실패한 작업만 빠르게 확인할 수 있습니다.

특정 스킬 추적:

스킬 필터에서 finance를 선택하면 가계부 관련 로그만 표시됩니다.

특정 기간 조회:

“지난 7일” 또는 “이번 달” 등 빠른 날짜 선택으로 간편하게 범위를 지정합니다.

로그 내보내기

로그 데이터를 파일로 다운로드하여 외부에서 분석할 수 있습니다.

지원 형식

형식	특징	용도
CSV	엑셀에서 바로 열기 가능	스프레드시트 분석
JSON	구조화된 데이터	프로그래밍 분석, 외부 도구 연동

내보내기 방법

원하는 필터를 적용합니다.
오른쪽 상단의 내보내기 버튼을 클릭합니다.
형식(CSV 또는 JSON)을 선택합니다.
파일이 자동으로 다운로드됩니다.

활용 사례

문제 해결

AI가 특정 요청에 대해 이상한 응답을 했거나, 기능이 동작하지 않았을 때 로그를 확인하면 원인을 파악할 수 있습니다.

문제: "가계부에 기록해줘"라고 했는데 저장이 안 됨

로그 확인:
[14:35:22] SKILL  finance.add_expense  FAILED  "카테고리 파싱 실패: 입력값 누락"

원인: 금액을 명시하지 않아 파싱에 실패
해결: "점심 12,000원 기록해줘"처럼 금액을 포함하여 다시 요청

사용 패턴 분석

어떤 스킬을 얼마나 자주 사용하는지 파악하여 활용도를 높일 수 있습니다.

보안 감사

계정에 비정상적인 접근이 있었는지, 예상치 못한 시간대에 활동이 있었는지 확인할 수 있습니다.

팁 & FAQ

Q. 로그는 얼마나 오래 보관되나요? 모든 로그는 영구적으로 보관됩니다. 다만 매우 오래된 로그를 조회할 때는 날짜 범위를 좁혀서 검색하면 더 빠르게 결과를 확인할 수 있습니다.

Q. 로그에서 민감한 정보가 노출되나요? 대화 내용은 로그에 포함되지만, API 키나 비밀번호 같은 시스템 인증 정보는 마스킹 처리됩니다.

Q. 로그를 삭제할 수 있나요? 현재는 개별 로그 삭제 기능을 제공하지 않습니다. 데이터 무결성과 감사 추적을 위해 로그는 보존됩니다.

Q. 실시간으로 로그를 모니터링할 수 있나요? 웹 로그 화면에서 자동 새로고침을 활성화하면 최신 로그를 실시간에 가까운 속도로 확인할 수 있습니다.