Azure Resource Manager şablonlarını kullanarak Azure Time Series Analizler 1. Nesil kaynakları oluşturma
Not
Time Series Analizler (TSI) hizmeti artık Mart 2025'e kadar desteklenmeyecektir. Mevcut TSI ortamlarını mümkün olan en kısa sürede alternatif çözümlere geçirmeyi göz önünde bulundurun. Kullanımdan kaldırma ve geçiş hakkında daha fazla bilgi için belgelerimizi ziyaret edin.
Dikkat
Bu bir 1. Nesil makalesi.
Bu makalede Azure Resource Manager şablonlarını, PowerShell'i ve Azure Time Series Analizler kaynak sağlayıcısını kullanarak Azure Time Series Analizler kaynaklarının nasıl oluşturulacağı ve dağıtılacağı açıklanır.
Azure Time Series Analizler aşağıdaki kaynakları destekler:
Kaynak | Açıklama |
---|---|
Ortam | Azure Time Series Analizler ortamı, olay aracılarından okunan, depolanan ve sorgu için kullanılabilir hale gelen olayların mantıksal bir gruplandırılmasıdır. Daha fazla bilgi için Bkz. Azure Time Series Analizler ortamınızı planlama |
Olay Kaynağı | Olay kaynağı, Azure Time Series'in olayları okuyup ortama aldığı Analizler bir olay aracısı bağlantısıdır. Şu anda desteklenen olay kaynakları IoT Hub ve Event Hub'dır. |
Başvuru Veri Kümesi | Başvuru veri kümeleri, ortamdaki olaylar hakkında meta veriler sağlar. Başvuru veri kümelerindeki meta veriler giriş sırasında olaylarla birleştirilir. Başvuru veri kümeleri, olay anahtarı özelliklerine göre kaynak olarak tanımlanır. Başvuru veri kümesini oluşturan gerçek meta veriler veri düzlemi API'leri aracılığıyla karşıya yüklenir veya değiştirilir. |
Erişim İlkesi | Erişim ilkeleri veri sorguları verme, ortamdaki başvuru verilerini işleme ve ortamla ilişkili kaydedilmiş sorguları ve perspektifleri paylaşma izinleri verir. Daha fazla bilgi için Bkz. Azure portalını kullanarak Azure Time Series Analizler ortamına veri erişimi verme |
Resource Manager şablonu, bir kaynak grubundaki kaynakların altyapısını ve yapılandırmasını tanımlayan bir JSON dosyasıdır. Aşağıdaki belgelerde şablon dosyaları daha ayrıntılı olarak açıklanmaktadır:
- Azure Resource Manager şablon dağıtımı
- Kaynakları Resource Manager şablonları ve Azure PowerShell ile dağıtma
- Microsoft.TimeSeries Analizler kaynak türleri
Timeseriesinsights-environment-with-eventhub hızlı başlangıç şablonu GitHub'da yayımlanır. Bu şablon bir Azure Time Series Analizler ortamı, bir Olay Hub'ından olayları kullanmak üzere yapılandırılmış bir alt olay kaynağı ve ortamın verilerine erişim izni veren erişim ilkeleri oluşturur. Mevcut bir Olay Hub'ı belirtilmezse, dağıtımla birlikte bir olay hub'ı oluşturulur.
Not
Azure ile etkileşim kurmak için Azure Az PowerShell modülünü kullanmanızı öneririz. Başlamak için bkz. Azure PowerShell'i yükleme. Az PowerShell modülüne nasıl geçeceğinizi öğrenmek için bkz. Azure PowerShell’i AzureRM’den Az’ye geçirme.
Dağıtım şablonunu ve parametrelerini belirtme
Aşağıdaki yordamda PowerShell kullanarak Azure Time Series Analizler ortamı oluşturan bir Azure Resource Manager şablonu, olay hub'ından olayları kullanmak üzere yapılandırılmış bir alt olay kaynağı ve ortamın verilerine erişim izni veren erişim ilkeleri açıklanır. Mevcut bir Olay Hub'ı belirtilmezse, dağıtımla birlikte bir olay hub'ı oluşturulur.
Azure PowerShell'i kullanmaya başlama başlığındaki yönergeleri izleyerek Azure PowerShell'i yükleyin.
GitHub'dan timeseriesinsights-environment-with-eventhub şablonunu kopyalayın veya kopyalayın.
Parametre dosyası oluşturma
Parametre dosyası oluşturmak için timeseriesinsights-environment-with-eventhub dosyasını kopyalayın.
{ "$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" } } }
Gerekli Parametreler
Parametre Açıklama eventHubNamespaceName Kaynak olay hub'ının ad alanı. eventHubName Kaynak olay hub'ının adı. consumerGroupName Azure Time Series Analizler hizmetinin olay hub'ından verileri okumak için kullanacağı tüketici grubunun adı. NOT: Kaynak çekişmesi önlemek için bu tüketici grubunun Azure Time Series Analizler hizmetine ayrılmış olması ve diğer okuyucularla paylaşılmaması gerekir. environmentName Ortamın adı. Ad şunları içeremez: <
,>
,%
,&
,:
, ,\\
,?
, ,/
ve herhangi bir denetim karakteri. Diğer tüm karakterlere izin verilir.eventSourceName Olay kaynağı alt kaynağının adı. Ad şunları içeremez: <
,>
,%
,&
,:
, ,\\
,?
, ,/
ve herhangi bir denetim karakteri. Diğer tüm karakterlere izin verilir.
İsteğe Bağlı Parametreler
Parametre Açıklama existingEventHubResourceId Olay kaynağı aracılığıyla Azure Time Series Analizler ortamına bağlanacak mevcut bir Olay Hub'ının isteğe bağlı kaynak kimliği. NOT: Şablonu dağıtan kullanıcının Olay Hub'ına listkeys işlemini gerçekleştirmek için ayrıcalıkları olmalıdır. Hiçbir değer geçirilmezse, şablon tarafından yeni bir olay hub'ı oluşturulur. environmentDisplayName Ortam adı yerine araç veya kullanıcı arabirimlerinde gösterilecek isteğe bağlı kolay ad. environmentSkuName Sku'nun adı. Daha fazla bilgi için Azure Zaman Serisi Analizler Fiyatlandırma sayfasını okuyun. environmentSkuCapacity Sku'nun birim kapasitesi. Daha fazla bilgi için Azure Zaman Serisi Analizler Fiyatlandırma sayfasını okuyun. environmentDataRetentionTime Sorgu için ortamın olaylarının en düşük zaman aralığı kullanılabilir. Değer ISO 8601 biçiminde belirtilmelidir, örneğin P30D
30 günlük bekletme ilkesi için.eventSourceDisplayName Olay kaynağı adı yerine araç veya kullanıcı arabirimlerinde gösterilecek isteğe bağlı kolay ad. eventSourceTimestampPropertyName Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya boş dize belirtilirse, olay oluşturma zamanı kullanılır. eventSourceKeyName Azure Time Series Analizler hizmetinin olay hub'ına bağlanmak için kullanacağı paylaşılan erişim anahtarının adı. accessPolicyReaderObjectIds Microsoft Entra Id'de bulunan ve ortama Okuyucu erişimi olması gereken kullanıcıların veya uygulamaların nesne kimliklerinin listesi. Hizmet sorumlusu objectId değeri Get-AzADUser veya Get-AzADServicePrincipal cmdlet'leri çağrılarak elde edilebilir. Microsoft Entra grupları için erişim ilkesi oluşturma henüz desteklenmiyor. accessPolicyContributorObjectIds Microsoft Entra Id'de bulunan ve ortama Katkıda Bulunan erişimi olması gereken kullanıcıların veya uygulamaların nesne kimliklerinin listesi. Hizmet sorumlusu objectId değeri Get-AzADUser veya Get-AzADServicePrincipal cmdlet'leri çağrılarak elde edilebilir. Microsoft Entra grupları için erişim ilkesi oluşturma henüz desteklenmiyor. Örneğin, mevcut bir olay hub'ından olayları okuyan bir ortam ve olay kaynağı oluşturmak için aşağıdaki parametre dosyası kullanılır. Ayrıca, ortama Katkıda Bulunan erişimi veren iki erişim ilkesi oluşturur.
{ "$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" ] } } }
Daha fazla bilgi için Parametreler makalesini okuyun.
PowerShell kullanarak hızlı başlangıç şablonunu yerel olarak dağıtma
PowerShell'de Azure hesabınızda oturum açın.
PowerShell isteminden aşağıdaki komutu çalıştırın:
Connect-AzAccount
Azure hesabınızda oturum açmanız istenir. Oturum açtıktan sonra, kullanılabilir aboneliklerinizi görüntülemek için aşağıdaki komutu çalıştırın:
Get-AzSubscription
Bu komut, kullanılabilir Azure aboneliklerinin listesini döndürür. Aşağıdaki komutu çalıştırarak geçerli oturum için bir abonelik seçin. değerini, kullanmak istediğiniz Azure aboneliğinin GUID değeriyle değiştirin
<YourSubscriptionId>
:Set-AzContext -SubscriptionID <YourSubscriptionId>
Yoksa yeni bir kaynak grubu oluşturun.
Mevcut bir kaynak grubunuz yoksa New-AzResourceGroup komutuyla yeni bir kaynak grubu oluşturun. Kullanmak istediğiniz kaynak grubunun ve konumun adını belirtin. Örneğin:
New-AzResourceGroup -Name MyDemoRG -Location "West US"
Başarılı olursa, yeni kaynak grubunun özeti görüntülenir.
ResourceGroupName : MyDemoRG Location : westus ProvisioningState : Succeeded Tags : ResourceId : /subscriptions/<GUID>/resourceGroups/MyDemoRG
Dağıtımı test edin.
cmdlet'ini
Test-AzResourceGroupDeployment
çalıştırarak dağıtımınızı doğrulayın. Dağıtımı test ederken, tam olarak dağıtımı yürütürken yaptığınız gibi parametreler sağlayın.Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
Dağıtımı oluşturma
Yeni dağıtımı oluşturmak için cmdlet'ini
New-AzResourceGroupDeployment
çalıştırın ve istendiğinde gerekli parametreleri sağlayın. Parametreler dağıtımınız için bir ad, kaynak grubunuzun adı ve şablon dosyasının yolunu veya URL'sini içerir. Mode parametresi belirtilmezse, Varsayılan Artımlı değeri kullanılır. Daha fazla bilgi için Artımlı ve eksiksiz dağıtımlar'ı okuyun.Aşağıdaki komut, PowerShell penceresinde sizden gerekli beş parametreyi ister:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
Bunun yerine parametre dosyası belirtmek için aşağıdaki komutu kullanın:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
Dağıtım cmdlet'ini çalıştırdığınızda satır içi parametreleri de kullanabilirsiniz. Komut aşağıdaki gibidir:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
Tam bir dağıtım çalıştırmak için Mode parametresini Tamamlandı olarak ayarlayın:
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
Dağıtımı doğrulama
Kaynaklar başarıyla dağıtılırsa PowerShell penceresinde dağıtımın özeti görüntülenir:
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 :
Azure portalı aracılığıyla hızlı başlangıç şablonunu dağıtma
- GitHub'da hızlı başlangıç şablonunun giriş sayfasında Azure'a Dağıt düğmesi de bulunur. Buna tıklanması, Azure portalında bir Özel Dağıtım sayfası açar. Bu sayfada, gerekli parametrelerden veya isteğe bağlı parametre tablolarından parametrelerin her biri için değerler girebilir veya seçebilirsiniz. Ayarları doldurduktan sonra Satın Al düğmesine tıklanması şablon dağıtımını başlatır.
Sonraki adımlar
- REST API'lerini kullanarak Azure Time Series Analizler kaynaklarını program aracılığıyla yönetme hakkında bilgi için bkz. Azure Time Series Analizler Management.