콘텐츠로 이동

로그 뷰~

관리 → 시스템 로그(/logview, 화면 제목은 로그 뷰) 페이지는 시스템 로그를 브라우저에서 보여준다. 필터·실시간 추적이 있고, AI 서비스를 켠 경우에는 지금 보고 있는 줄에 대해 AI에게 물어볼 수 있다.

로그 조회에는 view_logs 권한이 필요하다.

로그 고르기~

로그 선택 상자는 소스를 묶어서 보여준다.

묶음 소스 내용
AI AI AI 서비스가 남기는 모든 것(에이전트·플래너·스케줄러·MCP 브리지·안전 게이트).
AI MCP 서버 외부 AI가 접속하는 MCP 서버 프로세스.
시스템 데몬 데몬 로그 전체 — 입력·출력·함수·컨트롤러, 이메일 발송(SMTP 연결·로그인 실패, 버려진 이메일).
시스템 데몬 (PID 설정) PID 제어기 설정 줄만. 튜닝할 때 쓴다.
시스템 데몬 유지 keepup 서비스.
웹 웹 앱 웹 애플리케이션이 직접 남기는 줄.
웹 웹 로그인 로그인 시도(성공·실패 모두).
웹 웹 접근 웹 서버의 접근 로그.
웹 웹 오류 웹 서버의 오류 로그.
웹 웹 호스트가 제공하는 경우의 웹 서비스 저널.
웹 Nginx 호스트가 제공하는 경우의 Nginx 저널.
유지관리 종속성 종속성 설치 실행 기록.
유지관리 설정 가져오기 설정 가져오기 실행 기록.
유지관리 AoT 백업 백업 실행 기록.
유지관리 AoT 복구 복구 실행 기록.
유지관리 AoT 업그레이드 업그레이드 실행 기록.

이메일 문제는 데몬에서 보인다

알림 이메일이 오지 않으면 데몬을 고르고 오류를 검색한다. SMTP 연결·로그인 실패와 시간당 한도로 버려진 이메일이 여기에 기록된다. 알림을 참고한다.

이 설치본에서 쓸 수 없는 소스는 흐리게 표시되고 이유가 함께 붙는다 — 파일이 아직 없거나, 읽는 데 필요한 명령(journalctl, docker)이 이 환경에 없거나. 고장이 아니라 "여기서는 그 로그에 닿을 수 없다" 는 뜻이다. 로그가 비어 있는 것과 구분하기 위해 따로 표시한다.

AI·웹 앱 소스는 데몬 로그를 걸러 본 것이다

AI 서비스와 웹 앱은 별도 파일을 쓰지 않는다. 두 소스는 같은 데몬 로그를 로거 이름으로 걸러서 보여준다. 그래서 데몬 로그의 마지막 수백 줄보다 훨씬 오래된 줄이 나올 수 있다.

필터~

도구 모음에는 로그, 최소 레벨, 검색, 줄 수, 실시간, 새로고침, 내려받기가 있다.

  • 최소 레벨 — 그 레벨 이상만 본다. 레벨 개념이 없는 줄(로그인 기록, 접속 로그)은 최소 레벨을 걸면 나오지 않는다. 비교할 레벨 자체가 없기 때문이다.
  • 검색 — 대소문자를 가리지 않는 부분 일치. 줄 전체를 대상으로 한다.
  • 줄 수 — 화면에 남길 항목 수.

필터 상태는 주소(URL)에 실린다. 걸러 본 화면을 그대로 북마크하거나 다른 사람에게 붙여넣어 줄 수 있다.

요청한 줄 수를 채우기 전에 스캔 한도에 닿으면 그 사실을 알려준다. 조건에 맞는 더 오래된 줄이 남아 있지만 읽지 않은 상태이니, 검색어를 좁히거나 이미 범위가 좁혀진 소스를 고르면 된다.

실시간~

실시간을 켜면 화면이 계속 갱신된다. 몇 초마다 확인하되 직전 이후에 새로 붙은 부분만 받아오고, 위로 스크롤해 두지 않았다면 항상 최신 줄에 붙어 있다. 탭이 백그라운드로 가면 폴링을 멈추고, 돌아오면 다시 시작한다.

내려받기~

내려받기는 지금 걸러 본 화면을 텍스트 파일로 저장한다. 로그 전체가 아니라 화면에 보이는 그 줄들이다.

AI에게 로그 물어보기~

AI 서비스를 켜면 로그 아래에 작업 줄이 나타난다.

  1. 줄을 클릭해 고른다. shift-클릭은 범위 선택이다. 아무것도 고르지 않으면 화면에 보이는 오류·경고가 대상이 된다.
  2. 설명, 원인 진단, 해결 방법은? 중 하나를 누른다.

채팅 서랍이 열리면서 고른 줄이 함께 전달되고, 로그가 실제로 무엇을 보여주는지 와 이 시스템에서 다음에 무엇을 확인해야 하는지를 답한다. 서랍에서 이어서 후속 질문을 해도 그 대화에는 로그 줄이 그대로 남아 있다.

고른 줄은 이 기기를 떠난다

설정한 AI 모델로 전송되며, 대부분의 제공자에서는 외부 서비스로 나간다는 뜻이다. 인증정보·키·토큰이 담긴 줄은 보내지 말 것.

발췌는 줄 수와 총량 양쪽으로 상한이 걸려 있다. 아주 긴 줄이나 큰 선택은 통째로 보내지 않고 잘라서 보낸다.

파일 위치~

일반 설치에서 로그는 /var/log/aot/에 있다. 지금 보고 있는 소스의 경로가 도구 모음 바로 아래에 표시되므로, 원문이 필요할 때 SSH로 같은 파일을 찾을 수 있다.