가져오기 전송 문제 해결하기

gcpdiag 도구를 사용하여 가져오기 구독의 잠재적인 전송 문제를 발견하고 해결합니다.

gcpdiag 도구 사용

gcpdiag는 오픈소스 도구입니다. 공식적으로 지원되는 Google Cloud 제품이 아닙니다. gcpdiag 도구를 사용하여 Google Cloud 프로젝트 문제를 식별하고 해결할 수 있습니다. 자세한 내용은 GitHub의 gcpdiag 프로젝트를 참조하세요.

gcpdiag 도구는 다음 검사를 수행하여 Pub/Sub 가져오기 전송 문제를 확인하는 데 도움이 됩니다.

• 할당량 오류: 로그 탐색기 로그를 평가하여 리전 및 영역의 할당량 오류를 확인합니다.
• 처리량 검증: 구독의 전송 지연 시간 상태를 확인합니다.

gcpdiag 가져오기 전송 평가 단계 목록은 잠재적 단계를 참고하세요.

gcpdiag 명령어 실행

Google Cloud CLI 또는 Docker 컨테이너 내에서 gcpdiag 명령어를 실행할 수 있습니다.

Google Cloud 콘솔

1. 다음 명령어를 작성하고 복사합니다.

gcpdiag runbook pubsub/pull-subscription-delivery \
  --project=PROJECT_ID \
  --parameter subscription_name=SUBSCRIPTION_NAME

2. Google Cloud 콘솔을 열고 Cloud Shell을 활성화합니다.
Cloud 콘솔 열기
3. 복사한 명령어를 붙여넣습니다.
4. gcpdiag 명령어를 실행하면 gcpdiag Docker 이미지를 다운로드한 후 진단 검사를 수행합니다. 해당하는 경우 출력 안내에 따라 실패한 검사를 수정합니다.

Docker

Docker 컨테이너에서 gcpdiag를 시작하는 래퍼를 사용하여 gcpdiag를 실행할 수 있습니다. Docker 또는 Podman이 설치되어 있어야 합니다.

1. 로컬 워크스테이션에서 다음 명령어를 복사하고 실행합니다.

   curl https://gcpdiag.dev/gcpdiag.sh >gcpdiag && chmod +x gcpdiag

2. gcpdiag 명령어를 실행합니다.

   ./gcpdiag runbook pubsub/pull-subscription-delivery \
     --project=PROJECT_ID \
     --parameter subscription_name=SUBSCRIPTION_NAME

이 런북에 사용 가능한 매개변수를 봅니다.

다음을 바꿉니다.

• PROJECT_ID: 평가할 프로젝트의 ID
• SUBSCRIPTION_NAME: 프로젝트에서 평가할 구독의 이름

유용한 플래그:

• --universe-domain: 해당되는 경우 리소스를 호스팅하는 신뢰할 수 있는 파트너 주권 클라우드 도메인
• --parameter 또는 -p: 런북 파라미터

모든 gcpdiag 도구 플래그의 목록과 설명은 gcpdiag 사용 안내를 참조하세요.

관련 정보 읽기

• Pub/Sub 가져오기 구독 일반적인 문제