감사 로그¶

Wagtail은 객체에 대해 수행된 작업을 기록하는 메커니즘을 제공합니다. 페이지 생성, 업데이트, 삭제, 잠금 및 잠금 해제, 개정 예약, 개인 정보 변경과 같은 일반적인 활동은 모델 수준에서 자동으로 기록됩니다.

Wagtail 관리자는 작업 로그 항목을 사용하여 사이트 전체 및 페이지별 변경 기록을 제공합니다. 기록된 작업에 대한 추가 컨텍스트를 제공하는 ‘작업’ 레지스트리를 사용합니다.

감사 로그 기반 페이지 기록은 개정 목록 페이지를 대체하지만 개정별 항목에 대한 필터를 제공합니다.

wagtail.log_actions.log 함수를 사용하여 자신의 코드에 로깅을 추가할 수 있습니다.

log(instance, action, user=None, uuid=None, title=None, data=None)¶

감사 로그에 항목을 추가합니다.

매개변수:

• instance – 작업이 수행되는 모델 인스턴스

• action – 수행되는 작업의 코드 이름입니다. 아래 나열된 이름 중 하나이거나 register_log_actions 훅을 통해 정의된 사용자 지정 작업일 수 있습니다.

• user – 선택 사항 - 작업을 시작하는 사용자입니다. 관리자 뷰 내에서 기록된 작업의 경우, 로그인한 사용자로 기본 설정됩니다.

• uuid – 선택 사항 - 동일한 UUID가 지정된 로그 항목은 동일한 사용자 작업의 일부로 발생했음을 나타냅니다(예: 페이지가 생성 시 즉시 게시되는 경우).

• title – 기록되는 인스턴스의 문자열 표현입니다. 기본적으로 Wagtail은 페이지 객체에 대해 인스턴스의str표현 또는get_admin_display_title을 사용하려고 시도합니다.

• data – 선택 사항 - 로그 항목에 저장할 추가 JSON 직렬화 가능 데이터 사전입니다.

    # mypackage/views.py
    from wagtail.log_actions import log

    def copy_for_translation(page):
        # ...
        page.copy(log_action='mypackage.copy_for_translation')

    def my_method(request, page):
        # ..
        # 수동으로 작업 기록
        data = {
            'make': {'it': 'so'}
        }
        log(
            instance=page, action='mypackage.custom_action', data=data
        )

from wagtail.log_actions import LogContext

with LogContext(user=User.objects.get(username='admin')):
    # ...
    log(page, 'wagtail.edit')
    # ...
    log(page, 'wagtail.publish')

from myapp.models import Sprocket, SprocketLogEntry
# 여기서 SprocketLogEntry는 BaseLogEntry의 서브클래스입니다.

@hooks.register('register_log_actions')
def sprocket_log_model(actions):
    actions.register_model(Sprocket, SprocketLogEntry)