구독의 메시지 보관 구성

이 페이지에서는 Pub/Sub 구독이 게시된 메시지를 보관하는 방법과 이 동작을 구성하는 방법을 설명합니다. 다음과 같은 이유로 기본 설정을 변경할 수 있습니다.

  • 미확인 메시지가 삭제되기 전에 구독에서 사용할 수 있는 기간을 조정합니다.
  • 이전에 확인된 메시지를 다시 재생할 수 있도록 합니다.

개요

구독을 만들면 Pub/Sub에서 구독을 대신해 게시된 메시지를 보관하기 시작합니다. 기본적으로 Pub/Sub는 메시지가 확인되는 즉시 구독에서 메시지를 삭제하고 미확인 메시지는 7일 동안 보관합니다.

구독을 만들거나 업데이트할 때 보관 기간을 설정할 수 있습니다. 최소 보관 기간은 10분이고 최대 보관 기간은 31일입니다.

구성된 보관 기간까지 확인된 메시지를 보관하도록 구독을 사용 설정할 수도 있습니다. 확인된 메시지를 보관하면 보관된 기간 동안 이전에 확인된 메시지를 다시 재생할 수 있습니다. 메시지 다시 재생에 대한 자세한 내용은 탐색으로 메시지 재생 및 삭제를 참조하세요.

확인된 메시지를 보관하도록 구독을 구성하면 구독에 의해 보관된 확인 메시지에 대한 스토리지 비용이 구독 프로젝트에 청구됩니다.

구독의 주제에 메시지 보관을 사용 설정하면 메시지의 기간이 구독 보관 기간과 주제 보관 기간의 최댓값을 초과할 때만 구독에서 메시지가 삭제됩니다. 자세한 내용은 주제 메시지 보관 사용 설정을 참조하세요.

메시지 보관 구성

확인된 메시지를 보관하는 구독을 만들려면 다음 단계를 따르세요.

콘솔

  1. 콘솔 Google Cloud 에서 Pub/Sub 구독 페이지로 이동합니다.

    구독 페이지로 이동

  2. 구독 만들기를 클릭합니다.

  3. 구독 ID 필드에 구독 ID를 입력합니다.

  4. 메시지 보관 기간 섹션에서 메시지를 보관할 일, 시간, 분을 선택합니다.

  5. 확인된 메시지 보관 체크박스를 선택합니다.

  6. 구독 만들기 를 클릭합니다.

gcloud

gcloud pubsub subscriptions create를 사용합니다.

gcloud pubsub subscriptions create SUBSCRIPTION_ID \
  --message-retention-duration=5d \
  --retain-acked-messages

SUBSCRIPTION_ID를 구독 ID로 바꿉니다.

--message-retention-duration 플래그를 생략하면 메시지는 기본 기간인 7일 동안 보관됩니다.

기존 구독에서 메시지 보관 설정을 업데이트하려면 다음 단계를 따르세요.

콘솔

  1. Pub/Sub 구독 페이지에서 구독을 선택합니다.

    구독 페이지로 이동

  2. 구독 세부정보 페이지 상단의 수정 을 클릭합니다.

  3. 메시지 보관 기간 섹션에서 메시지를 보관할 일, 시간, 분을 업데이트합니다.

  4. 확인된 메시지 보관 체크박스를 선택하거나 선택 해제합니다.

  5. 업데이트 를 클릭하여 구독 변경사항을 저장합니다.

gcloud

gcloud pubsub subscriptions update 명령어를 사용합니다.

gcloud pubsub subscriptions update SUBSCRIPTION_ID \
  --message-retention-duration=1d \
  --retain-acked-messages

확인된 메시지 보관을 사용 중지하려면 --no-retain-acked-messages 플래그와 함께 update 명령어를 사용합니다.

gcloud pubsub subscriptions update SUBSCRIPTION_ID \
  --no-retain-acked-messages

다음 단계