콘텐츠로 이동

로그 뷰~

[톱니바퀴] -> AoT 로그(/logview) 페이지는 시스템 로그를 브라우저에서 보여준다. 필터·실시간 추적이 있고, AI 서비스를 켠 경우에는 지금 보고 있는 줄에 대해 AI에게 물어볼 수 있다.

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

로그 고르기~

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

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

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

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

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

필터~

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

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

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

실시간~

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

내려받기~

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

AI에게 로그 물어보기~

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

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

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

고른 줄은 이 기기를 떠난다

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

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

파일 위치~

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