5. 게임 로그

게임을 서비스하다 보면 유저가 게임 내에서 언제 무엇을 했는지 확인해야 할 경우가 생깁니다. 아이펀 디플로이는 이러한 경우를 위해 유저의 행동을 기록한 로그를 확인하는 게임 로그 조회 기능 을 제공합니다.

아이펀 디플로이의 게임 로그 페이지에서는 게임 서버에서 남긴 로그를 검색하고 조회할 수 있습니다. 또한, 로그 조회 시 로그를 더욱 쉽게 이해할 수 있도록 언어별로 로그 출력 형식을 설정하거나 자주 사용하는 검색 조건을 저장해두는 등의 편의 기능도 제공합니다.

Important

게임 로그 DB 사용 여부 를 체크하고 게임 로그 DB 정보가 있어야 활성화 됩니다.

Important

아이펀 디플로이에서 제공하는 게임 로그 조회 기능을 사용하시려면 아이펀 디플로이에서 접근할 수 있는 MongoDB 에 로그를 남겨주셔야 합니다. MongoDB 관련 디플로이먼트 설정은 디플로이먼트 생성 , MongoDB 설정은 게임 로그 MongoDB 보안 연결 설정 항목을 참고해 주세요.

5.2. 게임 로그 조회

검색을 수행하면 아래와 같은 검색 결과 화면으로 이동합니다.

이때, 모든 로그는 게임 로그 설정 페이지 에서 설정한 로그의 표시 형식 대로 출력됩니다.

_images/game-log-search-result.png

signUpfacebookAccount 로그를 대상으로 검색을 수행한 검색 결과 화면

또한, 오른쪽의 검색 UI를 사용하면 신속하게 로그를 재검색할 수 있습니다.

검색 UI 오른쪽 위의 톱니바퀴 버튼을 누르면 게임 로그 설정 페이지 로 바로 이동되며, 그 옆의 X 버튼을 누르면 UI가 숨겨집니다. 검색 UI를 숨긴 상태에서는 페이지 오른쪽의 < 버튼을 눌러서 다시 꺼낼 수 있습니다.

_images/game-log-search-show-ui-in-result.png

5.3. 게임 로그 설정 페이지

json 형식의 게임 로그 데이터는 가독성이 떨어지므로 설정을 통해 더욱 읽기 쉽게 만들 수 있습니다.

여기서 지정한 설정들은 게임 유저 관리 페이지의 게임 로그 탭에도 반영됩니다. 자세한 사항은 게임 유저 로그 항목을 참고해주세요.

_images/game-log-setting-01.png

현재 설정 가능한 항목들은 아래와 같습니다.

Important

로그 설정은 언어별 , 로그 종류별 로 설정할 수 있습니다.

자세한 사항은 언어별 설정 , 로그 종류 항목을 참고해주세요.

5.3.1. 전체 설정

전체 설정이란 모든 언어에 공통으로 적용 되는 설정을 말합니다.

로그 종류 별로 하나씩 저장되며, 로그의 표시 색상게임 유저 관리페이지 표시 여부 를 설정할 수 있습니다.

_images/game-log-setting-global.png

로그 종류

설정을 적용할 로그 종류 를 지정합니다.

MongoDB 컬렉션의 _type 키 값을 그대로 입력하면 되며, 자세한 것은 로그 종류 항목을 참고해주세요.

로그 종류를 입력했을 때 같은 종류의 설정이 이미 존재하면 해당 설정을 불러와 수정하고, 같은 종류의 설정이 없다면 새로운 설정으로 저장합니다.

  • 새로운 설정 생성

    입력한 로그 종류와 같은 종류의 설정이 없으므로 새로운 설정으로 저장합니다.

    _images/game-log-setting-new.png
  • 기존 설정 수정

    기존에 같은 종류의 설정이 이미 저장되어 있으므로 해당 설정 내용을 불러와 수정 합니다.

    _images/game-log-setting-edit.png

Warning

입력한 로그 종류를 _type 으로 가진 컬렉션이 MongoDB에 없다면 해당 설정은 적용되지 않습니다. 만일 특정 로그 설정이 적용되지 않는 경우, 올바른 로그 종류 값이 입력되었는지 확인해주세요.

로그의 표시 색상

로그 조회 시 출력되는 로그의 표시 이름 태그의 배경색을 설정합니다.

_images/game-log-setting-color.png

로그 설정 페이지의 표시 색상 옵션

_images/game-log-setting-color-format.png

설정한 색상이 태그 배경색으로 적용된 모습

게임 유저 관리페이지 표시 여부

해당 로그 종류 를 게임 유저 관리페이지에 출력할지를 결정합니다.

이 옵션을 ON 으로 설정하면 해당 로그가 게임 유저 관리페이지의 로그 탭에 표시됩니다. 자세한 것은 로그 조회 항목을 참고해주세요.

_images/game-log-setting-on-01.png
  • 게임 유저 관리페이지의 게임 유저 로그 TAB
_images/game-log-setting-on-02.png

5.3.2. 언어별 설정

언어별 설정이란 말 그대로 언어별로 적용 되는 설정을 가리킵니다.

입력한 설정은 언어별로 따로따로 저장되며, 접속한 멤버가 사용하는 브라우저의 언어에 따라 다르게 적용됩니다. 설정할 수 있는 항목은 로그의 표시 이름로그의 표시 형식 입니다.

_images/game-log-setting-lang.png

Note

  • 다른 언어의 설정을 바꾸려면 어떻게 하나요?

    설정을 적용할 언어는 오른쪽 위의 설정 언어 드롭박스로 선택할 수 있습니다.

_images/game-log-list-locale.png

Note

  • 언어별 설정이 비활성화되어있어요!

    설정 페이지에 들어갔을 때 아래와 같이 언어별 설정 항목들이 비활성화되어있는 것은 정상 입니다.

    로그 종류 를 입력하고 나면 해당 항목들을 입력할 수 있도록 비활성화가 풀립니다.

_images/game-log-setting-disabled.png

현재 선택된 언어

입력한 설정을 어떤 언어에 적용할 것인지 표시합니다.

설정 언어 드롭박스에 선택된 값을 자동으로 사용합니다.

_images/game-log-setting-cur-locale.png

로그의 표시 이름

로그 조회 시 로그 종류 대신에 출력할 문자열을 설정합니다.

로그 종류를 구별하는 용도로 사용되며, 기본값은 로그 종류 값입니다.

_images/game-log-setting-color-format.png

‘loginfacebookAccount’ 대신 ‘페이스북 계정 로그인’ 이라고 설정한 경우

로그 조회 시 출력되는 태그의 배경 색도 설정으로 변경할 수 있습니다. 자세한 것은 로그의 표시 색상 항목을 참고해주세요.

로그의 표시 형식

로그 데이터의 표시 형식을 설정합니다.

설정한 형식은 검색 결과 페이지게임 유저 관리 페이지 양쪽에 모두 적용됩니다.

  • 원본 로그 데이터

    {
      "status": "true",
      "_type": "loginfacebookAccount",
      "_ts": 1482201098,
      "account_id": "6dd3336f-c65c-11e6-9018-0800272e5a33"
    }
    
  • 로그의 표시 형식 설정

    계정 ID: {{ account_id }}, 로그인 날짜: {{ _ts }}
    
  • 설정 후 변경된 로그 형식

    _images/game-log-setting-color-format.png

Note

표시 형식 설정은 말 그대로 로그 데이터를 조회할 때의 출력 형식만 변경하는 것으로, DB의 로그 데이터에는 일절 영향을 주지 않습니다.

Tip

게임 로그 설정 팝업로그 키워드 를 사용하면 더욱 쉽고 빠르게 설정할 수 있습니다. 자세한 것은 해당 항목을 참고해주세요.

5.3.3. 언어별 설정 목록

현재 선택된 언어에 해당하는 설정 목록을 테이블로 출력합니다.

언어는 설정 언어 드롭박스에서 선택할 수 있습니다.

_images/game-log-setting-list.png

설정 언어

설정을 조회하거나 추가, 변경할 언어를 선택합니다.

설정 페이지 오른쪽 위의 설정 언어 드롭박스로 선택할 수 있습니다.

_images/game-log-list-locale.png

설정 삭제

  • 단일 항목 삭제

    테이블 오른쪽의 액션 컬럼에 있는 삭제 버튼 을 누르면 해당 설정이 삭제됩니다.

_images/game-log-setting-delete-1.png
  • 복수 항목 삭제

    삭제하고자 하는 설정에 체크를 하고 테이블 상단의 삭제 버튼 을 누르면 체크한 설정들이 삭제됩니다.

_images/game-log-setting-delete-2.png

5.4. 게임 로그 설정 팝업

게임 로그 조회 시에 로그 오른쪽에 표시되는 톱니바퀴 버튼을 누르면 게임 로그 설정 팝업창 이 뜹니다.

_images/game-log-setting-popup-1.png

맨 우측의 톱니바퀴 버튼을 눌러 게임 로그 설정 창 팝업

_images/game-log-setting-popup.png

게임 로그 설정 팝업창

게임 로그 설정 팝업창게임 로그 설정 페이지 와 내용과 기능이 거의 흡사하나, 약간의 차이가 있습니다. 팝업창과 페이지 간의 차이점은 아래와 같습니다.

  • 설정할 로그 종류 를 변경할 수 없다.
    • 팝업창은 특정 로그의 설정을 변경 하는 용도이기 때문에 로그 종류가 고정되어 있습니다.

  • 로그 키워드 를 통해 로그의 표시 형식 을 보다 편하게 설정할 수 있다
    • 로그 조회를 통해 해당 종류의 로그에 어떤 필드가 있는지 알고 있기 때문에, 게임 로그 설정 페이지 와 달리 필드명을 직접 타이핑하지 않고도 키워드를 클릭하는 것만으로 필드 템플릿을 손쉽게 삽입할 수 있습니다.
_images/game-log-setting-popup-2-zoom.png

하단의 로그 키워드 를 클릭하면 상단의 로그의 표시 형식 에 해당 템플릿이 삽입된다


다음은 게임 로그 설정 팝업을 사용하여 로그 설정을 변경한 예시입니다.

  • 변경 전

    _images/game-log-setting-popup-1.png
  • 게임 로그 설정 팝업창 설정 예시

    _images/game-log-setting-popup-2.png
  • 변경 후

    _images/game-log-setting-popup-3.png

이처럼 로그의 표시 형식 을 설정할 때에는 게임 로그 설정 팝업창 을 사용하면 더욱 쉽고 빠르게 설정을 변경할 수 있습니다.