Google Cloud Pub/Sub | 설치 매뉴얼 | 로그프레소 스토어

Note

본 매뉴얼은 2026-09-10 기준으로 작성되었으며, 구글 클라우드 콘솔의 화면 구성과 메뉴 명칭은 이후 변경될 수 있습니다.

구글 클라우드 콘솔에서 새로운 프로젝트를 생성하세요. 프로젝트 생성 화면에서 표시되는 프로젝트 ID는 이후 단계에서 필요하므로 별도로 복사합니다. 이 단계를 지나가더라도 목록에서 조회할 수 있습니다.
IAM 및 관리자 > 서비스 계정에서 서비스 계정 만들기를 클릭하세요.
서비스 계정 이름에 logpresso를 입력하세요. 서비스 계정 ID는 서비스 계정 이름을 따라 자동으로 생성됩니다.
서비스 계정에 권한을 부여하세요. 메시지를 구독하려면 게시/구독 구독자 권한을, 메시지를 게시하려면 게시/구독 게시자 권한도 함께 부여하세요. 역할별 권한은 액세스 제어 문서에 정의되어 있습니다.
사용자에게 서비스 계정 권한을 부여하는 단계는 별도 설정 없이 완료를 클릭하세요.

이전 단계에서 생성된 서비스 계정에 대한 키를 발급해야 합니다.

주제(topic)와 구독(subscription)은 서로 다른 리소스이며 각각 별도의 ID를 가집니다. 주제는 메시지가 게시되는 대상이고, 구독은 그 주제에서 메시지를 가져가는 창구입니다.

프로젝트 (프로젝트 ID)
└─ 주제 (주제 ID)                  ← 메시지를 게시하는 대상
   └─ 구독 (구독 ID)               ← 로그프레소가 메시지를 가져오는 창구

로그프레소 접속 프로파일에는 프로젝트 ID를, 수집기에는 구독 ID를 입력합니다. 주제 ID는 메시지를 게시할 때(gcp-pubsub-publish 명령어)만 사용합니다.

주제에 구독이 하나도 없으면 게시된 메시지는 보관되지 않고 즉시 폐기됩니다.

Pub/Sub의 주제 화면에서 주제 만들기를 클릭하세요.
주제 ID를 입력하고, 만들기를 클릭하세요. 이때 기본 구독 추가 항목이 선택되어 있으면 {주제 ID}-sub 형식의 구독이 함께 생성됩니다. 이 값이 다음 단계에서 확인할 구독 ID입니다.
구독 ID는 생성한 Pub/Sub 주제에서 확인할 수 있습니다. 구독 ID는 로그프레소 수집 설정 단계에서 사용됩니다. 구독을 새로 만드는 경우 전송 유형은 반드시 가져오기(Pull)를 선택하세요. 전송 유형에 대한 설명은 Pull 구독 문서를 참고하십시오.