다음을 통해 공유


Azure Time Series Insights 환경에 이벤트 허브 이벤트 원본 추가

메모

Time Series Insights 서비스는 2024년 7월 7일에 사용 중지됩니다. 가능한 한 빨리 기존 환경을 대체 솔루션으로 마이그레이션하는 것이 좋습니다. 자세한 내용은 사용 중단 및 마이그레이션에 대한 설명서를 참조하세요

이 문서에서는 Azure Portal을 사용하여 Azure Event Hubs에서 데이터를 읽는 이벤트 원본을 Azure Time Series Insights 환경에 추가하는 방법을 설명합니다.

메모

이 문서에 설명된 단계는 Azure Time Series Insights Gen 1 및 Azure Time Series Insights Gen 2 환경에 모두 적용됩니다.

필수 구성 요소

  • Azure Time Series Insights 환경만들기에 설명된 대로 Azure Time Series Insights 환경을 만듭니다.
  • 이벤트 허브를 만듭니다. Azure Portal사용하여 Event Hubs 네임스페이스 및 이벤트 허브 만들기 읽습니다.
  • 이벤트 허브에는 활성 메시지 이벤트가 전송되어야 합니다. .NET Framework사용하여 Azure Event Hubs에 이벤트 보내기를 방법을 알아봅니다.
  • Azure Time Series Insights 환경에서 사용할 수 있는 이벤트 허브에 전용 소비자 그룹을 만듭니다. 각 Azure Time Series Insights 이벤트 원본에는 다른 소비자와 공유되지 않는 전용 소비자 그룹이 있어야 합니다. 여러 판독기에서 동일한 소비자 그룹의 이벤트를 사용하는 경우 모든 판독기는 실패할 가능성이 높습니다. 이벤트 허브당 20개의 소비자 그룹으로 제한됩니다. 자세한 내용은 Event Hubs 프로그래밍 가이드읽어보세요.

이벤트 허브에 소비자 그룹 추가

애플리케이션은 소비자 그룹을 사용하여 Azure Event Hubs에서 데이터를 가져옵니다. 이벤트 허브에서 데이터를 안정적으로 읽으려면 이 Azure Time Series Insights 환경에서만 사용되는 전용 소비자 그룹을 제공합니다.

이벤트 허브에 새 소비자 그룹을 추가하려면 다음을 수행합니다.

  1. Azure Portal이벤트 허브 네임스페이스의 개요 창에서 이벤트 허브 인스턴스를 찾아 엽니다. 엔터티 > Event Hubs 를 선택하거나 이름아래에서 인스턴스를 찾습니다.

    이벤트 허브 네임스페이스 열기

  2. 이벤트 허브 인스턴스에서 엔터티 > 소비자 그룹를 선택합니다. 그런 다음 + 소비자 그룹 선택하여 새 소비자 그룹을 추가합니다.

    이벤트 허브 - 소비자 그룹 추가

    그렇지 않으면 기존 소비자 그룹을 선택하고 다음 섹션으로 넘어갑니다.

  3. 소비자 그룹 페이지에서 이름의 새 고유 값을 입력합니다. Azure Time Series Insights 환경에서 새 이벤트 원본을 만들 때 이 동일한 이름을 사용합니다.

  4. 선택합니다만들기.

새 이벤트 원본 추가

  1. Azure 포털에 로그인하세요.

  2. 기존 Azure Time Series Insights 환경을 찾습니다. 왼쪽 메뉴에서 모든 리소스을 선택한 다음, Azure Time Series Insights 환경을 선택합니다.

  3. 이벤트 원본을 선택한 다음 추가를 선택합니다.

    이벤트 원본에서 추가 단추를 선택합니다 .

  4. 이 Azure Time Series Insights 환경(예: Contoso-TSI-Gen 1-Event-Hub-ES)에 고유한 이벤트 원본 이름 값을 입력합니다.

  5. 원본을(를) 위해 이벤트 허브을(를) 선택하십시오.

  6. 가져오기 옵션에 대해 적절한 값을 선택하십시오.

    • 구독 중 하나에 기존 이벤트 허브가 있는 경우사용 가능한 구독에서 이벤트 허브 사용 선택합니다. 이 옵션은 가장 쉬운 방법입니다.

      이벤트 원본 가져오기 옵션 선택

    • 다음 표에서는 사용 가능한 구독 옵션에서 Event Hub 사용에 필요한 속성에 대해 설명합니다.

      구독 및 이벤트 허브 세부 정보

      재산 묘사
      구독 원하는 이벤트 허브 인스턴스 및 네임스페이스가 속한 구독입니다.
      Event Hub 네임스페이스 원하는 이벤트 허브 인스턴스가 속한 이벤트 허브 네임스페이스입니다.
      이벤트 허브 이름 원하는 이벤트 허브 인스턴스의 이름입니다.
      이벤트 허브 정책 값 원하는 공유 액세스 정책을 선택합니다. 이벤트 허브 구성 탭에서 공유 액세스 정책을 만들 수 있습니다. 각 공유 액세스 정책에는 이름, 사용자가 설정한 권한 및 액세스 키가 있습니다. 이벤트 원본 대한 공유 액세스 정책에는 읽기 권한이 있어야 합니다.
      이벤트 허브 정책 키 선택한 이벤트 허브 정책 값에서 미리 채워집니다.
    • 이벤트 허브가 구독 외부에 있거나 고급 옵션을 선택하려는 경우 수동으로이벤트 허브 설정 제공을 선택합니다.

      다음 표에서는 수동으로 옵션 제공에 필요한 속성에 대해 설명합니다.

      재산 묘사
      구독 ID 원하는 이벤트 허브 인스턴스 및 네임스페이스가 속한 구독입니다.
      리소스 그룹 원하는 이벤트 허브 인스턴스 및 네임스페이스가 속한 리소스 그룹입니다.
      Event Hub 네임스페이스 원하는 이벤트 허브 인스턴스가 속한 이벤트 허브 네임스페이스입니다.
      이벤트 허브 이름 원하는 이벤트 허브 인스턴스의 이름입니다.
      이벤트 허브 정책 값 원하는 공유 액세스 정책을 선택합니다. 이벤트 허브 구성 탭에서 공유 액세스 정책을 만들 수 있습니다. 각 공유 액세스 정책에는 이름, 사용자가 설정한 권한 및 액세스 키가 있습니다. 이벤트 원본 대한 공유 액세스 정책에는 읽기 권한이 있어야 합니다.
      이벤트 허브 정책 키 Service Bus 네임스페이스에 대한 액세스를 인증하는 데 사용되는 공유 액세스 키입니다. 여기에 기본 또는 보조 키를 입력합니다.
    • 두 옵션 모두 다음 구성 옵션을 공유합니다.

      재산 묘사
      Event Hub 소비자 그룹 이벤트 허브에서 이벤트를 읽는 소비자 그룹입니다. 이벤트 원본에 전용 소비자 그룹을 사용하는 것이 좋습니다.
      이벤트 직렬화 형식 현재 JSON은 사용 가능한 유일한 serialization 형식입니다. 이벤트 메시지는 이 형식이어야 합니다. 그렇지 않으면 데이터를 읽을 수 없습니다.
      타임스탬프 속성 이름 이 값을 확인하려면 이벤트 허브로 전송되는 메시지 데이터의 메시지 형식을 이해해야 합니다. 이 값은 이벤트 타임스탬프로 사용할 메시지 데이터에서 특정 이벤트 속성의 이름입니다. 값은 대/소문자를 구분합니다. 비워 두면 이벤트 소스에서의 큐에 추가된 시간이 이벤트 타임스탬프로 지정됩니다.
  7. 이벤트 허브에 추가한 전용 Azure Time Series Insights 소비자 그룹 이름을 추가합니다.

  8. 선택만들기.

    이벤트 원본을 만든 후 Azure Time Series Insights는 자동으로 사용자 환경으로 데이터를 스트리밍하기 시작합니다.

다음 단계