Skip to main content

SIS 통합 로그

SIS 로그 페이지는 모든 학생 정보 시스템(SIS) 통합에 대한 사용자 인터페이스(UI) 프로세스 로그를 제공합니다. 로그 파일은 시스템 문제를 해결하고 거래 진행 상황을 모니터링하는 데 중요한 역할을 합니다. 통합 생성 시 로그 상세도를 설정하면 선택한 통합에 대한 시스템에 저장된 로그 유형 및 깊이가 결정됩니다. 로그는 실시간으로 저장되며, SIS 로그 화면에서 필터링, 조회 및 삭제를 할 수 있습니다.

로그 수준

로그 레벨은 네 가지 유형이 제공되며, 각 학생 정보 시스템 통합은 통합 구성에 따라 서로 다른 로그 수준을 보고한다. 이 목록은 각 통합이 각 레벨에서 로그에 게시해야 할 메시지 유형을 설명합니다.

  • 오류: 생성, 업데이트, 비활성화 또는 정리 작업을 방해하는 치명적인 문제입니다.

  • 경고 및 예외: 치명적이지 않은 문제, 개별 기록에 관한 문제, 또는 기록 수정이 필요한 성공적인 수술.

  • 메시지 및 기록 유형, 횟수, 타이밍, 데이터 등 성공적인 활동 목록입니다.

  • 디버깅 및 오류: 모든 개별 기록 및 데이터 변환 시도를 확인합니다.

진단 메시지나 진단 및 디버그 메시지를 상세 기록으로 설정할 경우, 학생 정보 시스템 통합을 생성하거나 편집하는 중 활성 진단 기록 목록에서 시간을 선택하십시오. 진단 로깅은 단기 테스트에 가장 적합하며 활성화 상태를 유지하면 성능 문제를 일으킬 수 있습니다. 선택한 시간이 지나면 로그에 오류 및 경고가 기록됩니다. 테스트를 완료하면 로그를 제거(Purge)하는 것이 좋습니다.

로그 항목 조회 및 필터링

로그는 오류 유형, 통합 방식, 날짜 범위를 포함하여 고급 검색 방법으로 필터링할 수 있습니다. 새로운 로그 항목은 유형에 따라 첨부된 카운트로 쉽게 확인할 수 있습니다. 로그를 새로고침하면 최신 카운트 및 각 로그 유형의 세부 정보를 가져올 수 있습니다. 로그 카운트를 초기화하면 관련 로그 유형의 숫자는 삭제되지만, 로그 자체는 삭제되지 않습니다. 로그를 삭제하면 복구할 수 없으며, 영구적으로 삭제되기 전에 확인 창이 나타납니다. 선택한 통합에만 적용되는 '삭제 로그' 버튼입니다.

  1. 관리자 패널에서 관리자 패널 아래에 있는 통합, 데이터 통합을 선택하세요.

  2. 학생 정보 시스템 통합을 선택합니다.

  3. 모든 오류 보기를 선택하십시오.

  4. 검색 검색 필드에 검색어를 입력하십시오. 정확한 결과가 반환됩니다.

  5. 통합은 첫 번째 메뉴에서 선택하세요.

  6. 두 번째 메뉴에서 상세 수준을 선택하십시오.

  7. 시작일과 시간 범위를 설정하려면 From 체크박스를 선택하세요. 날짜와 시간을 상자에 입력하거나 팝업 날짜 선택 달력 및 시간 선택 메뉴 를 이용하여 날짜와 시간을 선택하십시오.

  8. To 체크박스를 선택하여 종료일 및 시간 범위를 설정하세요. 날짜와 시간을 상자에 입력하거나 팝업 날짜 선택 달력 및 시간 선택 메뉴 를 이용하여 날짜와 시간을 선택하십시오.

    참고

    7일을 초과하는 날짜 범위의 로그는 검색할 수 없습니다.

  9. 선택하세요 Go.

  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 웹 서비스를 통해 이 보고서에 접근할 수 있습니다. Blackboard Learn 도메인에 /learn/api/v1/logs/sis/{dataSetUid}를 추가하여 로그에 접근하십시오. 시스템은 피드 파일 처리 시 마다 참조 코드인 dataSetUid를 제공합니다. 이 매개변수는 결과를 반환하는 데 필요합니다. 오류와 성공 메시지는 테이블 DATA_INTGR_LOG에 기록됩니다.

제공되는 추가 매개변수로 데이터를 세분화할 수 있습니다.

  • logLevel 매개변수: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).

  • 표준 페이지 매개변수: /learn/api/v1/logs/학생정보시스템/{dataSetUid}?limit=25및offset=10. 표준 요청에는 기본적으로 20페이지 제한이 있으며, 이 값을 변경하지 않으면 가능합니다.

웹 서비스에서 기록 오류를 해결하는 과정은 오류 로그를 해결하는 과정과 동일하게 유지되었습니다. "dataSetUid가 시스템에 없거나 피드 파일이 처리 중인 경우 '찾을 수 없다'는 오류 메시지가 나타날 수 있습니다."