로그와 저장 공간

설정

로그 읽기

Settings > Logs(설정 > 로그)를 여세요. 소유자와 관리자만 볼 수 있습니다.
Level(수준)을 고르세요: Every line(모든 줄), Warnings and errors(경고와 오류), Errors only(오류만).
Text(텍스트)에 단어를 입력하면 그 단어가 들어간 줄만 남습니다. 대소문자는 구분하지 않습니다.
From(시작일)과 To(종료일)로 날짜 범위를 정하세요. To 날짜도 포함됩니다. Apply(적용)를 선택하세요.
Newer(최신)와 Older(이전)로 페이지를 넘기세요. 한 번에 100줄씩, 최신 줄부터 나옵니다. 조건에 맞는 줄만 표시됩니다.

Settings > Logs에서 Download(다운로드)를 선택하세요. 가장 최근 줄을 최대 2 MB까지 텍스트 파일로 받습니다.
도움을 요청하는 곳에 첨부하세요. 지원 받기를 참고하세요.

키, 토큰, 비밀번호는 이미 [hidden]으로 가려져 있습니다. 그래도 올리기 전에 파일을 한 번 읽어 보세요. 작품 이름, 폴더 이름, 서버 주소는 그대로 보입니다.

Settings > This app > Storage(설정 > 이 앱 > 저장 공간)에는 HolyArrs가 보는 각 경로와 해당 디스크의 여유 공간이 나옵니다. Docker에서는 컨테이너 안의 경로입니다.

“free space unknown”(여유 공간 알 수 없음)은 시스템이 값을 알려 주지 않았다는 뜻입니다.

로그 파일은 설정 폴더의 logs/holyarrs.log입니다. 5 MB가 되면 logs/holyarrs.log.1로 옮겨지므로 로그는 10 MB 안팎으로 유지됩니다. docker logs holyarrs도 같은 출력을 보여 줍니다.

증상: Logs 페이지가 보이지 않습니다. 원인: 소유자와 관리자만 볼 수 있습니다. 해결: 그중 한 명에게 부탁하세요.

증상: 경로가 잘못된 것처럼 보입니다. 원인: Docker에서는 Storage에 컨테이너 경로가 표시됩니다. 해결: 볼륨 매핑과 비교해 보세요. 폴더를 참고하세요.

수준을 추정하는 방식

수준은 줄에 들어 있는 단어로 정해집니다. “failed”, “crashed”, “error”는 오류로 표시합니다. “could not”, “refused”, “timed out”은 경고로 표시합니다.

가려지는 것

모든 줄은 기록될 때 가려지고, 읽거나 다운로드할 때 한 번 더 가려집니다.

저장된 모든 키, 토큰, 비밀번호, 웹훅 링크. 링크 이스케이프된 형태와 base64 형태도 포함합니다.
예전 값. 비밀 값이 바뀌거나 삭제되면, 예전 값을 버리기 전에 두 로그 파일 모두 그 값을 가린 상태로 다시 기록합니다.
링크에 들어 있는 이름과 비밀번호: http://user:pass@host는 http://[hidden]@host가 됩니다.
apikey=, token=, passkey=, password= 같은 링크 매개변수.
비밀 값 이름이 붙은 쌍: API key, token, password, secret, cookie, authorization, setup code. 따옴표로 묶인 값은 닫는 따옴표까지 가려집니다.
Bearer 토큰과 basic 토큰, HolyArrs API 키(hak_...), 첫 실행 설정 코드, 토큰처럼 보이는 긴 문자열.

값 안의 줄바꿈과 터미널 색상 코드는 이스케이프해서 보여 주므로, 값이 새 줄인 척할 수 없습니다. 4자나 5자짜리 저장 값은 온전한 한 단어일 때만 가려지며, admin이나 test 같은 흔한 단어일 때는 가려지지 않습니다.

API

경로	대상	내용
`GET /api/v1/app/storage`	Change settings(설정 변경)	경로와 여유 공간
`GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=`	소유자, 관리자	줄과 전체 개수
`GET /api/v1/logs/download`	소유자, 관리자	최근 2 MB를 일반 텍스트로

API 키는 세 경로 모두 admin 범위가 필요합니다.