관리자 로그 유틸리티

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 관리자 로그 유틸리티가 사용자 CPQ 환경에서 구성 문제를 효율적으로 진단, 모니터링 및 해결하는 데 어떻게 도움이 되는지 알아봅니다.

    관리자는 관리자 로그 유틸리티를 사용하여 시스템 활동, 구성 오류 및 통합 문제에 대한 중앙 집중식 가시성을 제공합니다. 주요 런타임 상세 정보, 오류 메시지 및 환경에 대한 상황별 데이터를 캡처하여 문제를 신속하게 진단하고 해결할 수 있습니다. 사용성과 정확성을 염두에 두고 설계된 관리자 로그를 통해 관리자는 문제를 식별하고 원인을 이해하며 신속하게 조치하여 시스템 안정성을 유지할 수 있습니다.

    관리자 UI를 통해서든 API를 통해 액세스하든 관리자 로그는 관리자가 구성을 최적화하고 사용자의 생산성을 유지하는 데 사용할 수 있는 통찰력을 제공하는 데 도움이 됩니다.

    주요 이점

    표 1. 관리자 로그의 주요 이점
    혜택 설명
    중앙 집중식 가시성 구성, 런타임 및 통합 오류를 한 위치에서 모니터링합니다.
    실시간 모니터링 로그를 빠르게 새로 고치고 필터링하여 가장 최근 또는 관련 시간 범위에 집중합니다.
    빠른 문제 해결 정확한 진단을 위해 자세한 오류 코드, 상황별 메시지 및 사용자 ID를 검토합니다.
    API 접근성 자동화 또는 사용자 지정 대시보드에 대해 프로그래밍 방식으로 로그 데이터를 검색합니다.
    지속적 개선 향상된 오류 보고 및 상황별 세부 정보에 액세스하여 지속적인 유지관리 및 사용자 지원을 간소화하는 데 도움이 됩니다.

    관리자 로그 액세스

    관리자는 선호하는 워크플로우 및 사용 케이스에 따라 관리자 인터페이스 또는 API를 통해 관리자 로그 CPQ 에 액세스할 수 있습니다.

    새 관리자 환경에서 유틸리티 메뉴의 로그에 액세스합니다. 레거시 관리자 환경에서 탐색 모음에서 로그를 클릭합니다. 두 환경 모두 동일한 실시간 로깅 기능을 제공하며 자세한 오류 정보를 필터링, 새로 고침 및 볼 수 있도록 합니다.

    새로 고침 및 필터링

    로그 인터페이스는 실시간 필터링 및 새로 고침 옵션을 지원합니다. 분석 요구에 가장 적합한 시간 범위를 선택합니다.
    • 지난 15분
    • 지난 시간
    • 지난 24시간
    • 모든 로그
    주:
    새로 고침 버튼을 사용하여 로그 페이지에서 나가지 않고 뷰를 최신 이벤트로 업데이트할 수 있습니다.

    로그 상세 정보 형식

    각 로그 항목은 구조화된 형식으로 표시되므로 문제를 쉽게 검색하고 이해할 수 있습니다. 이 구조를 통해 관리자는 여러 세션 및 구성요소에서 오류를 효율적으로 필터링하고, 상관관계를 지정하고, 해결할 수 있습니다. 로그 데이터에는 다음 열이 포함됩니다.
    • 날짜 및 시간: 사용자 친화적인 날짜 표시 및 정확한 시간(밀리초)입니다(2025년 2월 추가됨).
    • 오류 메시지: 발생한 문제에 대한 설명이 포함된 요약입니다.
    • 오류 코드: CPQ 빠른 상호 참조 및 지원 요청을 위한 고유 식별자입니다.
    • 사용자 ID: 오류가 발생한 사용자입니다(2025년 2월 추가됨).

    API를 통해 로그 액세스

    프로그래밍 방식으로 로그를 쿼리하는 것을 선호하는 관리자는 GET 요청을 사용하여 Admin Logs API에 액세스할 수 있습니다. 이는 대규모 데이터 세트가 있는 환경이나 로그를 외부 모니터링 시스템에 통합하는 데 특히 유용합니다. 이러한 유연성을 통해 관리자는 모든 이력 기록을 로드하지 않고도 감사 또는 성과 검토를 위해 특정 로그 간격을 검색할 수 있습니다.

    예제 cURL 명령:
    
    curl --location '<logikURL>/api/logs/v1/logs' \
    --header 'Content-Type: application/json' \
    --header 'Origin: localhost' \
    --header 'Authorization: <Admin API Key>'
    ISO 8601 날짜/시간 형식으로 AND after 매개변수를 지정 before 하여 결과를 세분화할 수 있습니다.
    
    curl --location '<logikURL>/api/logs/v1/logs?after=YYYY-MM-DDThh%3Amm%3AssZ&before=YYYY-MM-DDThh%3Amm%3AssZ' \
    --header 'Content-Type: application/json' \
    --header 'Origin: localhost' \
    --header 'Authorization: <Admin API Key>'

    지속적인 개선

    관리자 로그는 심층적인 인사이트를 제공하고 사용성을 개선하기 위해 지속적으로 발전합니다. 2025년 2월에 도입된 개선 사항은 다음과 같습니다.
    • 향상된 오류 메시지: 더 빠른 문제 식별을 위해 이제 저장 오류에 관련 구성 오류가 포함됩니다.
    • 상황별 정보: 보강 스크립트 오류의 경우 이제 로그가 정확한 디버깅을 위해 특정 보강 영역, 영향을 받는 Blueprint 및 수정 ID를 캡처합니다.
    • 자세한 외부 연결 오류: "지원되지 않는 메서드" HTTP 오류에는 이제 외부 호출에 사용된 경로와 메서드가 포함됩니다.
    • 성능 메트릭: 이제 외부 통합에 대한 메트릭이 추적되고 지원을 통해 CPQ 요청 시 사용할 수 있습니다.

    일반 가이드라인

    • 실시간 구성 문제를 해결할 때 단기 필터를 사용합니다.
    • 장기 추적 또는 규정 준수 검토를 위해 관련 로그 데이터를 정기적으로 익스포트합니다.
    • API를 활용하여 로그 검색을 자동화하거나 조직의 모니터링 도구와 통합합니다.
    • 불분명한 오류 코드 또는 누락된 컨텍스트 CPQ 를 보고 분석 및 개선을 지원합니다.