Tworzenie zasobów usługi Azure Time Series Insights Gen 1 przy użyciu szablonów usługi Azure Resource Manager

Artykuł
06/13/2024

Uwaga

Usługa Time Series Insights zostanie wycofana 7 lipca 2024 r. Rozważ migrację istniejących środowisk do alternatywnych rozwiązań tak szybko, jak to możliwe. Aby uzyskać więcej informacji na temat wycofywania i migracji, odwiedź naszą dokumentację.

Uwaga

Jest to artykuł z generacji 1.

W tym artykule opisano sposób tworzenia i wdrażania zasobów usługi Azure Time Series Insights przy użyciu szablonów usługi Azure Resource Manager, programu PowerShell i dostawcy zasobów usługi Azure Time Series Insights.

Usługa Azure Time Series Insights obsługuje następujące zasoby:

Zasób	opis
Środowisko	Środowisko usługi Azure Time Series Insights to logiczne grupowanie zdarzeń odczytywanych z brokerów zdarzeń, przechowywanych i udostępnianych do wykonywania zapytań. Aby uzyskać więcej informacji, przeczytaj Planowanie środowiska usługi Azure Time Series Insights
Źródło zdarzenia	Źródłem zdarzeń jest połączenie z brokerem zdarzeń, z którego usługa Azure Time Series Insights odczytuje i pozyskuje zdarzenia w środowisku. Obecnie obsługiwane źródła zdarzeń to usługi IoT Hub i Centrum zdarzeń.
Zestaw danych referencyjnych	Zestawy danych referencyjnych zawierają metadane dotyczące zdarzeń w środowisku. Metadane w zestawach danych referencyjnych będą dołączane do zdarzeń podczas ruchu przychodzącego. Zestawy danych referencyjnych są definiowane jako zasoby według ich właściwości klucza zdarzenia. Rzeczywiste metadane tworzące zestaw danych referencyjnych są przekazywane lub modyfikowane za pośrednictwem interfejsów API płaszczyzny danych.
Zasady dostępu	Zasady dostępu udzielają uprawnień do wystawiania zapytań dotyczących danych, manipulowania danymi referencyjnymi w środowisku oraz udostępniania zapisanych zapytań i perspektyw skojarzonych ze środowiskiem. Aby uzyskać więcej informacji, zobacz Udzielanie dostępu do danych do środowiska usługi Azure Time Series Insights przy użyciu witryny Azure Portal

Szablon usługi Resource Manager to plik JSON, który definiuje infrastrukturę i konfigurację zasobów w grupie zasobów. Poniższe dokumenty szczegółowo opisują pliki szablonów:

Szablon szybkiego startu timeseriesinsights-environment-with-eventhub jest publikowany w witrynie GitHub. Ten szablon tworzy środowisko usługi Azure Time Series Insights, podrzędne źródło zdarzeń skonfigurowane do korzystania z zdarzeń z centrum zdarzeń i zasady dostępu, które udzielają dostępu do danych środowiska. Jeśli nie określono istniejącego centrum zdarzeń, zostanie utworzony przy użyciu wdrożenia.

Uwaga

Do interakcji z platformą Azure zalecamy używanie modułu Azure Az w programie PowerShell. Aby rozpocząć, zobacz Instalowanie programu Azure PowerShell. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Określanie szablonu i parametrów wdrożenia

Poniższa procedura opisuje sposób wdrażania szablonu usługi Azure Resource Manager przy użyciu programu PowerShell, który tworzy środowisko usługi Azure Time Series Insights, podrzędne źródło zdarzeń skonfigurowane do korzystania z zdarzeń z centrum zdarzeń oraz zasady dostępu, które udzielają dostępu do danych środowiska. Jeśli nie określono istniejącego centrum zdarzeń, zostanie utworzony przy użyciu wdrożenia.

Zainstaluj program Azure PowerShell, postępując zgodnie z instrukcjami w temacie Wprowadzenie do programu Azure PowerShell.

Sklonuj lub skopiuj szablon timeseriesinsights-environment-with-eventhub z usługi GitHub.

Tworzenie pliku parametrów

Aby utworzyć plik parametrów, skopiuj plik 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"
      }
  }
}

Parametry wymagane

Parametr	Opis
eventHubNamespaceName	Przestrzeń nazw źródłowego centrum zdarzeń.
eventHubName	Nazwa źródłowego centrum zdarzeń.
consumerGroupName	Nazwa grupy odbiorców, która będzie używana przez usługę Azure Time Series Insights do odczytywania danych z centrum zdarzeń. UWAGA: Aby uniknąć rywalizacji o zasoby, ta grupa odbiorców musi być dedykowana usłudze Azure Time Series Insights i nie jest udostępniana innym czytelnikom.
environmentName	Nazwa środowiska. Nazwa nie może zawierać następujących znaków: `<`, `:&%\\>?`, `/`i . Wszystkie inne znaki są dozwolone.
eventSourceName	Nazwa zasobu podrzędnego źródła zdarzeń. Nazwa nie może zawierać następujących znaków: `<`, `:&%\\>?`, `/`i . Wszystkie inne znaki są dozwolone.

Parametry opcjonalne

Parametr	Opis
existingEventHubResourceId	Opcjonalny identyfikator zasobu istniejącego centrum zdarzeń, który będzie połączony ze środowiskiem usługi Azure Time Series Insights za pośrednictwem źródła zdarzeń. UWAGA: Użytkownik wdrażający szablon musi mieć uprawnienia do wykonania operacji listkeys w centrum zdarzeń. Jeśli żadna wartość nie zostanie przekazana, zostanie utworzone nowe centrum zdarzeń za pomocą szablonu.
environmentDisplayName	Opcjonalna przyjazna nazwa wyświetlana w narzędziach lub interfejsach użytkownika zamiast nazwy środowiska.
environmentSkuName	Nazwa jednostki SKU. Aby uzyskać więcej informacji, przeczytaj stronę Cennik usługi Azure Time Series Insights.
environmentSkuCapacity	Pojemność jednostkowa jednostki SKU. Aby uzyskać więcej informacji, przeczytaj stronę Cennik usługi Azure Time Series Insights.
environmentDataRetentionTime	Minimalny przedział czasu dla zdarzeń środowiska będzie dostępny dla zapytania. Wartość musi być określona w formacie ISO 8601, na przykład `P30D` dla zasad przechowywania 30 dni.
eventSourceDisplayName	Opcjonalna przyjazna nazwa wyświetlana w narzędziach lub interfejsach użytkownika zamiast nazwy źródła zdarzeń.
eventSourceTimestampPropertyName	Właściwość zdarzenia, która będzie używana jako sygnatura czasowa źródła zdarzeń. Jeśli wartość nie jest określona dla atrybutu timestampPropertyName lub jeśli określono wartość null lub ciąg pusty, zostanie użyty czas tworzenia zdarzenia.
eventSourceKeyName	Nazwa klucza dostępu współdzielonego, który będzie używany przez usługę Azure Time Series Insights do nawiązywania połączenia z centrum zdarzeń.
accessPolicyReaderObjectIds	Lista identyfikatorów obiektów użytkowników lub aplikacji w identyfikatorze Entra firmy Microsoft, które powinny mieć dostęp czytelnika do środowiska. Identyfikator objectId jednostki usługi można uzyskać przez wywołanie polecenia cmdlet Get-AzADUser lub Get-AzADServicePrincipal . Tworzenie zasad dostępu dla grup entra firmy Microsoft nie jest jeszcze obsługiwane.
accessPolicyContributorObjectIds	Lista identyfikatorów obiektów użytkowników lub aplikacji w identyfikatorze Entra firmy Microsoft, które powinny mieć dostęp współautora do środowiska. Identyfikator objectId jednostki usługi można uzyskać przez wywołanie polecenia cmdlet Get-AzADUser lub Get-AzADServicePrincipal . Tworzenie zasad dostępu dla grup entra firmy Microsoft nie jest jeszcze obsługiwane.

Na przykład poniższy plik parametrów będzie używany do tworzenia środowiska i źródła zdarzeń, które odczytuje zdarzenia z istniejącego centrum zdarzeń. Tworzy również dwie zasady dostępu, które przyznają współautorowi dostęp do środowiska.

{
    "$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"
            ]
        }
    }
}

Aby uzyskać więcej informacji, przeczytaj artykuł Parameters (Parametry ).

Lokalne wdrażanie szablonu szybkiego startu przy użyciu programu PowerShell

Ważne

Poniższe operacje wiersza polecenia opisują moduł Az programu PowerShell.

W programie PowerShell zaloguj się do konta platformy Azure.
- W wierszu polecenia programu PowerShell uruchom następujące polecenie:
```
Connect-AzAccount
```
- Zostanie wyświetlony monit o zalogowanie się do konta platformy Azure. Po zalogowaniu uruchom następujące polecenie, aby wyświetlić dostępne subskrypcje:
```
Get-AzSubscription
```
- To polecenie zwraca listę dostępnych subskrypcji platformy Azure. Wybierz subskrypcję dla bieżącej sesji, uruchamiając następujące polecenie. Zastąp <YourSubscriptionId> ciąg identyfikatorem GUID subskrypcji platformy Azure, której chcesz użyć:
```
Set-AzContext -SubscriptionID <YourSubscriptionId>
```
Utwórz nową grupę zasobów, jeśli nie istnieje.
- Jeśli nie masz istniejącej grupy zasobów, utwórz nową grupę zasobów za pomocą polecenia New-AzResourceGroup . Podaj nazwę grupy zasobów i lokalizacji, której chcesz użyć. Na przykład:
```
New-AzResourceGroup -Name MyDemoRG -Location "West US"
```
- W przypadku powodzenia zostanie wyświetlone podsumowanie nowej grupy zasobów.
```
ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
```
Przetestuj wdrożenie.
- Zweryfikuj Test-AzResourceGroupDeployment wdrożenie, uruchamiając polecenie cmdlet . Podczas testowania wdrożenia podaj parametry dokładnie tak, jak podczas wykonywania wdrożenia.
```
Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
Tworzenie wdrożenia
- Aby utworzyć nowe wdrożenie, uruchom New-AzResourceGroupDeployment polecenie cmdlet i po wyświetleniu monitu podaj niezbędne parametry. Parametry zawierają nazwę wdrożenia, nazwę grupy zasobów oraz ścieżkę lub adres URL do pliku szablonu. Jeśli parametr Mode nie zostanie określony, zostanie użyta wartość domyślna incremental. Aby uzyskać więcej informacji, przeczytaj Incremental and complete deployments (Wdrożenia przyrostowe i kompletne).
- Następujące polecenie wyświetla monit o pięć wymaganych parametrów w oknie programu PowerShell:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```
- Aby zamiast tego określić plik parametrów, użyj następującego polecenia:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
- Możesz również użyć wbudowanych parametrów podczas uruchamiania polecenia cmdlet wdrażania. Polecenie to wygląda następująco:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
```
- Aby uruchomić pełne wdrożenie, ustaw parametr Mode na Ukończono:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```

Weryfikowanie wdrożenia

Jeśli zasoby zostaną pomyślnie wdrożone, w oknie programu PowerShell zostanie wyświetlone podsumowanie wdrożenia:

 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 :

Wdrażanie szablonu szybkiego startu w witrynie Azure Portal
- Strona główna szablonu szybkiego startu w usłudze GitHub zawiera również przycisk Wdróż na platformie Azure . Kliknięcie go powoduje otwarcie strony Wdrożenie niestandardowe w witrynie Azure Portal. Na tej stronie można wprowadzić lub wybrać wartości dla każdego z parametrów z wymaganych parametrów lub opcjonalnych tabel parametrów . Po wypełnieniu ustawień kliknij przycisk Kup zainicjuje wdrożenie szablonu.

Następne kroki

Aby uzyskać informacje na temat programowego zarządzania zasobami usługi Azure Time Series Insights przy użyciu interfejsów API REST, przeczytaj Artykuł Zarządzanie usługą Azure Time Series Insights.

Udostępnij za pośrednictwem

Tworzenie zasobów usługi Azure Time Series Insights Gen 1 przy użyciu szablonów usługi Azure Resource Manager

Określanie szablonu i parametrów wdrożenia

Lokalne wdrażanie szablonu szybkiego startu przy użyciu programu PowerShell

Następne kroki

Opinia

Opinia

Dodatkowe zasoby