Azure Time Series Insights Gen 1-resources maken met behulp van Azure Resource Manager-sjablonen
Notitie
De Time Series Insights-service wordt op 7 juli 2024 buiten gebruik gesteld. Overweeg om bestaande omgevingen zo snel mogelijk naar alternatieve oplossingen te migreren. Voor meer informatie over de uitfasering en migratie, ga naar onze documentatie.
Voorzichtigheid
Dit is een Gen1-artikel.
In dit artikel wordt beschreven hoe u Azure Time Series Insights-resources maakt en implementeert met behulp van Azure Resource Manager-sjablonen, PowerShell en de Azure Time Series Insights-resourceprovider.
Azure Time Series Insights ondersteunt de volgende resources:
| Hulpbron | Beschrijving |
|---|---|
| Milieu | Een Azure Time Series Insights-omgeving is een logische groepering van gebeurtenissen die worden gelezen uit gebeurtenisbrokers, opgeslagen en beschikbaar worden gesteld voor query's. Lees Uw Azure Time Series Insights-omgeving plannen voor meer informatie |
| Gebeurtenisbron | Een gebeurtenisbron is een verbinding met een gebeurtenisbroker van waaruit Azure Time Series Insights gebeurtenissen in de omgeving leest en opneemt. Momenteel ondersteunde gebeurtenisbronnen zijn IoT Hub en Event Hub. |
| Referentiegegevensset | Referentiegegevenssets bieden metagegevens over de gebeurtenissen in de omgeving. Metagegevens in de referentiegegevenssets worden bij binnenkomst van gegevens samengevoegd met gebeurtenissen. Referentiegegevenssets worden gedefinieerd als resources op basis van de eigenschappen van de gebeurtenissleutel. De werkelijke metagegevens waaruit de referentiegegevensset bestaat, worden geüpload of gewijzigd via API's van het gegevensvlak. |
| Toegangsbeleid | Toegangsbeleid verleent machtigingen om gegevensquery's uit te geven, referentiegegevens in de omgeving te bewerken en opgeslagen query's en perspectieven te delen die zijn gekoppeld aan de omgeving. Lees voor meer informatie Gegevenstoegang verlenen tot een Azure Time Series Insights-omgeving met behulp van Azure Portal |
Een Resource Manager-sjabloon is een JSON-bestand dat de infrastructuur en configuratie van resources in een resourcegroep definieert. In de volgende documenten worden sjabloonbestanden gedetailleerder beschreven:
- azure Resource Manager-sjabloonimplementatie
- Resources implementeren met Resource Manager-sjablonen en Azure PowerShell-
- Microsoft.TimeSeriesInsights-resourcetypen
De timeseriesinsights-environment-with-eventhub quickstart-sjabloon wordt gepubliceerd op GitHub. Met deze sjabloon maakt u een Azure Time Series Insights-omgeving, een onderliggende gebeurtenisbron die is geconfigureerd voor het verbruik van gebeurtenissen van een Event Hub en toegangsbeleid dat toegang verleent tot de gegevens van de omgeving. Als er geen bestaande Event Hub is opgegeven, wordt er een gemaakt met de implementatie.
Notitie
U wordt aangeraden de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell-installeren om aan de slag te gaan. Zie Azure PowerShell migreren van AzureRM naar Azvoor meer informatie over het migreren naar de Az PowerShell-module.
Implementatiesjabloon en -parameters opgeven
In de volgende procedure wordt beschreven hoe u PowerShell gebruikt om een Azure Resource Manager-sjabloon te implementeren waarmee een Azure Time Series Insights-omgeving wordt gemaakt, een onderliggende gebeurtenisbron die is geconfigureerd voor het verbruik van gebeurtenissen vanuit een Event Hub en toegangsbeleid dat toegang verleent tot de gegevens van de omgeving. Als er geen bestaande Event Hub is opgegeven, wordt er een gemaakt met de implementatie.
Installeer Azure PowerShell door de instructies te volgen in Aan de slag met Azure PowerShell.
Kloon of kopieer de timeseriesinsights-environment-with-eventhub sjabloon uit GitHub.
Een parameterbestand maken
Als u een parameterbestand wilt maken, kopieert u het timeseriesinsights-environment-with-eventhub bestand.
{ "$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" } } }
Vereiste parameters
Parameter Beschrijving eventHubNamespaceName De naamruimte van de event hub van de bron. eventHubName De naam van de event hub van de bron. consumentengroepNaam De naam van de consumentengroep die door de Azure Time Series Insights-service wordt gebruikt om de gegevens van de Event Hub te lezen. OPMERKING: Om resourceconflicten te voorkomen, moet deze consumentengroep worden toegewezen aan de Azure Time Series Insights-service en niet worden gedeeld met andere lezers. omgevingNaam De naam van de omgeving. De naam mag niet bestaan uit: <,>,%,&,:,\\,?,/en besturingstekens. Alle andere tekens zijn toegestaan.naam van gebeurtenisbron De naam van de onderliggende resource van de gebeurtenisbron. De naam mag niet bestaan uit: <,>,%,&,:,\\,?,/en besturingstekens. Alle andere tekens zijn toegestaan.
Optionele parameters
Parameter Beschrijving bestaandeEventHubResourceId Een optionele resource-id van een bestaande Event Hub die via de gebeurtenisbron wordt verbonden met de Azure Time Series Insights-omgeving. OPMERKING: De gebruiker die de sjabloon implementeert, moet bevoegdheden hebben om de bewerking listkeys uit te voeren op de Event Hub. Als er geen waarde wordt doorgegeven, wordt er een nieuwe Event Hub gemaakt door de sjabloon. environmentDisplayName Een optionele beschrijvende naam die moet worden weergegeven in hulpprogramma's of gebruikersinterfaces in plaats van de omgevingsnaam. environmentSkuName De naam van de SKU. Voor meer informatie, lees de pagina Azure Time Series Insights-prijzen. omgevingSkuCapaciteit De eenheidscapaciteit van de SKU. Lees voor meer informatie de pagina Azure Time Series Insights Prijzen. omgevingDataretentietijd De minimale tijdsduur waarin de gebeurtenissen in de omgeving opvraagbaar zijn. De waarde moet worden opgegeven in de ISO 8601-indeling, bijvoorbeeld P30Dvoor een bewaarbeleid van 30 dagen.eventSourceDisplayName Een optionele beschrijvende naam die moet worden weergegeven in hulpprogramma's of gebruikersinterfaces in plaats van de naam van de gebeurtenisbron. eventSourceTimestampPropertyName De gebeurteniseigenschap die wordt gebruikt als tijdstempel van de gebeurtenisbron. Als een waarde niet is opgegeven voor timestampPropertyName of als null of lege tekenreeks is opgegeven, wordt de aanmaaktijd van de gebeurtenis gebruikt. eventBronSleutelNaam De naam van de gedeelde toegangssleutel die door de Azure Time Series Insights-service wordt gebruikt om verbinding te maken met de Event Hub. accessPolicyReaderObjectIds Een lijst met object-id's van de gebruikers of toepassingen in Microsoft Entra ID die lezertoegang tot de omgeving moeten hebben. De object-id van de service-principal kan worden verkregen door de Get-AzADUser- of de Get-AzADServicePrincipal- cmdlets aan te roepen. Het maken van een toegangsbeleid voor Microsoft Entra-groepen wordt nog niet ondersteund. accessPolicyContributorObjectIds Een lijst met object-id's van de gebruikers of toepassingen in Microsoft Entra ID die inzendertoegang tot de omgeving moeten hebben. De object-id van de service-principal kan worden verkregen door de Get-AzADUser- of de Get-AzADServicePrincipal- cmdlets aan te roepen. Het maken van een toegangsbeleid voor Microsoft Entra-groepen wordt nog niet ondersteund. Als voorbeeld wordt het volgende parameterbestand gebruikt om een omgeving te maken en een gebeurtenisbron die gebeurtenissen van een bestaande Event Hub leest. Er worden ook twee toegangsbeleidsregels gemaakt die Inzender toegang verlenen tot de omgeving.
{ "$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" ] } } }Lees het artikel Parameters voor meer informatie.
De quickstart-sjabloon lokaal implementeren met Behulp van PowerShell
Belangrijk
De onderstaande opdrachtregelbewerkingen beschrijven de Az PowerShell-module.
Meld u in PowerShell aan bij uw Azure-account.
Voer vanaf een PowerShell-prompt de volgende opdracht uit:
Connect-AzAccountU wordt gevraagd u aan te melden bij uw Azure-account. Nadat u zich hebt aangemeld, voert u de volgende opdracht uit om uw beschikbare abonnementen weer te geven:
Get-AzSubscriptionMet deze opdracht wordt een lijst met beschikbare Azure-abonnementen geretourneerd. Kies een abonnement voor de huidige sessie door de volgende opdracht uit te voeren. Vervang
<YourSubscriptionId>door de GUID voor het Azure-abonnement dat u wilt gebruiken:Set-AzContext -SubscriptionID <YourSubscriptionId>
Maak een nieuwe resourcegroep als deze niet bestaat.
Als u geen bestaande resourcegroep hebt, maakt u een nieuwe resourcegroep met de opdracht New-AzResourceGroup. Geef de naam op van de resourcegroep en de locatie die u wilt gebruiken. Bijvoorbeeld:
New-AzResourceGroup -Name MyDemoRG -Location "West US"Als dit lukt, wordt een samenvatting van de nieuwe resourcegroep weergegeven.
ResourceGroupName : MyDemoRG Location : westus ProvisioningState : Succeeded Tags : ResourceId : /subscriptions/<GUID>/resourceGroups/MyDemoRG
Test de implementatie.
Valideer uw implementatie door de
Test-AzResourceGroupDeploymentcmdlet uit te voeren. Bij het testen van de implementatie moet u precies dezelfde parameters opgeven als bij het uitvoeren van de implementatie.Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
De implementatie maken
Als u de nieuwe implementatie wilt maken, voert u de
New-AzResourceGroupDeploymentcmdlet uit en geeft u de benodigde parameters op wanneer u hierom wordt gevraagd. De parameters bevatten een naam voor uw implementatie, de naam van uw resourcegroep en het pad of de URL naar het sjabloonbestand. Als de parameter Modus niet is opgegeven, wordt de standaardwaarde van Incrementele gebruikt. Lees incrementele en volledige implementatiesvoor meer informatie.De volgende opdracht vraagt u om de vijf vereiste parameters in het PowerShell-venster:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.jsonAls u in plaats daarvan een parameterbestand wilt opgeven, gebruikt u de volgende opdracht:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.jsonU kunt ook inlineparameters gebruiken wanneer u de implementatie-cmdlet uitvoert. De opdracht is als volgt:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"Als u een voltooide-implementatie wilt uitvoeren, stelt u de parameter Modus in op Volledige:
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
De implementatie controleren
Als de resources zijn geïmplementeerd, wordt een samenvatting van de implementatie weergegeven in het PowerShell-venster:
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 :
De quickstart-sjabloon implementeren via Azure Portal
- De startpagina van de quickstart-sjabloon op GitHub bevat ook een knop Implementeren in Azure. Door erop te klikken, wordt een aangepaste implementatiepagina geopend in de Azure-portal. Op deze pagina kunt u waarden invoeren of selecteren voor elk van de parameters uit de vereiste parameters of optionele parameters tabellen. Nadat u de instellingen hebt ingevuld, wordt de sjabloonimplementatie gestart door op de knop Kopen te klikken.
Volgende stappen
- Lees Azure Time Series Insights Managementvoor informatie over het programmatisch beheren van Azure Time Series Insights-resources met behulp van REST API's.