관리자는 교육기관의 Blackboard Learn 환경에서 발생한 문제를 해결하는 업무를 맡는 경우가 많습니다. 골치 아픈 문제가 발생했을 때 일어나는 상황을 전체적으로 파악하는 데 도움이 되기 위해 Blackboard Learn에서는 관리자가 참조할 수 있도록 로그를 생성합니다. 이러한 로그는 신속하게 참조하고 안정적으로 저장할 수 있도록 교육기관의 로컬 파일 저장소에 저장됩니다. 필요시 파일을 다운로드하거나 파일 권한을 사용하여 다른 사람과 공유할 수 있습니다. 로그에서 디스크 공간을 얼마나 사용하는지 확인하려면 통찰력 보고서를 참조하십시오.

로그에 접근하기

콘텐츠 컬렉션에서 시스템 로그를 찾을 수 있습니다. 관리자 패널콘텐츠 관리 섹션에서 콘텐츠 관리를 선택합니다. 내부 > 로그를 선택합니다. 로그는 년, 월, 일 및 시간을 기준으로 폴더 구조에 저장됩니다. 원하는 로그를 정확히 찾으려면 폴더 트리를 탐색하십시오.

로그 전송 및 유지

시간 폴더에서는 UTC(협정 세계시) 시간을 사용합니다. 로그는 로컬 파일 시스템에 1시간에 한 번씩, 그러나 4시간 늦게 전송됩니다. 예를 들어, 현재 시간이 4시라면 0시의 로그가 전송됩니다.

로그는 교육기관의 로컬 파일 저장소에 저장되므로 로그에 대한 고유한 유지 정책을 결정하고 적용할 수 있습니다.

로그 형식

로그에는 Blackboard Learn 노드별로 1시간의 로그 데이터가 포함되며, 이는 압축된 형식으로 저장됩니다. 1시간에 3개의 노드가 실행되는 경우에는 3개의 파일이 표시됩니다.

로그는 gzip을 사용하여 압축됩니다. Windows용 7Zip이나 Mac 또는 Linux용 unzip과 같은 도구를 사용하여 이러한 파일의 압축을 풀 수 있습니다. 압축이 풀리면 그 결과로 JSON 객체에 저장된 로그 이벤트가 포함된 텍스트 파일이 나타납니다. 각 JSON 객체는 중괄호로 시작하고 끝나며 다음과 같은 필드를 포함하고 있습니다.

  • 경로: 이벤트가 시작된 Blackboard Learn 서버의 파일이 표시됨
  • @timestamp: 이벤트가 발생한 시간
  • 클라이언트 ID
  • 버전
  • 호스트: 이벤트가 시작된 Blackboard Learn 노드의 IP 주소
  • 메시지: Blackboard Learn에서 로그 파일에 포함한 이벤트 관련 정보

더 읽기 편하게 로그 서식 지정하기

로그 파일은 JSON 파일로 저장되는데 이 형식이 익숙하지 않은 경우에는 내용을 읽기 어렵다고 느낄 수도 있습니다. 이 경우 더 읽기 편한 형식으로 파일의 서식을 다시 지정하면 됩니다.

시작하기 전에 Python 3를 다운로드하고 설치합니다. Mac 또는 Linux 컴퓨터를 사용 중인 경우 Python 3가 이미 설치되어 있을 수 있습니다.

설치한 Python 버전을 확인하려면 터미널을 열고 python --version 명령을 실행합니다. 오류가 발생하는 경우 또는 이전 버전의 Python이 설치되어 있는 경우 python3 --version 명령을 실행해 봅니다.

python 또는 python3가 작동하는 경우 이를 아래의 명령에서 사용하십시오.

시작하려면 아래의 링크를 사용하여 convertLogs.py 스크립트를 다운로드합니다. 첨부 파일은 일반 텍스트 파일입니다. 이 파일을 Python 스크립트로 사용하려면 컴퓨터에 다운로드한 후에 파일 확장명을  .py로 수정합니다. 스크립트가 저장된 위치를 메모합니다(예: ~/Downloads/scripts). 아래의 단계에서 스크립트를 실행할 때는 경로를 알고 있어야 합니다.

Windows를 사용 중인 경우 아래의 단계에서 Powershell 터미널을 사용하십시오.

1시간 분량의 로그를 다운로드 및 변환하려면 다음 단계를 수행하십시오.

  1. Blackboard Learn에 관리자로 로그인합니다.
  2. 관리자 패널 > 콘텐츠 관리로 이동합니다.
  3. 다운로드할 로그 폴더를 찾습니다(예: /internal/logs/2019/03/03/12).
  4. 여러 시간 폴더 중 한 폴더에서 로그 파일을 다운로드합니다.
  5. 터미널 창에서 스크립트를 실행합니다. python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs를 실행합니다.
    • –f 매개변수는 폴더 경로여야 합니다. 이는 서식이 지정되지 않은 로그가 현재 저장되어 있는 위치입니다.
    • –o 매개변수는 빈 폴더여야 합니다. 이는 서식이 지정된 로그가 저장될 위치입니다. 폴더가 없는 경우 스크립트를 통해 폴더가 생성됩니다.

몇 시간 동안의 로그를 다운로드 및 변환하려면 다음 단계를 수행하십시오.

  1. Blackboard Learn에 관리자로 로그인합니다.
  2. 관리자 패널 > 콘텐츠 관리로 이동합니다.
  3. 다운로드할 로그 폴더를 찾습니다(예: /internal/logs/2019/03/03/12).
  4. 다운로드할 시간을 선택합니다(예: 11, 12, 13).
  5. 패키지 다운로드를 선택하고 로컬 폴더에 저장합니다. 이렇게 하면 로그와 함께 zip 파일이 생성됩니다.
  6. 컴퓨터에 내장된 압축 해제 프로그램을 사용하여 zip 파일을 추출합니다. Windows의 경우 zip 파일을 마우스 오른쪽 버튼으로 클릭하고 모두 추출을 선택합니다.
  7. 터미널 창에서 스크립트를 실행합니다. python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs를 실행합니다.
    • –f 매개변수는 폴더 경로여야 합니다. 이는 서식이 지정되지 않은 로그가 현재 저장되어 있는 위치입니다.
    • –o 매개변수는 빈 폴더여야 합니다. 이는 서식이 지정된 로그가 저장될 위치입니다. 폴더가 없는 경우 스크립트를 통해 폴더가 생성됩니다.