문서 릴리즈 노트 - 2024년 6월

문서 릴리즈 노트 - 2024년 6월

2024년 6월의 모든 문서 하이라이트를 확인하세요.

이 기사는 원래 https://www.pubnub.com/docs/release-notes/2024/june 에 게시되었습니다.

안녕하세요! 이번 달에는 몇 가지 새로운 업데이트가 있습니다.

  • 데이터의 일관성을 유지하는 데 도움이 되는 새로운 참조 무결성 플래그를 도입했습니다.
  • 이제 관리자 포털에서 바로 채널 그룹 제한을 설정할 수 있습니다.
  • Insights에서 BizOps로 데이터를 가져와서 기능을 테스트해 보세요.
  • 또한 프레즌스 관리의 모양과 느낌이 개선된 것을 확인할 수 있습니다.

그 외에도 문서에 작지만 중요한 개선 사항이 다수 포함되어 있어 PubNub을 사용할 때 궁금했던 점을 해소하거나 의구심을 해소할 수 있을 것입니다.

즐거운 탐색을 하시고 커뮤니티의 일원이 되어 주셔서 감사합니다!

일반 🛠️

FCM 페이로드의 사용자 정의 필드

유형: 개선

FCM 모바일 푸시 알림 페이로드에 추가할 수 있는 누락된 사용자 정의 PubNub 매개변수인 pn_debug, pn_exceptions, pn_dry_run을 추가하여 Android 모바일 푸시 알림에 대한 문서를 수정했습니다.

이를 통해 알림을 테스트하거나 디버그하고 선택한 디바이스를 알림 수신에서 제외할 수 있습니다.

다음은 사용자 지정 필드가 포함된 FCM 페이로드 샘플입니다:

{
  "pn_fcm": {
    "notification": {
      "title": "My Title",
      "body": "Message sent at"
 },
    "pn_collapse_id": "collapse-id",
    "pn_exceptions": [
      "optional-excluded-device-token1"
 ]
 },
  "pn_debug": true,
  "pn_dry_run": false
}

채널 그룹 제한

유형: 새로운 기능

관리자 포털의 스트림 컨트롤러에는 유료 요금제를 사용하는 고객을 위해 구성 가능한 새로운 채널 그룹 제한 옵션이 추가되어 키 집합의 채널 그룹이 가질 수 있는 최대 채널 수에 대한 제한을 설정할 수 있습니다. 기본 제한인 1,000개 채널을 낮추거나 최대 2,000개 채널까지 늘릴 수 있습니다.

Channel group limits

앱 컨텍스트의 사용자 메타데이터 이벤트

유형: 개선

사용자 메타데이터 이벤트 옵션을 활성화하면 사용자 개체에 대한 모든 수정(설정삭제)이 모든 멤버십 연결에 이벤트 알림을 전송하므로 해당 사용자와 해당 사용자가 회원으로 가입한 모든 채널에 알림이 전송된다는 점을 명확히 하기 위해 문서를 개선했습니다. 자세한 내용은 문서를 참조하세요.

User metadata events

앱 컨텍스트 구성 종속성

유형: 개선

중요한 종속성에 대한 정보를 포함하도록 앱 컨텍스트 구성 옵션에 대한 문서를 업데이트했습니다.

Get all user or channel metadata

모든 채널 메타데이터 가져오기 허용 안 함모든 사용자 메타데이터 가져오기 허용 안 함 옵션은 매우 자명해 보이지만, 이러한 옵션은 액세스 관리자가 활성화된 경우에만 작동한다는 점을 주의해야 합니다.

즉, 액세스 관리자가 없는 경우에는 이러한 활성화된 옵션이 실제로 키 집합의 사용자 또는 채널에 대한 메타데이터 가져오기를 비활성화하지 않습니다. 동시에 Access Manager를 사용 설정하면 기본적으로 키 집합의 모든 개체에 대한 액세스가 제한되므로 세분화된 권한 스키마를 만들지 않고도 이 두 가지 구성 옵션을 모두 선택 해제하여 사용자 및 채널에 대한 Access Manager GET 제한을 쉽게 우회할 수 있습니다.

관리자 포털 UI에도 곧 이러한 종속성이 반영될 예정입니다.

앱 컨텍스트의 새로운 참조 무결성 플래그

유형에 추가되었습니다: 새로운 기능

관리자 포털에서 앱의 키 집합에서 앱 컨텍스트를 활성화하면 기본적으로 켜지는 멤버십에 참조 무결성 적용 옵션이 새로 추가되었습니다.

Referential integrity flag

이 플래그를 사용하면 멤버십을 생성한 사용자 ID와 채널 ID가 모두 존재하는 경우에만 새 멤버십을 설정할 수 있습니다. 동시에 상위 사용자 또는 채널 메타데이터 개체를 삭제하면 삭제된 개체에 대한 모든 하위 멤버십 연결이 자동으로 삭제됩니다. 이렇게 하면 키 집합에 오작동하거나 고아 멤버십 개체가 없는지 확인할 수 있습니다.

SDK 📦

Python 문서 개선

Type: 개선

받은 피드백에 따라 메서드 사용 및 실행에 대한 정보를 확장했습니다. 그 결과, 이제 Python SDK 문서의 각 반환 섹션에 각 메서드가 반환하는 데이터 필드가 설명되어 있습니다. 또한 동기화(.sync()) 및 비동기(.pn_async(callback)) 요청 실행이 각 메서드의 반환 데이터에 어떤 영향을 미치는지도 설명합니다.

React SDK가 사용 중단되었습니다.

Type: 사용 중단 공지

한동안 React SDK를 적극적으로 개발하지 않았기 때문에 마침내 공식적으로 해당 문서를 폐기하고 문서의 기여 요청 섹션으로 옮기기로 결정했습니다.

React SDK에서 버그를 발견하거나 기능을 확장하고 싶은 경우, 언제든지 리포지토리에 풀 리퀘스트를 생성하고 피드백을 기다리세요!

함수

이벤트 및 액션을 통해 함수 로그 내보내기

타입을 통해 함수 로그 내보내기: 새로운 기능

각 PubNub 함수는 새로운 함수가 로그를 덮어쓰기 전에 최대 250줄의 로그를 저장할 수 있는 내부 블록 출력* 채널(예: blocks-output-NSPiAuYKsWSxJl4yBn30)에 로그를 저장합니다. 이전 로그를 추적하고 싶지 않다면 이제 이벤트 및 작업을 사용하여 이러한 로그를 외부 서비스로 내보낼 수 있습니다.

Functions log

인사이트 📊

REST API 문서의 사용자 지속 시간 및 디바이스 메트릭

유형: 개선 사항

지난 달, 관리자 포털의 PubNub 인사이트에 있는 사용자 행동 대시보드에 디바이스 지표를 도입했습니다. 이번 달에는 사용자 지속 시간과 기기 메트릭을 모두 포함하도록 REST API 문서를 업데이트하여 PubNub Insights API를 직접 호출하여 관심 있는 메트릭을 가져올 수 있도록 했습니다.

비즈옵스 워크스페이스 🏢

상위 20개 사용자/채널

유형: 새로운 기능

앱 컨텍스트를 사용하여 사용자 및 채널을 저장하고 관리하지 않는 경우에도 테스트 데이터를 임포트하여 관련 BizOps Workspace 기능을 테스트할 수 있습니다.

PubNub 인사이트에 액세스할 수 있는 경우 관리자 포털의 BizOps Workspace에서 사용자 관리채널 관리 모듈로 이동하여 인사이트에서 가져오기 버튼을 클릭하여 액세스할 수 있습니다.

결과적으로 앱의 키 집합에서 지난 하루 동안 가장 많은 수의 메시지를 게시한 최대 20명의 사용자를 가져오게 됩니다(어제 메시지를 보내지 않은 경우에는 하루 전의 데이터를 기준으로 사용자를 가져오게 됩니다).

Top 20 users

사용자와 마찬가지로 앱의 키설정에서 최근 하루 동안 가장 많은 수의 메시지를 게시한 채널을 최대 20개까지 가져올 수 있습니다.

Top 20 channels

이 테스트 데이터를 사용하여 비즈옵스 워크스페이스가 제공하는 기능을 살펴보세요.

개선된 프레즌스 관리 UX

유형: 개선

최근에 BizOps Workspace의 전체 프레즌스 관리 모듈을 재설계하여 규칙 만들기 마법사를 간소화하고, 배지 색상을 보다 포괄적인 색상으로 변경하고, 키 집합의 프레즌스 구성의 기본 "모든 채널에서 프레즌스 활성화" 설정을 반영하는 "캐치 올" 패턴 구성을 추가했습니다.

Presence Management

새로운 디자인과 느낌이 마음에 드시길 바랍니다!