Share via

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

  • Článek

Poznámka:

Služba Time Series Přehledy (TSI) už nebude podporována po březnu 2025. Zvažte migraci stávajících prostředí TSI na alternativní řešení co nejdříve. Další informace o vyřazení a migraci najdete v naší dokumentaci.

Upozornění

Toto je článek Gen1.

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

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

Resource Popis
Prostředí Prostředí Azure Time Series Přehledy je logické seskupení událostí, které se čtou z zprostředkovatelů událostí, ukládají a zpřístupní pro dotazy. Další informace najdete v tématu Plánování prostředí Azure Time Series Přehledy
Zdroj události Zdrojem událostí je připojení ke zprostředkovateli událostí, ze kterého služba Azure Time Series Přehledy čte a ingestuje události do prostředí. Aktuálně podporované zdroje událostí jsou IoT Hub a Event Hub.
Referenční sada dat Referenční datové sady poskytují metadata o událostech v prostředí. Metadata v referenčních datových sadách budou připojena k událostem během příchozího přenosu dat. Referenční datové sady jsou definovány jako prostředky podle jejich vlastností klíče události. Skutečná metadata, která tvoří referenční sadu dat, se nahrají nebo upraví prostřednictvím rozhraní API roviny dat.
Zásady přístupu Zásady přístupu udělují oprávnění k vydávání dotazů na data, manipulaci s referenčními daty v prostředí a sdílení uložených dotazů a perspektiv přidružených k prostředí. Další informace najdete v tématu Udělení přístupu k datům do Přehledy prostředí Azure Time Series pomocí webu Azure Portal.

Š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:

Šablona rychlého startu timeseriesinsights-environment-with-eventhub je publikovaná na GitHubu. Tato šablona vytvoří prostředí Azure Time Series Přehledy, podřízený zdroj událostí nakonfigurovaný tak, aby spotřebovávat 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.

Poznámka:

Při práci s Azure doporučujeme používat modul Azure Az PowerShellu. Začněte tím, že si projdete téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.

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 Přehledy, 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 Přehledy 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 Přehledy 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řipojeno k prostředí Azure Time Series Přehledy 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 Přehledy.
      environmentSkuCapacity Kapacita jednotky skladové položky. Další informace najdete na stránce s cenami služby Azure Time Series Přehledy.
      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 Přehledy 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

Důležité

Níže zobrazené operace příkazového řádku popisují modul Az PowerShell.

  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.

Tlačítko Nasadit do Azure

Další kroky