이벤트 구독

Integration Connectors를 사용하면 백엔드에서 읽기 및 쓰기 작업을 수행하는 것 외에도 백엔드 애플리케이션에서 발생하는 이벤트를 구독할 수 있습니다. 예를 들어 새 Jira 티켓이 생성될 때 알림을 받기를 원한다고 가정해 봅시다. 이벤트 구독을 위해 Jira Cloud 커넥터를 구성하면 됩니다. Application Integration과 함께 이벤트 구독을 사용하면 비즈니스 요구사항을 해결하는 데 유용한 통합을 만들 수 있습니다. 자세한 내용은 통합에서 이벤트 구독 사용을 참조하세요.

연결에서 이벤트 구독 사용 설정

생성된 연결은 다음과 같은 목적으로 사용될 수 있습니다.

커넥터 작업(항목 및 조치)만 수행
이벤트 구독만
커넥터 작업 및 이벤트 구독 수행

구독 생성 중에 이벤트 구독을 사용 설정하고 이벤트 관련 세부정보를 구성하는 옵션을 사용할 수 있습니다. 하지만 기존 연결의 용도를 이벤트 구독으로 변경하려면 연결을 수정 및 재구성하면 됩니다.

다음 커넥터는 이벤트 구독을 지원합니다.

이벤트 알림 데이터 보강

이벤트 알림 응답에 추가 정보를 추가하도록 연결을 구성할 수 있습니다. 추가 정보는 이벤트를 구성한 항목에 따라 달라집니다. 추가 정보를 가져오려면 연결에서 데이터 보강을 사용 설정해야 합니다.

예를 들어 Zendesk에서 티켓 생성 이벤트를 구독한 경우 티켓이 생성되면 알림을 받게 됩니다. 그러나 이벤트 알림 페이로드는 기본 티켓 세부정보로만 구성됩니다. 티켓 설명, 양수인, 상태와 같은 추가 세부정보는 페이로드에 없습니다. ticket 항목의 추가 세부정보를 가져오려면 Zendesk 연결에서 데이터 보강을 사용 설정해야 합니다. 자세한 내용은 이벤트 구독 구성을 참조하세요. 다음 샘플에서는 데이터 보강 유무에 따른 응답 페이로드를 보여줍니다.

데이터 보강이 없는 페이로드

다음 샘플은 데이터 보강이 없는 Zendesk 티켓 생성 이벤트의 응답 페이로드를 보여줍니다.

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

데이터 보강이 있는 페이로드

다음 샘플은 데이터 보강이 있는 Zendesk 티켓 생성 이벤트의 응답 페이로드를 보여줍니다.

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

이벤트 구독 비공개 연결

보안 강화를 위해 백엔드 애플리케이션과 연결 간에 비공개 연결을 구성할 수 있습니다. 비공개 연결에서는 연결의 이벤트 리스너가 직접 공개되지 않습니다. 대신 Integration Connectors에서 제공하는 PSC 서비스 연결을 통해 이벤트 리스너에 대한 인그레스 네트워크 트래픽을 허용해야 합니다.

연결을 만드는 동안 이벤트 구독에 비공개 연결 사용 설정을 선택한 경우 Integration Connectors가 PSC 서비스 연결을 만듭니다. 적합한 방법을 사용하여 PSC 서비스 연결을 백엔드 애플리케이션에 노출해야 합니다. 한 가지 가능한 방법은 부하 분산기에서 PSC 서비스 연결을 사용한 후 백엔드 애플리케이션의 이벤트를 수락하도록 부하 분산기를 구성하는 것입니다. 그러면 연결이 부하 분산기 주소에서 백엔드의 이벤트를 리슨합니다. 다음의 대략적인 단계에서는 부하 분산기를 사용하여 비공개 연결을 구성하는 방법을 보여줍니다.

새로 만든 연결의 연결 세부정보 페이지로 이동합니다.
인그레스 엔드포인트 수정을 클릭합니다. 그러면 이벤트 구독 설정 창이 표시됩니다.
PSC 서비스 연결 이름 필드에 표시된 서비스 연결 이름을 복사합니다.
이전 단계에서 가져온 서비스 연결을 가리키는 PSC 네트워크 엔드포인트 그룹을 만듭니다.
이전 단계에서 만든 PSC 네트워크 엔드포인트 그룹을 백엔드로 사용하여 외부 부하 분산기를 만듭니다.
팁: 이미 외부 부하 분산기가 있는 경우 새 부하 분산기를 만드는 대신 이를 사용해서 비공개 연결을 구성할 수 있습니다.
이벤트 제공업체(백엔드 애플리케이션)의 IP 주소로부터의 요청을 수락하도록 부하 분산기를 구성합니다.
후속 설정(7~11)은 백엔드가 이벤트 구독의 자동 등록을 지원하는 커넥터에만 적용됩니다. 예: Zendesk, Jira
새로 만든 연결의 연결 세부정보 페이지로 이동합니다.
인그레스 엔드포인트 수정을 클릭합니다. 그러면 이벤트 구독 설정 창이 표시됩니다.
이벤트 리스너 인그레스 엔드포인트 필드에 부하 분산기의 주소를 입력합니다.
완료를 클릭합니다.
저장을 클릭하여 연결 변경사항을 저장합니다.

통합에서 이벤트 구독 사용

이벤트 구독을 통합과 함께 사용하면 복잡한 비즈니스 문제를 해결하는 통합을 만들 수 있습니다. 예를 들어 ServiceNow 이벤트를 기반으로 전체 통합 실행을 시작할 수 있습니다. Application Integration은 백엔드 애플리케이션의 활동 알림을 리슨하는 다음 트리거를 제공합니다.

HubSpot 트리거 - HubSpot 이벤트를 리슨합니다.
IBM MQ 트리거 - IBM MQ 이벤트를 리슨합니다.
Jira Cloud 트리거 - Jira Cloud 이벤트를 리슨합니다.
Rabbit MQ 트리거 - Rabbit MQ 이벤트를 리슨합니다.
ServiceNow 트리거 - ServiceNow 이벤트를 리슨합니다.
웹훅 트리거 - 일반 웹훅 이벤트를 리슨합니다.
Zendesk 트리거 - Zendesk 이벤트를 리슨합니다.

트리거를 구성하려면 연결에 대해 이벤트 구독을 사용 설정해야 합니다. 기존 연결 또는 새 연결에서 이벤트 구독을 사용 설정할 수 있습니다. Application Integration 트리거를 구성하는 방법에 대한 자세한 단계는 해당 트리거 문서를 참조하세요.

활성 구독 보기

Application Integration에서 이벤트 구독을 사용하면 Integration Connectors는 해당 연결에서 구독 항목을 만듭니다. 연결의 모든 구독을 보려면 다음 단계를 수행하세요.

Google Cloud 프로젝트의 모든 연결 페이지를 엽니다.
연결 페이지로 이동
구독을 보려는 연결을 클릭합니다.
그러면 연결 세부정보 페이지가 열립니다.
구독 탭을 클릭합니다.
그러면 연결된 모든 구독이 표시됩니다. 이 페이지에 나열된 구독은 다음 중 한 가지 상태일 수 있습니다.
- 생성 중 - 통합에 의해 구독이 생성되는 중입니다.
- 활성 - 구독이 유효하고 작동합니다.
- 일시정지 - 연결이 정지됨 상태입니다.
- 오류 - 구독 생성이 실패했습니다. 예를 들어 구독 생성 중 인증에 실패했습니다.

이벤트 구독 가격 책정

미리보기 트리거에서 이벤트 구독에 대해 처리되는 데이터(이벤트 페이로드)에는 요금이 청구되지 않습니다. 하지만 정식 버전의 트리거에서 처리되는 이벤트 구독 데이터에는 요금이 청구됩니다.