학생 정보 시스템 로그 페이지에는 모든 학생 정보 시스템 통합에 대한 모든 UI(사용자 인터페이스)의 프로세스 로그가 표시됩니다. 로그 파일은 시스템 문제를 해결할 때와 시스템 트랜잭션의 프로세스를 모니터링할 때 중요한 역할을 합니다. 통합 생성 시 로그 상세 표시 수준을 설정하면 선택된 통합에 대해 시스템에서 유지되는 로깅의 범위와 유형이 정해집니다. 로그는 실시간으로 기록되며 학생 정보 시스템 로그 화면에서 필터링, 확인 및 제거할 수 있습니다.

로그 수준

네 가지 유형의 로그 수준을 사용할 수 있으며, 각 학생 정보 시스템 통합은 통합 구성에 따라 서로 다른 로깅 수준을 보고합니다. 이 목록에는 각 통합이 서로 다른 수준의 로그에 게시하는 메시지의 종류가 설명되어 있습니다.

  • 오류: 생성, 업데이트, 비활성화 또는 제거 작업을 막는 모든 문제 및 모든 치명적인 문제가 표시됩니다.
  • 경고 수준 이상: 치명적이지 않은 모든 문제, 개인 기록 관련 문제 또는 기록 변경이 필요한 모든 성공적인 작업이 표시됩니다.
  • 메시지 수준 이상: 기록 유형 및 개수, 시간, 데이터를 비롯하여 모든 성공적인 활동이 표시됩니다.
  • 디버그 수준 이상: 모든 개별 기록 및 데이터 변환 시도가 표시됩니다.

학생 정보 시스템 통합을 생성하거나 수정할 때 로그 상세 표시 수준을 모든 진단 메시지 또는 모든 진단 및 디버그 메시지로 설정하는 경우 활성 진단 로깅 목록에서 시간을 선택하십시오. 진단 로깅은 단기 테스트에 가장 적합하며 활성화된 상태로 남을 경우 성능 문제를 야기할 수 있습니다. 선택한 시간이 경과하면 로그가 오류 및 경고를 기록합니다. 테스트를 완료하면 로그를 제거하는 것이 좋습니다.

로그 항목 보기 및 필터링

로그는 오류 유형, 통합 및 기간 등을 활용하는 고급 검색 방법을 사용하여 필터링할 수 있습니다. 새로운 로그 항목은 로그 항목 유형에 개수가 연결되어 쉽게 분간할 수 있습니다. 로그는 새로 고쳐서 최신 개수 및 각 로그 유형의 세부사항을 가져올 수 있습니다. 로그 개수를 지우면 로그 유형에 연계된 개수만 지워지며 로그 자체는 삭제되지 않습니다. 로그 제거는 취소할 수 없으며, 로그가 영구적으로 제거되기 전에는 확인 메시지가 표시됩니다. '로그 제거' 버튼은 선택된 통합에만 적용됩니다. 

  1. 관리자 패널의 통합에서 데이터 통합을 선택합니다.
  2. 학생 정보 시스템 통합을 선택합니다.
  3. 모든 오류 보기를 선택합니다.
  4. 검색 필드에 검색어를 입력합니다. 그러면 정확히 일치하는 결과가 반환됩니다.
  5. 첫 번째 메뉴에서 통합을 선택합니다.
  6. 두 번째 메뉴에서 세부 정보 표시 수준을 선택합니다.
  7. 시작 확인란을 선택하여 시작 날짜 및 시간 범위를 설정합니다. 상자에 날짜와 시간을 입력하거나 날짜 선택 캘린더 및 시간 선택 메뉴 팝업을 사용하여 날짜 및 시간을 선택합니다.
  8. 종료 확인란을 선택하여 종료 날짜 및 시간 범위를 설정합니다. 상자에 날짜와 시간을 입력하거나 날짜 선택 캘린더 및 시간 선택 메뉴 팝업을 사용하여 날짜 및 시간을 선택합니다.

    7일이 넘는 기간의 로그는 검색할 수 없습니다.

  9. 실행을 선택합니다.
  10. 로그 항목이 통합, 날짜, 로그 수준 및 설명과 함께 나열됩니다.
  11. 로그 항목을 선택하여 로그의 세부 사항을 확인합니다.

로그 항목 관리

로그 항목을 관리하여 데이터 문제를 더 쉽게 찾을 수 있습니다. 예를 들어, 특정 오류가 발생하는 경우에는 적은 양의 정보를 꼼꼼히 살펴보는 것이 더 쉽습니다. 또한 로그 항목을 관리하면 사용되는 공간의 양을 최소한으로 유지하는 데 도움이 됩니다. 정보를 최신 상태로 유지하려면 로그를 주기적으로 제거해야 합니다.

  1. 관리자 패널의 통합에서 데이터 통합을 선택합니다.
  2. 학생 정보 시스템 통합을 선택합니다.
  3. 모든 오류 보기를 선택합니다.
  4. 새로 고침을 선택하여 새 로그를 검색합니다.
  5. 로그 제거를 선택하여 특정 통합에 대한 로그 정보를 제거합니다.

로그 위치

로그 파일 관리 또는 내역 데이터 분석을 수행하려면 ~blackboard 로그 디렉터리에서 데이터 통합 로그 파일을 찾으면 됩니다.

~blackboard/logs/data-integration/<integration_type>/<integration_name>

여기서

<integration_type>은 bb-flatfile(스냅숏 플랫 파일), bb-lis(LIS 2.0), bb-ss-xml(스냅숏 XML), bb-ims-vista-xml(IMS Enterprise Vista) 또는 bb-ims-xml(IMS Enterprise) 중 하나입니다.

또한

<integration_name>은 통합 구성에서 지정한 통합의 이름입니다.

REST 웹 서비스를 통해 로그에 접근하기

새 프레임워크에서 REST 웹 서비스를 통해 이 보고서에 접근할 수 있습니다. 로그에 접근하려면 /learn/api/v1/logs/sis/{dataSetUid}를 Blackboard Learn 도메인에 추가하십시오. 피드 파일이 처리될 때마다 시스템에서 참조 코드인 dataSetUid를 제공합니다. 이 매개변수는 결과를 반환하는 데 필요합니다. 오류 및 성공 메시지는 DATA_INTGR_LOG 테이블에 로깅됩니다.

데이터를 분할하기 위해 다음과 같은 추가 매개변수를 사용할 수 있습니다.

  • logLevel 매개변수: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).
  • 표준 페이징 매개변수: /learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. 이 값을 변경하지 않는 한 기본적으로 표준 요청의 페이지 수는 20으로 제한됩니다.

웹 서비스에서 기록 오류 문제를 해결하는 프로세스가 오류 로그 문제를 해결하는 프로세스에서 변경되지 않았습니다. "찾을 수 없음" 오류 메시지가 나타난다면 dataSetUid가 시스템에 없거나 피드 파일이 아직 처리 중인 것일 수 있습니다.