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

  • 아티클

참고

TSI(Time Series Insights) 서비스는 2025년 3월 이후에 더 이상 지원되지 않습니다. 가능한 한 빨리 기존 TSI 환경을 대체 솔루션으로 마이그레이션하는 것을 고려합니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 설명서를 참조하세요.

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

참고

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

필수 구성 요소

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

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

이벤트 허브에 새 소비자 그룹을 추가하려면

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

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

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

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

    추가하지 않으면, 기존 소비자 그룹을 선택하고 다음 섹션으로 건너뜁니다.

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

  4. 만들기를 선택합니다.

새 이벤트 원본 추가

  1. Azure Portal에 로그인합니다.

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

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

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

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

  5. 원본에서 이벤트 허브를 선택합니다.

  6. 가져오기 옵션에서 적합한 값을 선택합니다.

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

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

    • 다음 표에서는 사용 가능한 구독의 이벤트 허브 사용 옵션에 필요한 속성을 설명합니다.

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

      속성 Description
      Subscription 원하는 이벤트 허브 인스턴스 및 네임스페이스가 속한 구독입니다.
      이벤트 허브 네임스페이스 원하는 이벤트 허브 인스턴스가 속한 이벤트 허브 네임스페이스입니다.
      이벤트 허브 이름 원하는 이벤트 허브 인스턴스의 이름입니다.
      이벤트 허브 정책 값 원하는 공유 액세스 정책을 선택합니다. 이벤트 허브의 구성 탭에서 공유 액세스 정책을 만들 수 있습니다. 각 공유 액세스 정책에는 이름, 사용자가 설정한 사용 권한 및 액세스 키가 있습니다. 이벤트 원본에 대한 공유 액세스 정책에는 읽기 사용 권한이 반드시 있어야 합니다.
      이벤트 허브 정책 키 선택한 이벤트 허브 정책 값으로 미리 채워집니다.

    • 이벤트 허브가 구독 외부에 있거나 고급 옵션을 선택하려는 경우 수동으로 이벤트 허브 설정 제공을 선택합니다.

      다음 표에서는 수동으로 이벤트 허브 설정 제공 옵션에 필요한 속성을 설명합니다.

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

    • 두 옵션은 다음 구성 옵션을 공유합니다.

      속성 설명
      이벤트 허브 소비자 그룹 이벤트 허브에서 이벤트를 읽는 소비자 그룹입니다. 이벤트 원본에 대한 전용 소비자 그룹을 사용하는 것이 좋습니다.
      이벤트 직렬화 형식 현재, JSON이 사용 가능한 유일한 직렬화 형식입니다. 이벤트 메시지는 해당 형식을 따라야 하며 그렇지 않으면 데이터를 읽을 수 없습니다.
      타임스탬프 속성 이름 이 값을 확인하려면 이벤트 허브로 전송되는 메시지 데이터의 메시지 형식을 이해해야 합니다. 이 값은 이벤트 타임스탬프로 사용하려는 메시지 데이터에 있는 특정 이벤트 속성의 이름입니다. 이 값은 대/소문자를 구분합니다. 이 값을 비워 두면 이벤트 원본의 이벤트를 큐에 넣는 시간이 이벤트 타임스탬프로 사용됩니다.

  7. 이벤트 허브에 추가한 전용 Azure Time Series Insights 소비자 그룹 이름을 추가합니다.

  8. 만들기를 선택합니다.

    이벤트 원본이 생성되면 Azure Time Series Insights가 내 환경에 자동으로 데이터를 스트리밍하기 시작합니다.

다음 단계