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í zadáno existující centrum událostí, bude s nasazením vytvořeno nové.

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í Event Hub, jeden bude vytvořen s nasazením.

1. Nainstalujte Azure PowerShell podle pokynů v tématu Začínáme s azure PowerShellem.

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

   • Vytvoření souboru parametrů

     Pokud chcete vytvořit soubor parametrů, zkopírujte timeseriesinsights-environment-with-eventhub soubor.

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

   • Požadované parametry

     Parametr	Popis
     eventHubNamespaceName	Jmenný prostor zdrojového událostního centra.
     eventHubName	Název zdrojového centra událostí.
     názevSkupinySpotřebitelů	Název skupiny příjemců, kterou bude služba Azure Time Series Insights používat ke čtení dat z centra událostí. POZNÁMKA: Chcete-li zabránit kolizí prostředků, musí být tato skupina příjemců vyhrazena službě Azure Time Series Insights a nesdílí se s ostatními čtenáři.
     název_prostředí	Název prostředí. Název nesmí obsahovat: <, >, %, &, :, \\, ?, /a všechny řídicí znaky. Všechny ostatní znaky jsou povolené.
     název zdroje události	Název podřízeného prostředku zdroje události. Název nesmí obsahovat: <, >, %, &, :, \\, ?, /a všechny řídicí znaky. Všechny ostatní znaky jsou povolené.

   • Volitelné parametry

     Parametr	Popis
     existingEventHubResourceId	Volitelné ID zdroje existujícího centra událostí, které bude připojeno 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í.
     název prostředí	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é položky. Další informace najdete na stránce s cenami služby Azure Time Series Insights .
     environmentSkuCapacity	Kapacita jednotky Sku. Další informace najdete na stránce s cenami služby Azure Time Series Insights .
     doba uchovávání dat o prostředí	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.
     Zobrazovaný název zdroje události	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.
     názevKlíčeZdrojeUdálosti	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í oprávnění čtenáře. Instanční objekt service principal objectId lze získat voláním cmdletů 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í. ObjectId lze získat voláním cmdletů 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. Napří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í.

   • Ověřte nasazení spuštěním příkazu cmdlet Test-AzResourceGroupDeployment. Při testování nasazení zadejte parametry přesně stejně, jako byste to udělali při nasazování.

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

4. Vytvořte 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 parametr Mode není zadaný, použije se výchozí hodnota Přírůstkové. Další informace najdete v přírůstkových a úplných nasazeních.

   • 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í příkazu pro nasazení můžete také použít inline parametry. Příkaz je následující:

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

   • Pokud chcete spustit kompletní nasazení, nastavte parametr režimu na Kompletní.

     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 tabulek požadovaných parametrů nebo volitelných parametrů. Po vyplnění nastavení kliknutím na tlačítko Koupit zahájíte nasazení šablony.

Další kroky

• Informace o programové správě prostředků Azure Time Series Insights pomocí rozhraní REST API najdete v tématu azure Time Series Insights Management.