Azure Time Series Insights Gen2 이벤트 원본
참고
TSI(Time Series Insights) 서비스는 2025년 3월 이후에 더 이상 지원되지 않습니다. 가능한 한 빨리 기존 TSI 환경을 대체 솔루션으로 마이그레이션하는 것을 고려합니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 설명서를 참조하세요.
Azure Time Series Insights Gen2 환경에는 최대 두 개의 스트리밍 이벤트 원본이 있을 수 있습니다. 입력으로 지원되는 두 가지 유형의 Azure 리소스는 다음과 같습니다.
이벤트는 UTF-8로 인코딩된 JSON으로 전송되어야 합니다.
이벤트 원본 만들기 또는 편집
이벤트 원본은 허브와 Azure Time Series Insights Gen2 환경 사이의 연결이며, Time Series Insights event source 형식의 별도 리소스가 리소스 그룹에 생성됩니다. IoT Hub 또는 Event Hub 리소스는 Azure Time Series Insights Gen2 환경 또는 다른 구독과 동일한 Azure 구독에 존재할 수 있습니다. 그러나 Azure Time Series Insights 환경과 IoT Hub 또는 Event Hub를 동일한 Azure 지역 내에 보관하는 것이 가장 좋습니다.
Azure Portal, Azure CLI, Azure Resource Manager 템플릿 및 REST API를 사용하여 환경의 이벤트 원본을 생성, 편집 또는 제거할 수 있습니다.
경고
Time Series Insights에서 사용하는 허브 또는 이벤트 원본에 대한 공용 인터넷 액세스를 제한하지 마세요. 그렇지 않으면 필요한 연결이 끊어집니다.
시작 옵션
이벤트 원본을 만들 때 수집해야 하는 기존 데이터를 지정할 수 있습니다. 이 설정은 선택 사항입니다. 다음 옵션을 사용할 수 있습니다.
| Name | Description | Azure Resource Manager 템플릿 예제 |
|---|---|---|
| EarliestAvailable | IoT 또는 Event Hub 내에 저장된 모든 기존 데이터 수집 | "ingressStartAt": {"type": "EarliestAvailable"} |
| EventSourceCreationTime | 이벤트 원본이 생성된 후 도착하는 데이터 수집을 시작합니다. 이벤트 원본을 만들기 전에 스트리밍된 기존 데이터는 무시됩니다. 이는 Azure Portal의 기본 설정입니다. | "ingressStartAt": {"type": "EventSourceCreationTime"} |
| CustomEnqueuedTime | 사용자 환경에서는 사용자 지정 큐에 넣은 시간(UTC)에서 데이터를 수집합니다. 사용자 지정 큐에 넣은 시간 또는 이후에 IoT 또는 Event Hub로 큐에 넣은 모든 이벤트는 수집되고 저장됩니다. 사용자 지정 큐에 넣은 시간 이전에 도착한 모든 이벤트는 무시됩니다. "큐에 넣은 시간"은 이벤트가 IoT 또는 Event Hub에 도착한 시간(UTC)을 나타냅니다. 이는 이벤트 본문 내에 있는 사용자 지정 타임스탬프 속성과 다릅니다. | "ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"} |
중요
- EarliestAvailable을 선택하고 기존 데이터가 많은 경우 Azure Time Series Insights Gen2 환경에서 모든 데이터를 처리할 때 초기 대기 시간이 길어질 수 있습니다.
- 이러한 높은 대기 시간은 궁극적으로 데이터가 인덱싱되면서 줄어들어야 합니다. 대기 시간이 계속 긴 경우 Azure Portal을 통해 지원 티켓을 제출하세요.
- EarliestAvailable
- EventSourceCreationTime
- CustomEnqueuedTime
스트리밍 수집 모범 사례
항상 Azure Time Series Insights Gen2 환경을 위한 고유한 소비자 그룹을 만들어 이벤트 원본의 데이터를 사용합니다. 소비자 그룹을 다시 사용하면 임의 연결이 끊길 수 있으며 데이터가 손실될 수 있습니다.
동일한 Azure 지역에서 Azure Time Series Insights Gen2 환경과 IoT Hub 및/또는 Event Hubs를 구성합니다. 별도의 지역에 이벤트 원본을 구성할 수는 있지만 이 시나리오는 지원되지 않으며 고가용성을 보장할 수 없습니다.
사용자 환경의 처리량 속도 제한 또는 파티션당 제한을 초과하지 마세요.
환경에서 데이터를 처리하는 데 문제가 발생하는 경우 알림을 받도록 지연 경고를 구성합니다. 제안된 경고 조건은 아래의 프로덕션 워크로드를 참조하세요.
거의 실시간 및 최근 데이터에만 스트리밍 수집을 사용합니다. 기록 데이터 스트리밍은 지원되지 않습니다.
속성을 이스케이프하고 JSON 데이터를 평면화하고 저장하는 방법을 이해합니다.
이벤트 원본 연결 문자열을 제공할 때 최소 권한의 원칙을 따릅니다. Event Hubs의 경우 보내기 클레임만 사용하여 공유 액세스 정책을 구성하고, IoT Hub에 대해서는 서비스 연결 권한만 사용합니다.
주의
IoT Hub 또는 Event Hub를 삭제하고 같은 이름으로 새 리소스를 다시 만드는 경우 새 이벤트 원본을 만들고 새 IoT Hub 또는 Event Hub에 연결해야 합니다. 데이터는 이 단계를 완료할 때까지 수집되지 않습니다.
프로덕션 워크로드
위의 모범 사례 외에도 중요 비지니스용 워크로드를 위해 다음을 구현하는 것이 좋습니다.
IoT Hub 또는 Event Hub 데이터 보존 시간을 최대 7일로 늘립니다.
Azure Portal에서 환경 경고를 만듭니다. 플랫폼 메트릭을 기반으로 하는 경고를 통해 엔드투엔드 파이프라인 동작의 유효성을 검사할 수 있습니다. 경고를 만들고 관리하기 위한 지침은 여기에 있습니다. 제안된 경고 조건:
- IngressReceivedMessagesTimeLag가 5분보다 큼
- IngressReceivedBytes는 0입니다.
IoT Hub 또는 Event Hub 파티션 간에 수집 부하 분산을 유지합니다.
기록 데이터 수집
스트리밍 파이프라인을 사용하여 기록 데이터를 가져오는 것은 현재 Azure Time Series Insights Gen2에서 지원되지 않습니다. 이전 데이터를 사용자 환경으로 가져와야 하는 경우 아래 지침을 따릅니다.
- 라이브 데이터와 기록 데이터를 동시에 스트림하지 않습니다. 순서가 잘못된 데이터를 수집하면 쿼리 성능이 저하됩니다.
- 최상의 성능을 위해 기록 데이터를 지정된 시간 순서대로 수집합니다.
- 아래의 수집 처리량 속도 제한 내에서 유지합니다.
- 데이터가 웜 저장소 보존 기간보다 오래된 경우 웜 저장소를 사용하지 않도록 설정합니다.
이벤트 원본 타임스탬프
이벤트 원본을 구성할 때 타임스탬프 ID 속성을 제공하라는 메시지가 표시됩니다. 타임스탬프 속성은 시간이 지남에 따라 이벤트를 추적하는 데 사용됩니다. 이 시간은 Query API에서 $ts 타임스탬프로 사용되고 Azure Time Series Insights 탐색기에서 그리기 시리즈에 사용됩니다. 만든 시간에 속성이 제공되지 않거나 타임스탬프 속성이 이벤트에 없는 경우 이벤트의 IoT Hub 또는 Events Hubs 큐에 넣은 시간이 기본값으로 사용됩니다. 타임스탬프 속성 값은 UTC로 저장됩니다.
일반적으로 사용자는 타임스탬프 속성을 사용자 지정하도록 선택하고, 센서 또는 태그가 기본 허브 큐에 넣은 시간을 사용하는 대신 읽기를 생성한 시간을 사용합니다. 이는 디바이스에 일시적 연결 손실이 발생하고 지연된 메시지의 일괄 처리가 Azure Time Series Insights Gen2에 전달되는 경우에 특히 필요합니다.
사용자 지정 타임스탬프가 중첩된 JSON 개체 또는 배열 내에 있는 경우 평면화 및 이스케이프 명명 규칙에 따라 올바른 속성 이름을 제공해야 합니다. 예를 들어 여기에 표시된 JSON 페이로드의 이벤트 원본 타임스탬프는 "values.time"으로 입력해야 합니다.
표준 시간대 오프셋
타임스탬프는 ISO 8601 형식으로 전송해야 하며 UTC로 저장됩니다. 표준 시간대 오프셋이 제공되는 경우에는 오프셋이 적용된 다음, 시간을 UTC 형식으로 저장하고 반환합니다. 오프셋의 형식이 잘못된 경우 무시됩니다. 솔루션에 원래 오프셋의 컨텍스트가 없는 경우 별도의 추가 이벤트 속성으로 오프셋 데이터를 전송하여 유지되고 애플리케이션이 쿼리 응답에서 참조할 수 있는지 확인할 수 있습니다.
표준 시간대 오프셋은 다음 중 하나로 포맷되어야 합니다.
±HHMMZ
±HH:MM
±HH:MMZ
다음 단계
이벤트를 저장하는 방법을 알아보려면 JSON 평면화 및 이스케이프 규칙을 참조하세요.
사용자 환경의 처리량 제한 사항 이해