이벤트 라이브러리

사용 사례

이벤트 라이브러리는 의료 또는 금융 서비스와 같이 규제가 심한 산업의 컴플라이언스 요구 사항을 충족하기 위해 감사를 수행할 수 있는 기능을 제공합니다.

작동 방법

이벤트 라이브러리는 사용자의 기기에서 별도의 '이벤트' 영역을 엽니다. 이 Realm은 개발자가 이벤트 라이브러리를 사용하여 모니터링하기로 선택한 모든 사용자 Realm에 액세스할 수 있습니다.

개발자가 이벤트 라이브러리를 구현할 때 기록하려는 이벤트 유형과 이벤트 기록에 추가하려는 사용자 지정 메타데이터를 지정합니다. 클라이언트 애플리케이션이 실행되면 지정된 사용자 상호 작용이 '이벤트' 영역에 읽기 이벤트, 쓰기 이벤트 또는 사용자 지정 이벤트로 기록됩니다.

클라이언트 기기가 네트워크에 연결되어 있는 동안 Atlas Device Sync 는 이 이벤트 영역 데이터를 연결된 Atlas 데이터 소스 의 AuditEvent 컬렉션 과 동기화합니다.

이벤트 라이브러리 스키마

AuditEvent 컬렉션에는 다음 필드를 포함하는 스키마가 있어야 합니다.

또한 스키마에는 사용하는 각 메타데이터 키에 대한 선택적 string 필드가 포함되어야 합니다. 예를 들면 다음과 같습니다.

{
  "<Metadata Key>": {
    "bsonType": "string"
  }
}

{
  "title": "AuditEvent",
  "bsonType": "object",
  "required": [
    "_id",
    "_partition",
    "timestamp",
    "activity"
  ],
  "properties": {
    "_id": {
      "bsonType": "objectId"
    },
    "_partition": {
      "bsonType": "string"
    },
    "timestamp": {
      "bsonType": "date"
    },
    "activity": {
      "bsonType": "string"
    },
    "event": {
      "bsonType": "string"
    },
    "data": {
      "bsonType": "string"
    }
  }
}

이벤트 읽기

이벤트 라이브러리는 쿼리 결과로 반환된 데이터를 읽기 이벤트로 기록합니다. 읽기 이벤트는 링크를 팔로우하거나 기본 키로 객체를 조회할 때와 같이 Realm 객체가 인스턴스화될 때마다 기록합니다.

이벤트 라이브러리 레코드는 읽기 이벤트를 두 개의 필드가 있는 JSON 객체로 읽습니다.

• type: 클래스 이름을 저장합니다.

• value: 직렬화된 객체의 배열을 저장합니다.

다음과 같이 이벤트 저장소 값을 읽습니다.

• 단일 객체 읽기 이벤트: 값이 단일 요소를 가진 배열입니다.

• 쿼리와 일치하는 객체: 객체가 사용되지 않는 경우에도 값은 쿼리와 일치하는 모든 객체의 배열입니다.

• 쓰기 트랜잭션(write transaction) 중에 발생하는 읽기: 값은 쓰기 트랜잭션(write transaction)이 시작되기 전에 객체에 있던 데이터입니다. 쓰기 이벤트 중에 발생하는 변경 사항은 반영하지 않습니다.

• 쓰기 트랜잭션(write transaction)이 시작될 때 존재하지 않는 객체: 쓰기 트랜잭션(write transaction)에서 생성된 객체는 읽기 이벤트를 전혀 생성하지 않습니다.

{
  "_id": "62b396f4ebe94d2b871889bb",
  "_partition":"events-62b396f4ebe94d2b871889ba",
  "activity":"read object",
  "data": "{
      "type":"Person",
      "value": [{
        "_id": "62b396f4ebe94d2b871889b9",
        "_partition":"",
        "employeeId":1,
        "name":"Anthony"
      }]
  }",
  "event":"read",
  "timestamp": 2022-06-23T14:54:37.756+00:00
}

{
  "type": "Person",
  "value": [{
    "_id": "62b47624265ff7b58e9b204e",
    "_partition": "",
    "employeeId": 1,
    "name": "Michael Scott",
    "office": "62b47624265ff7b58e9b204f"
  }]
}

{
  "type":"Person",
  "value": [{
    "_id": "62b47975a33224558bdf8b4d",
    "_partition": "",
    "employeeId": 1,
    "name": "Michael Scott",
    "office": {
      "_id": "62b47975a33224558bdf8b4e",
      "_partition": "",
      "city": "Scranton",
      "locationNumber": 123,
      "name": "Dunder Mifflin"
    }
  }]
}
{
  "type": "Office",
  "value": [{
    "_id": "62b47975a33224558bdf8b4e",
    "_partition": "",
    "city": "Scranton",
    "locationNumber": 123,
    "name": "Dunder Mifflin"
  }]
}

이벤트 쓰기

이벤트 라이브러리는 다음과 같은 경우 쓰기 이벤트를 기록합니다.

• 새 객체가 생성됩니다.

• 기존 객체가 수정됩니다.

• 객체가 삭제됩니다.

쓰기 이벤트는 객체의 이전 상태와 이후 상태를 모두 기록합니다. 생성된 새 객체의 경우 이전 상태는 null 입니다. 삭제의 경우 객체의 이후 상태는 null 입니다.

이벤트 기록 범위 중에 클라이언트가 커밋하는 각 쓰기 트랜잭션(write transaction)에 대해 이벤트 라이브러리는 단일 쓰기 이벤트를 기록합니다. 이 쓰기 이벤트는 쓰기 트랜잭션(write transaction) 중에 변경된 모든 내용을 기록합니다.

페이로드는 클래스 이름에 키가 지정된 객체 입니다. 객체가 생성, 수정 또는 삭제된 각 객체 유형에는 항목이 있습니다.

이벤트 라이브러리는 객체 유형에 대한 변경 사항을 세 개의 배열이 있는 객체 로 기록합니다.

• 삽입: 읽기와 동일한 직렬화 체계를 사용하여 삽입된 직렬화된 객체를 포함합니다.

• 수정: 각 속성의 이전 값과 새 값을 모두 보고합니다.

• 삭제: 읽기와 동일한 직렬화 체계를 사용하여 삭제된 직렬화된 객체를 포함합니다.

수정 시 newValue 객체 에는 oldValue 객체 와 다른 속성만 포함됩니다. 쓰기 트랜잭션 (write transaction) (write transaction)이 객체 에 할당되지만 실제로 속성 값을 변경하지 않는 경우,

{
  "Person": {
    "insertions": [{
      "_id": "62b47ead6a178a314ae0eb52",
      "_partition": "",
      "employeeId": 1,
      "name": "Anthony"
    }]
  }
}

{
  "Person":{
    "modifications": [{
      "newValue": {
        "name": "Tony"
      },
      "oldValue": {
        "_id": "62b47d83cdac49f904c5737b",
        "_partition": "",
        "employeeId": 1,
        "name": "Anthony"
      }
    }]
  }
}

{
  "Person":{
    "deletions":[{
      "_id":"62b47ead6a178a314ae0eb52",
      "_partition":"",
      "employeeId":1,
      "name":"Tony",
      "userId":"tony.stark@starkindustries.com"
    }]
  }
}

사용자 지정 이벤트

사용자 지정 이벤트는 다음과 같이 데이터베이스를 읽거나 쓰지 않는 이벤트 유형을 기록할 수 있습니다.

• 특정 화면이 표시되는 경우

• 사용자가 버튼을 클릭할 때

사용자 지정 이벤트를 사용하여 클라이언트 애플리케이션이 특정 화면을 표시할 때 사용자 지정 이벤트를 기록하는 등 이벤트를 읽고 쓸 수 있는 컨텍스트를 제공할 수 있습니다. 그런 다음 앱 화면 로딩을 기록하는 사용자 지정 이벤트 이후에 읽기 및 쓰기 이벤트가 모두 해당 앱 화면에서 발생했음을 유추할 수 있습니다.

사용자 지정 이벤트는 개발자 가 원하는 데이터를 저장 하거나 전혀 저장하지 않을 수 있습니다.

{
  "_id": "62b4804c15659310991e5e0a",
  "_partition": "events-62b4804b15659310991e5e09",
  "activity": "login",
  "event": "custom event",
  "timestamp": 2022-06-23T15:01:31.941+00:00
}