데이터 스튜디오의 오류 문제 해결

데이터 스튜디오는 보고 중에 오류를 표시하는 경우가 있습니다. 이러한 오류는 데이터 소스 손상, 잘못된 차트 설정 또는 플랫폼 할당량 초과를 비롯한 여러 가지 이유로 발생할 수 있습니다. 이러한 일반적인 오류를 이해하면 보고서의 문제를 해결하는 데 도움이 됩니다.

이 가이드의 단계에 따라 차트, 보고서, 데이터 소스 전반에서 문제를 조사하고 해결하세요.

---

기본 상태 관리 단계

일시적인 네트워크 문제 또는 서버 결함으로 인해 데이터 스튜디오에서 예기치 않은 문제가 발생할 수 있습니다. 복잡한 설정을 문제 해결하는 데 시간을 보내기 전에 이러한 빠른 검사를 시도해 보세요. 각 단계를 시도한 후 문제가 해결되었는지 확인합니다.

증상 및 오류 메시지

오류 메시지는 코드 글꼴로 표시됩니다.

• 페이지 응답 없음
• System error
• Data Studio is not available

---

액세스 문제

Google Workspace 또는 Cloud ID를 사용하는 경우 조직 관리자가 데이터 스튜디오를 사용 설정해야 액세스할 수 있습니다. 마찬가지로 다른 조직의 사용자와 보고서를 공유할 때 해당 사용자의 관리자가 계정에 데이터 스튜디오를 사용 설정해야 합니다.

계정에 서비스 사용 중지됨

We are sorry, but you do not have access to this service. Please contact your Organization Administrator for access.

OAuth 승인 및 동의 프롬프트

처음으로 데이터 스튜디오 기능에 로그인하거나 사용할 때 Google 계정에 대한 액세스를 요청하는 OAuth 동의 대화상자가 표시될 수 있습니다. 이 동의를 부여하면 데이터 스튜디오가 사용자를 대신하여 기본 데이터 API와 안전하게 통신할 수 있습니다.

보고서 수신자에게 서비스 사용 중지됨

데이터 스튜디오 보고서를 다른 사용자와 공유하려고 할 때 다음 오류 메시지가 표시될 수 있습니다.

You do not have access to Data Studio. To enable this service, please log in to the Admin console.

원인: 이 오류 메시지는 수신자의 Google Workspace 또는 Cloud ID 계정에 데이터 스튜디오 서비스가 사용 설정되어 있지 않음을 나타냅니다. 조직 관리자가 그룹의 데이터 스튜디오를 사용 중지하거나 제한했습니다.

---

데이터 소스 및 연결 문제

데이터 연결 오류는 데이터 사용자 인증 정보 누락, 구성 손상, 데이터 소스 삭제 또는 액세스 권한 취소 등 여러 가지 이유로 발생합니다. 데이터 연결 문제를 해결하려면 다음 단계를 따르세요.

커넥터별 문제 해결 및 오류

특정 데이터 커넥터에서 오류 (예: 쿼리 시간 초과, 모호한 조인 필드 또는 데이터 세트 한도)가 발생하는 경우 해당 커넥터의 문제 해결 가이드를 확인하세요.

• BigQuery 커넥터: BigQuery 커넥터 오류 및 제한사항 문제 해결을 참고하여 Field is ambiguous 조인, HTTP 504 Gateway timeout 오류, 데이터 세트 표 한도 (>5,000 tables), CONDITION_NOT_MET 암호화 (CMEK) 오류, TIME 변환, VPC 서비스 제어 (VPC-SC) VPN 외부 오류를 해결하세요.
• Looker 커넥터: Looker 커넥터의 오류 문제 해결을 참고하여 Looker 관련 연결 및 Explore 실패를 해결하세요.

가능한 오류 메시지

오류 메시지는 코드 글꼴로 표시됩니다.

• Missing data source
• Data set configuration error
• No data set access
• Data source not attached
• Data source needs to be added
• The underlying data has changed
• Database connection error

VPC 서비스 제어 뒤에 예약된 이메일 또는 알림 실패

데이터 소스가 IP 기반 액세스 수준을 사용하여 VPC 서비스 제어 (VPC-SC) 경계로 보호되는 경우 자동화된 백그라운드 기능이 실패할 수 있습니다.

가능한 증상 및 오류 메시지는 다음과 같습니다.

• 예약된 이메일 전송에 보고서 링크만 포함되고 보고서 콘텐츠 또는 PDF 첨부파일이 누락됩니다.
• 차트 알림이 트리거되지 않거나 알림 전송이 중지됩니다.
• Organization VPC Service Controls prohibit access to data set used by this component
• Service Control Failure

---

구성 및 차트 수준 문제

설정이 불완전하거나 호환되지 않는 필드가 있는 차트에는 오류가 표시됩니다. 괄호 누락, 잘못된 함수 이름 또는 잘못된 연산자와 같은 수식 구문 오류가 발생할 수도 있습니다. 데이터 스튜디오는 수식의 손상된 섹션을 강조표시합니다.

가능한 오류 메시지

오류 메시지는 코드 글꼴로 표시됩니다.

• System error
• Chart configuration incomplete
• Invalid combination of metrics and dimensions
• Get report failed

---

사용자 인터페이스 및 기능 문제

데이터 스튜디오가 제대로 작동하지 않거나 응답하지 않으면 브라우저 확장 프로그램 또는 부가기능으로 인해 충돌이 발생할 수 있습니다.

증상 및 오류 메시지

오류 메시지는 코드 글꼴로 표시됩니다.

• 기능이 작동하지 않음
• UI 요소 누락
• 제품이 반응하지 않음
• Sorry! We can't save this report right now.

---

혼합 문제

대부분의 혼합 오류는 잘못 구성된 조인, 데이터 소스 누락, 예기치 않은 혼합 결과의 세 가지 카테고리로 분류됩니다.

잘못 구성된 조인 오류

오류 메시지는 코드 글꼴로 표시됩니다.

• One or more join configurations is incomplete.
• One or more join configurations is missing a join condition.
• Join key incomplete. Each selected data source must specify a join key field for every join key.
• 조인 조건 내에 분홍색 Missing 필드가 표시됩니다.

누락되거나 잘못된 데이터 소스 연결

One or more tables is missing its data source.

---

Google 애널리틱스 4 할당량 초과

Google 애널리틱스 4 (GA4) 데이터에 연결되는 보고서에는 GA4 Data API 할당량이 적용됩니다. Google 애널리틱스 토큰 사용량 대화상자를 열어 보고서의 할당량 토큰 사용량을 모니터링할 수 있습니다.

토큰 사용량 보기

1. 데이터 스튜디오 보고서를 수정합니다.
2. 보고서의 전체 토큰 사용량을 확인하려면 보고서 캔버스를 마우스 오른쪽 버튼으로 클릭하고 Google 애널리틱스 토큰 사용량 을 선택합니다.
3. 특정 차트의 토큰 사용량을 확인하려면 차트를 마우스 오른쪽 버튼으로 클릭하고 Google 애널리틱스 토큰 사용량 을 선택합니다.

전체 사용량 요약에는 다음이 표시됩니다.

• 세션 중에 보고서 전체 또는 현재 페이지에서 사용된 할당량 토큰입니다.
• API 한도에 도달하기 전에 남아 있는 할당량 토큰입니다.
• 각 차트에서 사용된 할당량 토큰으로, 가장 높은 것부터 가장 낮은 것까지 나열됩니다.

차트 수준 사용량 요약에는 다음이 표시됩니다.

• 각 쿼리 요청에서 사용된 할당량 토큰입니다.
• 쿼리의 정확한 완료 타임스탬프입니다.
• 차트가 GA4에서 직접 로드되었는지 또는 메모리 캐시에서 로드되었는지 여부입니다. 녹색 체크표시는 토큰을 사용하지 않고 차트가 메모리에서 로드되었음을 나타냅니다. 빨간색 X는 차트가 Google 애널리틱스 4를 직접 쿼리했음을 나타냅니다 (데이터 기록 빈도에 대해 자세히 알아보기).

할당량 초과 오류 메시지

GA4 할당량을 초과하는 보고서에는 다음 오류 중 하나가 표시됩니다.

• Exhausted concurrent requests quota. Please send fewer requests concurrently.
• This property has issued too many requests in the last day.
• Too many requests using this Google Analytics property have encountered errors in the last hour.
• This property has issued too many requests in the last hour.
• This property is denied access to Google Analytics.
• This property has issued too many potentially thresholded requests in the last hour.
• This project/property has issued too many requests in the last hour.

---

복잡한 문제를 해결하기 위한 전략

데이터 스튜디오에서 복잡한 문제를 진단하려면 먼저 문제가 발생하는 위치를 파악 합니다. 스스로 다음과 같은 내용을 질문해 보세요.

• 문제가 모든 보고서에서 발생하나요, 아니면 하나의 보고서에서만 발생하나요?
• 모든 차트 유형에 영향을 미치나요, 아니면 특정 구성요소에만 영향을 미치나요?
• 모든 웹브라우저에서 발생하나요, 아니면 특정 버전에서만 발생하나요?

참고 항목: 데이터 스튜디오 사용 요건

그런 다음 변수를 줄입니다. 보고서 또는 데이터를 간소화하여 문제를 가능한 가장 작은 요소로 분리합니다.

• 데이터 문제 분리: 잘못된 데이터가 의심되는 경우 필터를 적용하여 행의 절반을 숨깁니다. 오류가 사라지면 손상된 데이터가 숨겨진 절반에 있는 것입니다. 오류가 계속되면 손상된 데이터가 표시된 절반에 있는 것입니다. 잘못된 레코드를 찾을 때까지 행을 계속 나눕니다.
• 차트 문제 분리: 측정기준과 측정항목이 하나만 포함된 손상된 차트 버전을 만듭니다. 오류가 다시 나타날 때까지 필드와 스타일 지정 옵션을 하나씩 다시 추가합니다.

---

Google에 문제 신고

이 단계를 시도한 후에도 문제를 해결할 수 없는 경우 Google에 신고하세요. 다음과 같은 정보를 제공할 준비를 하세요.

• 문제에 관한 자세한 설명
• 실패를 재현하는 단계
• 표시된 오류 메시지 또는 오류 ID
• 문제를 보여주는 테스트 보고서 링크

오류 ID에 대한 정보

8자의 영숫자 오류 ID (Error ID: a1b2c3d4)가 표시되면 항상 버그 신고에 포함하세요. 오류 ID는 Google 엔지니어가 시스템 로그에서 정확한 실패 추적을 찾는 데 도움이 됩니다. 오류 ID는 모든 단일 실패 이벤트에 대해 동적으로 생성되므로 오류가 발생할 때마다 새 ID가 생성됩니다.

테스트 보고서에 대한 정보

Google 지원팀과 테스트 보고서를 공유할 때는 보고서를 최대한 간단하게 유지하세요. 원본 보고서의 사본을 만들고 버그를 재현하는 데 필요하지 않은 관련 없는 페이지, 차트, 필터를 모두 삭제합니다.