Azure Resource Manager 템플릿을 사용하여 Azure Time Series Insights Gen 1 리소스 만들기

아티클
09/30/2020

메모

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

주의

Gen1 문서입니다.

이 문서에서는 Azure Resource Manager 템플릿, PowerShell 및 Azure Time Series Insights 리소스 공급자를 사용하여 Azure Time Series Insights 리소스를 만들고 배포하는 방법을 설명합니다.

Azure Time Series Insights는 다음 리소스를 지원합니다.

자원	설명
환경	Azure Time Series Insights 환경은 이벤트 브로커에서 읽고, 저장하고, 쿼리에 사용할 수 있는 이벤트의 논리적 그룹화입니다. 자세한 내용은 Azure Time Series Insights 환경을 계획하는 방법에 대해 읽어보시고, 참조하세요.
이벤트 원본	Azure Time Series Insights가 이벤트를 읽고 환경에 수집할 수 있게 해주는 이벤트 브로커와의 연결이 바로 이벤트 원본입니다. 현재 지원되는 이벤트 원본은 IoT Hub 및 Event Hub입니다.
참조 데이터 집합	참조 데이터 집합은 환경의 이벤트에 대한 메타데이터를 제공합니다. 참조 데이터 집합의 메타데이터는 데이터 수신 시 이벤트와 조인됩니다. 참조 데이터 집합은 이벤트 키 속성에 의해 리소스로 정의됩니다. 참조 데이터 집합을 구성하는 실제 메타데이터는 데이터 평면 API를 통해 업로드되거나 수정됩니다.
액세스 정책	액세스 정책은 데이터 쿼리를 실행하고, 환경에서 참조 데이터를 조작하고, 환경과 연결된 저장된 쿼리 및 큐브 뷰를 공유할 수 있는 권한을 부여합니다. 자세한 내용은 Azure Portal을 사용하여 Azure Time Series Insights 환경에 데이터 액세스 권한을 부여하려면 을 참조하세요.

Resource Manager 템플릿은 리소스 그룹의 리소스 인프라 및 구성을 정의하는 JSON 파일입니다. 다음 문서에서는 템플릿 파일에 대해 자세히 설명합니다.

Azure Resource Manager 템플릿 배포
Resource Manager 템플릿 및 Azure PowerShell 사용하여 리소스 배포
Microsoft.TimeSeriesInsights 리소스 종류

timeseriesinsights-environment-with-eventhub 빠른 시작 템플릿은 GitHub에 게시되었습니다. 이 템플릿은 Azure Time Series Insights 환경, 이벤트 허브의 이벤트를 사용하도록 구성된 자식 이벤트 원본 및 환경의 데이터에 대한 액세스 권한을 부여하는 액세스 정책을 만듭니다. 기존 이벤트 허브를 지정하지 않으면 배포 시 새로 생성됩니다.

메모

Azure Az PowerShell 모듈을 사용하여 Azure와 상호 작용하는 것이 좋습니다. 시작하려면 Azure PowerShell 설치을 참조하세요. Az PowerShell 모듈로 마이그레이션하는 방법을 알아보려면 Azure PowerShell을 AzureRM에서 Az로 마이그레이션 를 참조하세요.

배포 템플릿 및 매개 변수 지정

다음 절차에서는 PowerShell을 사용하여 Azure Time Series Insights 환경, 이벤트 허브의 이벤트를 사용하도록 구성된 자식 이벤트 원본 및 환경 데이터에 대한 액세스 권한을 부여하는 액세스 정책을 만드는 Azure Resource Manager 템플릿을 배포하는 방법을 설명합니다. 기존 이벤트 허브가 지정되지 않은 경우, 배포 시 새로운 이벤트 허브가 생성됩니다.

Azure PowerShell을 설치하려면 Azure PowerShell 시작하기지침에 따르세요.

GitHub에서 timeseriesinsights-environment-with-eventhub 템플릿을 복제하거나 복사합니다.

매개 변수 파일 만들기

매개 변수 파일을 만들려면 timeseriesinsights-environment-with-eventhub 파일을 복사합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
      "eventHubNamespaceName": {
          "value": "GEN-UNIQUE"
      },
      "eventHubName": {
          "value": "GEN-UNIQUE"
      },
      "consumerGroupName": {
          "value": "GEN-UNIQUE"
      },
      "environmentName": {
        "value": "GEN-UNIQUE"
      },
      "eventSourceName": {
        "value": "GEN-UNIQUE"
      }
  }
}

필수 매개 변수

매개 변수	묘사
eventHubNamespaceName (이벤트 허브 네임스페이스 이름)	원본 이벤트 허브의 네임스페이스입니다.
이벤트 허브 이름	원본 이벤트 허브의 이름입니다.
소비자 그룹 이름	Azure Time Series Insights 서비스에서 이벤트 허브에서 데이터를 읽는 데 사용할 소비자 그룹의 이름입니다. 참고: 리소스 경합을 방지하려면 이 소비자 그룹이 Azure Time Series Insights 서비스에 전용이어야 하며 다른 판독기와 공유되지 않아야 합니다.
환경이름	환경의 이름입니다. 이름에는 `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`및 컨트롤 문자가 포함될 수 없습니다. 다른 모든 문자는 허용됩니다.
이벤트소스이름	이벤트 원본 자식 리소스의 이름입니다. 이름에는 `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`및 컨트롤 문자가 포함될 수 없습니다. 다른 모든 문자는 허용됩니다.

선택적 매개 변수

매개 변수	묘사
기존EventHub자원ID	이벤트 원본을 통해 Azure Time Series Insights 환경에 연결될 기존 이벤트 허브의 선택적 리소스 ID입니다. 참고: 템플릿을 배포하는 사용자에게는 Event Hub에서 listkeys 작업을 수행할 수 있는 권한이 있어야 합니다. 값이 전달되지 않으면 템플릿에서 새 이벤트 허브가 만들어집니다.
환경표시이름	환경 이름 대신 툴이나 사용자 인터페이스에 표시할 수 있는 선택적 친근한 이름입니다.
environmentSkuName	sku의 이름입니다. 자세한 내용은 Azure Time Series Insights 가격 책정 페이지참조하세요.
환경SKU용량	Sku의 단위 용량입니다. 자세한 내용은 Azure Time Series Insights 가격 책정 페이지참조하세요.
환경 데이터 보존 시간	환경의 이벤트를 쿼리에 사용할 수 있는 최소 시간 범위입니다. 값은 ISO 8601 형식으로 지정해야 합니다( 예: 30일 보존 정책에 대한 `P30D`).
이벤트 소스 표시 이름	이벤트 원본 이름 대신 도구나 사용자 인터페이스에 표시할 수 있는 선택적 친화적인 이름입니다.
이벤트 소스 타임스탬프 속성 이름 (eventSourceTimestampPropertyName)	이벤트 원본의 타임스탬프로 사용할 이벤트 속성입니다. timestampPropertyName에 값을 지정하지 않았거나 null 또는 빈 문자열을 지정한 경우 이벤트 생성 시간이 사용됩니다.
이벤트소스키이름	Azure Time Series Insights 서비스에서 이벤트 허브에 연결하는 데 사용할 공유 액세스 키의 이름입니다.
접근 정책 읽기 객체 ID	환경에 대한 읽기 권한이 있어야 하는 Microsoft Entra ID의 사용자 또는 애플리케이션 개체 ID 목록입니다. 서비스 주체 objectId는 Get-AzADUser 또는 Get-AzADServicePrincipal cmdlet을 호출하여 가져올 수 있습니다. Microsoft Entra 그룹에 대한 액세스 정책 만들기는 아직 지원되지 않습니다.
액세스 정책 기여자 객체 ID	환경에 대한 기여자 액세스 권한이 있어야 하는 Microsoft Entra ID의 사용자 또는 애플리케이션 개체 ID 목록입니다. 서비스 주체 objectId는 Get-AzADUser 또는 Get-AzADServicePrincipal cmdlet을 호출하여 가져올 수 있습니다. Microsoft Entra 그룹에 대한 액세스 정책 만들기는 아직 지원되지 않습니다.

예를 들어 다음 매개 변수 파일을 사용하여 기존 이벤트 허브에서 이벤트를 읽는 환경 및 이벤트 원본을 만듭니다. 또한 참가자에게 환경에 대한 액세스 권한을 부여하는 두 가지 액세스 정책을 만듭니다.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "eventHubNamespaceName": {
            "value": "tsiTemplateTestNamespace"
        },
        "eventHubName": {
            "value": "tsiTemplateTestEventHub"
        },
        "consumerGroupName": {
            "value": "tsiTemplateTestConsumerGroup"
        },
        "environmentName": {
            "value": "tsiTemplateTestEnvironment"
        },
        "eventSourceName": {
            "value": "tsiTemplateTestEventSource"
        },
        "existingEventHubResourceId": {
            "value": "/subscriptions/{yourSubscription}/resourceGroups/MyDemoRG/providers/Microsoft.EventHub/namespaces/tsiTemplateTestNamespace/eventhubs/tsiTemplateTestEventHub"
        },
        "accessPolicyContributorObjectIds": {
            "value": [
                "AGUID001-0000-0000-0000-000000000000",
                "AGUID002-0000-0000-0000-000000000000"
            ]
        }
    }
}

자세한 내용은 매개 변수 문서를 참조하세요.

PowerShell을 사용하여 로컬로 빠른 시작 템플릿 배포

중요하다

아래에 표시된 명령줄 작업은 Az PowerShell 모듈을 설명합니다.

PowerShell에서 Azure 계정에 로그인합니다.
- PowerShell 프롬프트에서 다음 명령을 실행합니다.
```
Connect-AzAccount
```
- Azure 계정에 로그온하라는 메시지가 표시됩니다. 로그온한 후 다음 명령을 실행하여 사용 가능한 구독을 확인합니다.
```
Get-AzSubscription
```
- 이 명령은 사용 가능한 Azure 구독 목록을 반환합니다. 다음 명령을 실행하여 현재 세션에 대한 구독을 선택합니다. Azure 구독으로 사용하려는 GUID로 <YourSubscriptionId>을(를) 바꾸세요.
```
Set-AzContext -SubscriptionID <YourSubscriptionId>
```
리소스 그룹이 존재하지 않으면 새로 생성하세요.
- 기존 리소스 그룹이 없는 경우 New-AzResourceGroup 명령을 사용하여 새 리소스 그룹을 만듭니다. 사용할 리소스 그룹의 이름과 위치를 제공합니다. 예를 들어:
```
New-AzResourceGroup -Name MyDemoRG -Location "West US"
```
- 성공하면 새 리소스 그룹의 요약이 표시됩니다.
```
ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
```
배포를 테스트합니다.
- Test-AzResourceGroupDeployment cmdlet을 실행하여 배포의 유효성을 검사합니다. 배포를 테스트할 때 배포를 실행할 때와 똑같은 매개 변수를 제공합니다.
```
Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
배포 생성
- 새 배포를 만들려면 New-AzResourceGroupDeployment cmdlet을 실행하고, 메시지가 표시되면 필요한 매개변수를 입력하세요. 매개 변수에는 배포 이름, 리소스 그룹의 이름, 템플릿 파일의 경로 또는 URL이 포함됩니다. Mode 매개 변수를 지정하지 않으면 증분이 기본값으로 사용됩니다. 자세한 내용은 증분 및 전체 배포을 읽어보시기 바랍니다.
- 다음 명령은 PowerShell 창에서 5개의 필수 매개 변수를 묻는 메시지를 표시합니다.
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```
- 대신 매개 변수 파일을 지정하려면 다음 명령을 사용합니다.
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
- 배포 cmdlet을 실행할 때 인라인 매개 변수를 사용할 수도 있습니다. 명령은 다음과 같습니다.
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
```
- 전체 배포를 실행하려면 Mode 매개 변수를 Complete로 설정합니다.
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```

배포 확인

리소스가 성공적으로 배포되면 PowerShell 창에 배포 요약이 표시됩니다.

 DeploymentName          : MyDemoDeployment
 ResourceGroupName       : MyDemoRG
 ProvisioningState       : Succeeded
 Timestamp               : 10/11/2019 3:20:37 AM
 Mode                    : Incremental
 TemplateLink            :
 Parameters              :
                           Name                                Type                       Value
                           ==================================  =========================  ==========
                           eventHubNewOrExisting               String                     new
                           eventHubResourceGroup               String                     MyDemoRG
                           eventHubNamespaceName               String                     tsiquickstartns
                           eventHubName                        String                     tsiquickstarteh
                           consumerGroupName                   String                     tsiquickstart
                           environmentName                     String                     tsiquickstart
                           environmentDisplayName              String                     tsiquickstart
                           environmentSkuName                  String                     S1
                           environmentSkuCapacity              Int                        1
                           environmentDataRetentionTime        String                     P30D
                           eventSourceName                     String                     tsiquickstart
                           eventSourceDisplayName              String                     tsiquickstart
                           eventSourceTimestampPropertyName    String
                           eventSourceKeyName                  String                     manage
                           accessPolicyReaderObjectIds         Array                      []
                           accessPolicyContributorObjectIds    Array                      []
                           location                            String                     westus

 Outputs                 :
                            Name              Type                       Value
                            ================  =========================  ==========
                            dataAccessFQDN    String
                            11aa1aa1-a1aa-1a1a-a11a-aa111a111a11.env.timeseries.azure.com

 DeploymentDebugLogLevel :

Azure Portal을 통해 빠른 시작 템플릿 배포
- GitHub의 퀵스타트 템플릿 홈 페이지에는 Azure에 배포 단추도 포함되어 있습니다. 클릭하면 Azure Portal에서 사용자 지정 배포 페이지가 열립니다. 이 페이지에서 필수 매개 변수에서 각 매개 변수의 값을 입력하거나 선택하거나 선택적 매개 변수 수 있습니다. 설정을 입력한 후 구매 단추를 클릭하면 템플릿 배포가 시작됩니다.

Azure에 배포 단추

다음 단계

REST API를 사용하여 Azure Time Series Insights 리소스를 프로그래밍 방식으로 관리하는 방법에 대한 자세한 내용은 Azure Time Series Insights 관리참조하세요.

다음을 통해 공유

Azure Resource Manager 템플릿을 사용하여 Azure Time Series Insights Gen 1 리소스 만들기

배포 템플릿 및 매개 변수 지정

PowerShell을 사용하여 로컬로 빠른 시작 템플릿 배포

다음 단계

추가 리소스