Azure Data Explorer 대시보드 타일 오류 문제 해결

Azure Data Explorer에서 대시보드로 작업할 때 타일에 시각화 대신 오류가 표시될 수 있습니다. 이러한 오류는 문제의 유형을 이해하고 다음 단계를 결정하는 데 도움이 되도록 분류됩니다. 각 오류 유형은 오류가 발생한 쿼리, 데이터 검색 또는 렌더링 프로세스의 다른 단계를 나타냅니다.

다양한 타일 오류 유형 예제의 스크린샷.

타일 오류 유형 이해

다음 섹션에서는 일반적인 타일 오류 범주, 해당 오류 범주의 의미 및 이를 해결하는 일반적인 방법을 설명합니다.

액세스 거부됨

타일은 기본 데이터 원본에서 데이터에 액세스하거나 검색할 수 없습니다. 이 오류는 사용자가 데이터 원본에 액세스할 수 있는 권한이 없는 경우에 발생합니다.

수행할 일:

  • 데이터 원본이 있고 연결할 수 있는지 확인합니다.
  • 데이터 원본에 액세스할 수 있는 권한이 있는지 확인합니다.
  • 가용성을 확인한 후 새로 고침을 시도합니다.

구문 오류

타일에 사용된 쿼리에 잘못된 구문이 포함되어 있으며 구문 분석할 수 없습니다. 이 오류는 쿼리를 편집하거나 새 타일을 만들 때 발생합니다.

수행할 일:

  • 쿼리에서 누락된 연산자 또는 잘못된 식과 같은 구문 문제를 검토합니다.
  • 쿼리 편집기에서 쿼리의 유효성을 검사합니다.
  • 수정 후 오류가 나타난 경우 최근 변경 내용을 되돌려 드립니다.

의미적 오류

쿼리는 구문상 유효하지만 잘못된 참조 또는 논리를 사용합니다. 이 오류는 쿼리가 존재하지 않는 테이블, 열 또는 호환되지 않는 데이터 형식을 참조할 때 발생합니다.

수행할 일:

  • 참조된 테이블 및 열이 있는지 확인합니다.
  • 이름이 변경되거나 삭제된 개체를 확인합니다.
  • 쿼리 논리 및 데이터 형식의 유효성을 검사합니다.
  • 현재 스키마와 일치하도록 쿼리를 업데이트합니다.

네트워크 오류

대시보드와 백 엔드 서비스 간의 연결이 실패했습니다. 이 오류는 일시적인 연결 문제 또는 서비스 중단으로 인해 발생합니다.

수행할 일:

  • 네트워크 연결을 확인합니다.
  • 대시보드를 새로 고칩니다.
  • 문제가 일시적인 경우 잠시 후 다시 시도합니다.
  • 문제가 지속되면 서비스 상태를 확인하거나 지원에 문의하세요.

시각적 서식 문제

타일은 구성 또는 서식 문제로 인해 시각적 개체를 렌더링할 수 없습니다. 이 문제는 쿼리가 성공적으로 실행되었지만 시각적 개체가 제대로 표시되지 않을 때 발생합니다.

수행할 일:

  • 필드 할당 및 서식 규칙과 같은 시각적 설정을 검토합니다.
  • 필수 필드가 포함되어 있는지 확인합니다.
  • 시각적 구성을 간소화하거나 다시 설정합니다.
  • 필요한 경우 시각 자료를 다시 만드세요.

오류가 발생함

이전 범주에 맞지 않는 일반적인 오류가 발생했습니다. 이 catch-all 오류는 예기치 않은 예외 또는 처리되지 않은 경우와 같은 다양한 이유로 발생할 수 있습니다.

수행할 일:

  • 자세한 내용은 오류 메시지를 확인하세요.
  • 타일, 쿼리 또는 데이터 원본에 대한 최근 변경 내용을 검토합니다.
  • 대시보드를 새로 고쳐 보세요.
  • 문제가 지속되면 오류 세부 정보를 사용하여 지원에 문의하세요.

오류 메시지에서 자세한 정보 가져오기

타일 오류가 발생하면 타일을 마우스로 가리켜 세부 정보 단추를 표시합니다. 근본 원인을 식별하는 데 도움이 되는 오류 코드 및 메시지를 포함하여 오류에 대한 자세한 정보를 보려면 이 단추를 선택합니다.

다음은 그 예입니다.

타일 오류 세부 정보 예제의 스크린샷.

일반적인 문제 해결 방법

진행 방법을 잘 모르는 경우:

  • 대시보드를 새로 고쳐 일시적인 문제를 배제합니다.
  • 다른 타일을 확인합니다.
    • 여러 타일이 실패하면 데이터 원본 또는 서비스 문제가 있을 수 있습니다.
    • 하나의 타일이 실패하면 쿼리 또는 구성 문제가 있을 수 있습니다.
  • 최근 변경 내용을 검토합니다.
    • 쿼리 편집
    • 데이터 원본 업데이트
    • 권한 변경
  • 가능한 경우 편집기에서 쿼리의 유효성을 검사합니다.
  • 문제가 액세스 또는 공유 리소스와 관련된 경우 관리자 또는 데이터 소유자에게 문의하세요.