본문 바로가기
미디어위키

Extension EventLogging

by 다움위키 2023. 12. 27.

EventLogging 확장은 사용자가 MediaWiki의 인터페이스와 어떻게 상호 작용하는지에 대해 측정 기준에 따라 정보를 수집하는 기능을 제공합니다. 위키 미디어 재단은 독자와 편집자가 사이트와 상호 작용하는 방식을 보다 잘 이해하기 위해 데이터를 수집하고 또한 종합적으로 분석합니다. 또한 사용자 경험 향상을 위한 가장 중요한 목표를 이루기 위해, 유용성이나 성능 문제 식별을 위해, 기능 엔지니어에게 피드백 제공을 위해 이 데이터를 수집 분석합니다.

특징

  • EventLogging은 JavaScript의 클라이언트-측 로깅과 PHP의 서버-측 로깅을 지원합니다.
  • 이벤트는 JSON 스키마에 의해 정의된 JSON 객체이므로, MediaWiki 서버의 Schema: namespace에서 편집할 수 있습니다; 후자의 기능은 일반적으로 다른 구조화된 데이터를 위키 페이지에 저장하는 것에 유용합니다.
  • 확장에는 이러한 이벤트를 (동일한 스키마에서 자동으로 생성된) SQL 테이블과 MongoDB 콜렉션으로 전송, 구문 분석 및 로드하기 위한 많은 백-엔드 코드가 포함됩니다. 이 구성 요소의 세부 사항은 위키 미디어 재단의 설정에 따라 다릅니다.

Installation

미디어위키 확장 내려받기 지면에서 해당 판을 내려받아서 정해진 위치로 이동시킵니다.

미디어위키 설정 LocalSettings.php 파일에 다음을 추가합니다.

require_once "$IP/extensions/EventLogging/EventLogging.php";
$wgEventLoggingBaseUri = 'http://localhost:8080/event.gif';
$wgEventLoggingFile = '/var/log/mediawiki/events.log';

만약 확장 프로그램에서 EventLogging에 대한 조건부 종속성을 표현하려면, this sample code snippet을 참조하십시오.

Special:Version에 접근해서 확장이 정상적으로 설치가 되었는지 확인을 합니다.

Configuring the schema location

기본적으로, 확장은 Meta-Wiki에서 스키마를 검색합니다. 관련 기본 설정은 다음과 같습니다:

$wgEventLoggingSchemaApiUri = 'https://meta.wikimedia.org/w/api.php';
$wgEventLoggingDBname = 'metawiki';

자신의 위키-팜의 중앙 위키에 있는 로컬 스키마, 또는 지역 스키마를 사용하기 위해서는, 이를 덮어쓰야 합니다. 예를 들어, 로컬 위키의 Schema 이름 공간을 사용하기 위해서는, 다음과 같이 설정하세요:

$wgEventLoggingSchemaApiUri = $wgServer . '/api.php';
$wgEventLoggingDBname = $wgDBname;

(그리고 스키마를 생성할 사용자 계정이 autoconfirmed 되었는지 확인하십시오).

External Resources