Vytváření prostředků Azure Time Series Insights Gen1 pomocí šablon Azure Resource Manageru

Tento článek popisuje, jak vytvářet a nasazovat prostředky Azure Time Series Insights pomocí šablon Azure Resource Manageru, PowerShellu a poskytovatele prostředků Azure Time Series Insights.

Azure Time Series Insights podporuje následující prostředky:

Šablona Resource Manageru je soubor JSON, který definuje infrastrukturu a konfiguraci prostředků ve skupině prostředků. Následující dokumenty popisují soubory šablon podrobněji:

• Nasazení šablony Azure Resource Manageru
• Nasazení prostředků pomocí šablon Resource Manageru a Azure PowerShellu
• Typy prostředků Microsoft.TimeSeriesInsights

Šablona rychlého startu timeseriesinsights-environment-with-eventhub je publikovaná na GitHubu. Tato šablona vytvoří prostředí Azure Time Series Insights, podřízený zdroj událostí nakonfigurovaný pro využívání událostí z centra událostí a zásady přístupu, které udělují přístup k datům prostředí. Pokud není zadané existující centrum událostí, vytvoří se s nasazením.

Zadání šablony a parametrů nasazení

Následující postup popisuje, jak pomocí PowerShellu nasadit šablonu Azure Resource Manageru, která vytvoří prostředí Azure Time Series Insights, podřízený zdroj událostí nakonfigurovaný tak, aby využíval události z centra událostí, a zásady přístupu, které udělují přístup k datům prostředí. Pokud není zadané existující centrum událostí, vytvoří se s nasazením.

1. Podle pokynů v tématu Začínáme s Azure PowerShellem nainstalujte Azure PowerShell.

2. Naklonujte nebo zkopírujte šablonu timeseriesinsights-environment-with-eventhub z GitHubu.

   • Vytvoření souboru parametrů

     Pokud chcete vytvořit soubor parametrů, zkopírujte soubor 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"
           }
       }
     }
     

   • Povinné parametry

     Parametr	Popis
     eventHubNamespaceName	Obor názvů zdrojového centra událostí.
     eventHubName	Název zdrojového centra událostí.
     consumerGroupName	Název skupiny příjemců, kterou bude služba Azure Time Series Insights používat ke čtení dat z centra událostí. POZNÁMKA: Aby se zabránilo kolizí prostředků, musí být tato skupina příjemců vyhrazená pro službu Azure Time Series Insights a nesdílená s ostatními čtenáři.
     environmentName	Název prostředí. Název nesmí obsahovat: <, >, %\\?&:, , /a žádné řídicí znaky. Všechny ostatní znaky jsou povolené.
     eventSourceName	Název podřízeného prostředku zdroje události. Název nesmí obsahovat: <, >, %\\?&:, , /a žádné řídicí znaky. Všechny ostatní znaky jsou povolené.

   • Volitelné parametry

     Parametr	Popis
     existingEventHubResourceId	Volitelné ID prostředku existujícího centra událostí, které bude připojené k prostředí Azure Time Series Insights prostřednictvím zdroje událostí. POZNÁMKA: Uživatel, který šablonu nasazuje, musí mít oprávnění k provedení operace listkeys v centru událostí. Pokud se nepředá žádná hodnota, šablona vytvoří nové centrum událostí.
     environmentDisplayName	Volitelný popisný název, který se zobrazí v nástrojích nebo uživatelských rozhraních místo názvu prostředí.
     environmentSkuName	Název skladové jednotky. Další informace najdete na stránce s cenami služby Azure Time Series Insights.
     environmentSkuCapacity	Kapacita jednotky skladové položky. Další informace najdete na stránce s cenami služby Azure Time Series Insights.
     environmentDataRetentionTime	Minimální časový rozsah událostí prostředí bude k dispozici pro dotaz. Hodnota musí být zadána ve formátu ISO 8601, například P30D pro zásady uchovávání informací o 30 dnech.
     eventSourceDisplayName	Volitelný popisný název, který se má zobrazit v nástrojích nebo uživatelských rozhraních místo názvu zdroje události.
     eventSourceTimestampPropertyName	Vlastnost události, která se použije jako časové razítko zdroje událostí. Pokud pro časové razítkoPropertyName není zadaná hodnota nebo je zadána hodnota null nebo prázdný řetězec, použije se čas vytvoření události.
     eventSourceKeyName	Název sdíleného přístupového klíče, který bude služba Azure Time Series Insights používat pro připojení k centru událostí.
     accessPolicyReaderObjectIds	Seznam ID objektů uživatelů nebo aplikací v Microsoft Entra ID, které by měly mít k prostředí přístup čtenáře. Instanční objekt objectId lze získat voláním Rutin Get-AzADUser nebo Get-AzADServicePrincipal . Vytvoření zásad přístupu pro skupiny Microsoft Entra se zatím nepodporuje.
     accessPolicyContributorObjectIds	Seznam ID objektů uživatelů nebo aplikací v MICROSOFT Entra ID, které by měly mít přístup přispěvatele k prostředí. Instanční objekt objectId lze získat voláním Rutin Get-AzADUser nebo Get-AzADServicePrincipal . Vytvoření zásad přístupu pro skupiny Microsoft Entra se zatím nepodporuje.

   • Například následující soubor parametrů by se použil k vytvoření prostředí a zdroje událostí, který čte události z existujícího centra událostí. Vytvoří také dvě zásady přístupu, které udělí přispěvateli přístup k prostředí.

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

   • Další informace najdete v článku Parametry .

Místní nasazení šablony rychlého startu pomocí PowerShellu

1. V PowerShellu se přihlaste ke svému účtu Azure.

   • Z příkazového řádku PowerShellu spusťte následující příkaz:

     Connect-AzAccount
     

   • Zobrazí se výzva, abyste se přihlásili ke svému účtu Azure. Po přihlášení spusťte následující příkaz a zobrazte dostupná předplatná:

     Get-AzSubscription
     

   • Tento příkaz vrátí seznam dostupných předplatných Azure. Spuštěním následujícího příkazu zvolte předplatné pro aktuální relaci. Nahraďte <YourSubscriptionId> identifikátorEM GUID předplatného Azure, které chcete použít:

     Set-AzContext -SubscriptionID <YourSubscriptionId>
     

2. Pokud neexistuje, vytvořte novou skupinu prostředků.

   • Pokud nemáte existující skupinu prostředků, vytvořte novou skupinu prostředků pomocí příkazu New-AzResourceGroup . Zadejte název skupiny prostředků a umístění, které chcete použít. Příklad:

     New-AzResourceGroup -Name MyDemoRG -Location "West US"
     

   • V případě úspěchu se zobrazí souhrn nové skupiny prostředků.

     ResourceGroupName : MyDemoRG
     Location          : westus
     ProvisioningState : Succeeded
     Tags              :
     ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
     

3. Otestujte nasazení.

   • Spuštěním rutiny Test-AzResourceGroupDeployment ověřte nasazení. Při testování nasazení zadejte parametry přesně tak, jako byste při provádění nasazení.

     Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
     

4. Vytvoření nasazení

   • Pokud chcete vytvořit nové nasazení, spusťte rutinu New-AzResourceGroupDeployment a po zobrazení výzvy zadejte potřebné parametry. Parametry zahrnují název nasazení, název vaší skupiny prostředků a cestu nebo adresu URL souboru šablony. Pokud není zadaný parametr Mode, použije se výchozí hodnota Přírůstkové. Další informace najdete v článku Přírůstkové a úplné nasazení.

   • Následující příkaz vás vyzve k zadání pěti požadovaných parametrů v okně PowerShellu:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
     

   • Pokud chcete místo toho zadat soubor parametrů, použijte následující příkaz:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
     

   • Při spuštění rutiny nasazení můžete také použít vložené parametry. Příkaz vypadá takto:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
     

   • Pokud chcete spustit úplné nasazení, nastavte parametr Mode na Hodnotu Dokončeno:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
     

5. Ověření nasazení

   • Pokud se prostředky úspěšně nasadí, zobrazí se v okně PowerShellu souhrn nasazení:

      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 :
     

6. Nasazení šablony rychlého startu prostřednictvím webu Azure Portal

   • Domovská stránka šablony rychlého startu na GitHubu obsahuje také tlačítko Nasadit do Azure . Kliknutím na ni otevřete stránku Vlastní nasazení na webu Azure Portal. Na této stránce můžete zadat nebo vybrat hodnoty pro každý z parametrů z požadovaných parametrů nebo volitelných tabulek parametrů . Po vyplnění nastavení kliknutím na tlačítko Koupit zahájíte nasazení šablony.

Další kroky

• Informace o správě prostředků Azure Time Series Insights prostřednictvím kódu programu pomocí rozhraní REST API najdete v tématu Azure Time Series Insights Management.