Azure Time Series Insights Gen2 환경 진단 및 문제 해결

이 문서에서는 Azure Time Series Insights Gen2 환경에서 작업할 때 발생할 수 있는 몇 가지 일반적인 문제를 요약합니다. 또한 이 문서에서는 각 문제에 대한 잠재적 원인 및 해결 방법도 설명합니다.

문제: Gen2 탐색기에서 내 환경을 찾을 수 없음

Time Series Insights 환경에 액세스할 수 있는 권한이 없는 경우 이 문제가 발생할 수 있습니다. 사용자는 Time Series Insights 환경을 보려면 판독기 수준 액세스 역할이 필요합니다. 현재 액세스 수준을 확인하고 추가 액세스 권한을 부여하려면 Azure PortalTime Series Insights 리소스의 데이터 액세스 정책 섹션으로 이동합니다.

문제: Gen2 탐색기에 데이터가 표시되지 않음

Azure Time Series Insights Gen2 탐색기에 데이터가 표시되지 않는 몇 가지 일반적인 이유가 있습니다.

• 이벤트 원본이 데이터를 수신하지 않을 수 있습니다.

  이벤트 허브나 IoT Hub와 같은 이벤트 원본이 태그 또는 인스턴스에서 데이터를 수신하고 있는지 확인하세요. 확인하려면 Azure Portal에서 리소스의 개요 페이지로 이동합니다.

  

• 이벤트 원본 데이터가 JSON 형식이 아닙니다.

  Time Series Insights는 JSON 데이터만 지원합니다. JSON 샘플의 경우 지원되는 JSON 셰이프읽습니다.

• 이벤트 소스 키에 필수 권한이 누락되었습니다.

  • IoT 허브의 경우, 서비스 연결 권한 이 있는 키를 제공해야 합니다.

    

    • iothubowner 정책과 서비스 정책은 서비스 연결 권한이 있어서 작동합니다.

  • 이벤트 허브의 경우 수신 대기 권한이 있는 키를 제공해야 합니다.

    

    • 읽기 및 관리 정책은 모두 수신 권한이 있기 때문에 작동합니다.

• 제공된 소비자 그룹은 Time Series Insights에만 국한되지 않습니다.

  IoT Hub 또는 이벤트 허브를 등록하는 동안 데이터를 읽는 데 사용되는 소비자 그룹을 지정합니다. 이 소비자 그룹은 환경별로 고유해야 합니다. 소비자 그룹을 공유하는 경우 기본 이벤트 허브는 임의로 판독기 중 하나의 연결을 자동으로 끊습니다. Time Series Insights에서 읽을 수 있는 고유한 소비자 그룹을 제공합니다.

• 프로비전 시 지정된 시계열 ID 속성이 잘못되었거나 누락되었거나 null입니다.

  이 문제는 환경을 프로비전할 때 시계열 ID 속성이 잘못 구성된 경우에 발생할 수 있습니다. 시계열 ID선택을 위한 모범 사례 을 참조하여 자세한 내용을 확인하세요. 현재는 기존 Time Series Insights 환경을 업데이트하여 다른 시계열 ID를 사용할 수 없습니다.

문제: 일부 데이터가 표시되지만 일부는 누락되었습니다.

시계열 ID 없이 데이터를 보낼 수도 있을 수 있습니다.

• 이 문제는 페이로드에 시계열 ID 필드가 없는 이벤트를 보낼 때 발생할 수 있습니다. 자세한 내용은 지원되는 JSON 셰이프읽어보세요.

• 이 문제는 환경이 제한되고 있기 때문에 발생할 수 있습니다.

  메모

  현재 Time Series Insights는 최대 수집 속도 1Mbps를 지원합니다.

문제: 데이터가 표시되었지만 이제 수집이 중지되었습니다.

• 이벤트 원본 키가 다시 생성되었을 수 있으며 Gen2 환경에 새 이벤트 원본 키가 필요합니다.

이 문제는 이벤트 원본을 만들 때 제공된 키가 더 이상 유효하지 않은 경우에 발생합니다. 귀하의 허브에서는 원격 분석이 표시되지만, Time Series Insights에서는 수신된 메시지가 표시되지 않습니다. 키가 다시 생성되었는지 확실하지 않은 경우 Event Hubs의 활동 로그에서 "네임스페이스 권한 부여 규칙 만들기 또는 업데이트"를 검색하거나 IoT Hub에 대해 "IotHub 리소스 만들기 또는 업데이트"를 검색할 수 있습니다.

Time Series Insights Gen2 환경을 새 키로 업데이트하려면 Azure Portal에서 허브 리소스를 열고 새 키를 복사합니다. TSI 리소스로 이동하고 이벤트 소스를 클릭합니다.

수집이 중지된 이벤트 원본을 선택한 후 새 키를 붙여넣고 "저장"을 클릭합니다.

문제: 내 이벤트 원본의 타임스탬프 속성 이름이 작동하지 않음

이름과 값이 다음 규칙을 준수하는지 확인합니다.

• 타임스탬프 속성 이름은 대/소문자를 구분합니다.
• 이벤트 원본에서 JSON 문자열로 제공되는 타임스탬프 속성 값에는 yyyy-MM-ddTHH:mm:ss.FFFFFFFK형식이 있습니다. 이러한 문자열의 예는 "2008-04-12T12:53Z".

타임스탬프 속성 이름이 캡처되고 제대로 작동하는지 확인하는 가장 쉬운 방법은 Time Series Insights Gen2 탐색기를 사용하는 것입니다. Time Series Insights Gen2 탐색기 내에서 타임스탬프 속성 이름을 제공한 후 차트를 사용하여 기간을 선택합니다. 선택 영역을 마우스 오른쪽 단추로 클릭하고 이벤트 탐색 옵션을 선택합니다. 첫 번째 열 머리글은 타임스탬프 속성 이름입니다. Timestamp이 아니라 Timestamp단어 옆에 ($ts)이 있어야 합니다.

• (abc)- Time Series Insights가 데이터 값을 문자열로 읽는 것을 나타냅니다.
• Time Series Insights가 데이터 값을 날짜 및 시간 형식(datetime)으로 읽고 있음을 나타내는 캘린더 아이콘입니다.
• #- Time Series Insights가 데이터 값을 정수로 읽는 것을 나타냅니다.

타임스탬프 속성이 명시적으로 지정되지 않은 경우, 이벤트의 IoT Hub 또는 이벤트 허브에 큐 입력된 시간이 기본 타임스탬프로 사용됩니다.

문제: 탐색기의 웜 스토리지에서 데이터를 볼 수 없습니다.

• 최근에 웜 저장소를 프로비전했고 데이터가 들어오고 있을 수 있습니다.
• 웜 저장소를 삭제했을 가능성이 있으며, 이 경우 데이터가 손실되었을 수 있습니다.

문제: 시계열 모델을 보거나 편집할 수 없습니다.

• Time Series Insights S1 또는 S2 환경에 액세스할 수 있습니다.

  시계열 모델은 종량제 환경에서만 지원됩니다. Time Series Insights Gen2 탐색기에서 S1 또는 S2 환경에 액세스하는 방법에 대한 자세한 정보는 탐색기에서 데이터를 시각화하기를 읽어보세요.

  

• 모델을 보고 편집할 수 있는 권한이 없을 수 있습니다.

  사용자는 시계열 모델을 편집하고 보려면 기여자 수준 액세스 권한이 필요합니다. 현재 액세스 수준을 확인하고 추가 액세스 권한을 부여하려면 Azure Portal에서 Time Series Insights 리소스의 데이터 액세스 정책 섹션으로 이동합니다.

문제: Gen2 탐색기의 모든 인스턴스에 부모가 없음

이 문제는 사용자 환경에 시계열 모델 계층 구조가 정의되지 않은 경우에 발생할 수 있습니다. 자세한 내용은 시계열 모델과 작업하는 방법을 읽어보세요.

다음 단계

• 시계열 모델 작업하는방법에 대해 알아봅니다.

• JSON 셰이프 가로 지원되는 것에 대해 더 알아보세요.

• Azure Time Series Insights Gen2에서 계획 및 제한을 검토하십시오.