Azure müşteri kullanımı ilişkilendirmesi
Müşteri kullanımı ilişkilendirmesi, IP'nizi sizinle iş ortağı olarak dağıtırken oluşturulan müşteri aboneliklerinde Azure kaynaklarından gelen kullanımı ilişkilendirir. Bu ilişkilendirmelerin iç Microsoft sistemlerinde oluşturulması, yazılımınızı çalıştıran Azure ayak izi için daha fazla iç görünürlük sağlar. Ticari marketteki Azure Uygulaması dağıtım teklifleri için bu izleme özelliği Microsoft satış ekipleriyle uyumlu olmanıza ve Microsoft iş ortağı programları için kredi kazanmanıza yardımcı olur. Müşteri kullanımı ilişkilendirmesi, ticari marketteki Azure sanal makine teklifleri için geçerli değildir. Azure tüketiminin son müşteri aboneliklerinde izlendiğinden emin olmak için sanal makine teklifleri için bir market yayımcısı tarafından yapılması gereken hiçbir şey yoktur.
Müşteri kullanımı ilişkilendirmesi üç dağıtım seçeneğini destekler:
- Azure Resource Manager şablonları (ticari markette "çözüm şablonları" veya "yönetilen uygulamalar" olarak da adlandırılan Azure uygulamalarının yaygın temelleri): iş ortakları, Azure çözümlerinin altyapısını ve yapılandırmasını tanımlamak için Resource Manager şablonları oluşturur. Resource Manager şablonu, müşterilerinizin çözümünüzün kaynaklarını tutarlı ve yinelenebilir bir durumda dağıtmasını sağlar.
- Azure Resource Manager API'leri: iş ortakları Resource Manager şablonu dağıtmak veya doğrudan Azure hizmetleri sağlamak için Resource Manager API'lerini çağırabilir.
- Terraform: iş ortakları Terraform kullanarak Resource Manager şablonu dağıtabilir veya Azure hizmetlerini doğrudan dağıtabilir.
Ticari market dışındaki müşteri kullanımı ilişkilendirmesi için bu makalenin devamında yer alan İkincil kullanım örnekleri bölümüne bakın.
Önemli
Müşteri kullanımı ilişkilendirmesi, öncelikle Azure kaynaklarını dağıtmak ve yönetmek için tasarlanmış sistem tümleştiricilerinin, yönetilen hizmet sağlayıcılarının veya araçların çalışmasını izlemeye yönelik değildir.
Müşteri kullanımı ilişkilendirmesi yeni dağıtımlar içindir ve zaten dağıtılmış olan izleme kaynaklarını desteklemez.
- Tüm Azure hizmetleri müşteri kullanımı ilişkilendirmesiyle uyumlu değildir. Azure Kubernetes Services (AKS), VM Ölçek Kümeleri ve Azure Batch'in az kullanım bildirimine neden olan bilinen sorunları vardır.
- Müşteri kullanımı ilişkilendirmesi Azure tüketim verileri iş ortaklarıyla harici olarak paylaşılamaz.
Ticari market Azure uygulamaları
Ticari markette yayımlanan Azure uygulamalarından Azure kullanımını izlemek büyük ölçüde otomatiktir. Market Azure uygulamanızın planının teknik yapılandırması kapsamında bir Resource Manager şablonu yüklediğinizde, İş Ortağı Merkezi Azure Resource Manager tarafından okunabilir bir izleme kimliği ekler.
Not
Uygulamanızın kullanımının sistemlerimizde doğru bir şekilde ilişkilendirildiğinden emin olmak için:
- Microsoft.Resources/deployment kaynak türünde izleme kimliğini bir değişkenle tanımlarsanız, değişkeni planın Teknik Yapılandırma sayfasındaki İş Ortağı Merkezi'nde görünen izleme kimliğiyle değiştirin (aşağıdaki Resource Manager şablonuna GUID ekleme bölümüne bakın).
- Resource Manager şablonunuz, müşteri kullanımı ilişkilendirmesi dışında amaçlarla Microsoft.Resources/deployments türünde kaynaklar kullanıyorsa, Microsoft sizin adınıza müşteri kullanımı ilişkilendirme izleme kimliği ekleyemez. Microsoft.Resources/deployments türünde yeni bir kaynak ekleyin ve planın Teknik yapılandırma sayfasındaki İş Ortağı Merkezi'nde görünen izleme kimliğini ekleyin (aşağıdaki Resource Manager şablonuna GUID ekleme bölümüne bakın).
Azure Resource Manager API'lerini kullanıyorsanız, kodunuz kaynakları dağıtırken Azure Resource Manager'a geçirmek için aşağıdaki yönergelere göre izleme kimliğinizi eklemeniz gerekir. Bu kimlik, Azure Uygulaması lication planınızın Teknik Yapılandırma sayfasındaki İş Ortağı Merkezi'nde görünür.
Not
Mevcut Azure uygulamaları için, her planın teknik yapılandırmasındaki izleme kimliklerini güncelleştirmek için Mart 2021'de tek seferlik geçiş başladı. Bu tekliflerin geçmiş dağıtımlarındaki kullanımLar Microsoft sistemlerinde izlenir.
Tekliflerinizi güncelleştirirken artık ana şablon dosyanıza Microsoft.Resources/deployments kaynak türünü eklemeniz gerekmez.
Diğer kullanım örnekleri
Ticari markette bulunmayan çözümlerin Azure kullanımını izlemek için müşteri kullanımı atfını kullanabilirsiniz. Bu çözümler genellikle Hızlı Başlangıç deposunda, özel GitHub depolarında bulunur veya dayanıklı IP (dağıtılabilir ve ölçeklenebilir uygulama gibi) oluşturan 1:1 müşteri etkileşimlerinden gelir.
El ile yapılması gereken birkaç adım vardır:
- İzleme kimlikleriniz olarak kullanmak için bir veya daha fazla GUID oluşturun.
- Bu GUID'leri İş Ortağı Merkezi'ne kaydedin.
- Kayıtlı GUID'lerinizi Azure uygulamanıza ve/veya kullanıcı aracısı dizelerine ekleyin.
GUID oluşturma
İş Ortağı Merkezi'nin ticari marketteki Azure uygulamaları için sizin adınıza oluşturduğu izleme kimliklerinden farklı olarak, Müşteri Kullanımı İlişkilendirmesi'nin diğer kullanımları, izleme kimliğiniz olarak kullanmak üzere bir GUID oluşturmanızı gerektirir. GUID, 32 onaltılık basamak içeren benzersiz bir başvuru tanımlayıcısıdır. İzleme guid'leri oluşturmak için, örneğin PowerShell aracılığıyla bir GUID oluşturucu kullanmanız gerekir:
[guid]::NewGuid()
Her ürün ve dağıtım kanalı için benzersiz bir GUID oluşturmanız gerekir. Raporlamanın bölünmesini istemiyorsanız, bir ürünün birden çok dağıtım kanalı için tek bir GUID kullanabilirsiniz. Raporlama, PartnerID ve GUID tarafından gerçekleşir.
GUID'leri kaydetme
GUID'lerin sizinle iş ortağı olarak ilişkilendirilebilmeleri için daha sonra İş Ortağı Merkezi'ne kaydedilmesi gerekir:
İş Ortağı Merkezi'nde oturum açın.
Sağ üst köşedeki Ayarlar (dişli simgesi) ve ardından Hesap ayarları'nı seçin.
Kuruluş profili>Tanımlayıcıları>İzleme GUID'i Ekle'yi seçin.
GUID kutusuna izleme GUID'nizi girin. Ön ek olmadan yalnızca GUID değerini
pid-girin. Açıklama kutusuna çözüm adınızı veya açıklamanızı girin.Birden fazla GUID kaydetmek için İzleme GUID'i Ekle'yi yeniden seçin. Sayfada ek kutular görüntülenir.
Kaydet'i seçin.
Resource Manager şablonuna GUID ekleme
Kayıtlı GUID'nizi bir Resource Manager şablonuna eklemek için ana şablon dosyasında tek bir değişiklik yapın:
Resource Manager şablonunu açın.
Ana şablon dosyasına Microsoft.Resources/deployments türünde yeni bir kaynak ekleyin. Kaynağın herhangi bir iç içe veya bağlantılı şablonda değil yalnızca mainTemplate.json veya azuredeploy.json dosyasında olması gerekir.
Ön ekin ardından kaynağın
pid-adı olarak GUID değerini girin. Örneğin, GUID eb7927c8-dd66-43e1-b0cf-c346a422063 ise, kaynak adı pid-eb7927c8-dd66-43e1-b0cf-c346a422063 olur. Örnek:
{ // add this resource to the resources section in the mainTemplate.json
"apiVersion": "2020-06-01",
"name": "pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", // use your generated GUID here
"type": "Microsoft.Resources/deployments",
"properties": {
"mode": "Incremental",
"template": {
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": []
}
}
} // remove all comments from the file when complete
Şablonda hatalar olup olmadığını denetleyin.
Şablonu uygun depolarda yeniden yayımlayın.
Şablon dağıtımında GUID başarısını doğrulayın.
İpucu
Resource Manager şablonları oluşturma ve yayımlama hakkında daha fazla bilgi için bkz. İlk Resource Manager şablonunuzu oluşturma ve dağıtma.
GUID ile izlenen dağıtımları doğrulama
Şablonunuzu değiştirdikten ve bir test dağıtımı çalıştırdıktan sonra dağıtıp etiketlediğiniz kaynakları almak için aşağıdaki PowerShell betiğini kullanın.
GUID'nin Resource Manager şablonunuz için başarıyla eklendiğini doğrulamak için betiği kullanabilirsiniz. Betik Resource Manager API'sine veya Terraform dağıtımlarına uygulanmaz.
Azure'da oturum açın. Betiği çalıştırmadan önce doğrulamak istediğiniz dağıtımı içeren aboneliği seçin. Betiği dağıtımın abonelik bağlamında çalıştırın.
Dağıtımın GUID 'i (aşağıda "deploymentName" olarak adlandırılır) ve resourceGroupName adı gerekli parametrelerdir.
Özgün Verify-DeploymentGuid betiğini GitHub'dan alabilirsiniz.
Param(
[string][Parameter(Mandatory=$true)]$deploymentName, # the full name of the deployment, e.g. pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
[string][Parameter(Mandatory=$true)]$resourceGroupName
)
# Get the correlationId of the named deployment
$correlationId = (Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -Name "$deploymentName").correlationId
# Find all deployments with that correlationId
$deployments = Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName | Where-Object{$_.correlationId -eq $correlationId}
# Find all deploymentOperations in all deployments with that correlationId as PowerShell doesn't surface outputResources on the deployment or correlationId on the deploymentOperation
foreach ($deployment in $deployments){
# Get deploymentOperations by deploymentName
# then the resourceIds for each resource
($deployment | Get-AzResourceGroupDeploymentOperation | Where-Object{$_.targetResource -notlike "*Microsoft.Resources/deployments*"}).TargetResource
}
Müşterilerinize bildirme
İş ortakları, müşteri kullanımı atfını kullanan dağıtımlar hakkında müşterilerini bilgilendirmelidir. Aşağıdaki örnekler, müşterilerinize bu dağıtımları bildirmek için kullanabileceğiniz içeriği içerir. Örneklerde İŞ ORTAKINI> şirketinizin adıyla değiştirin<. İş ortakları, bildirimin, müşterilerin izlemeden dışlanması için seçenekler de dahil olmak üzere veri gizliliği ve toplama ilkeleriyle uyumlu olduğundan emin olmalıdır.
Resource Manager şablon dağıtımları için bildirim
Bu şablonu dağıttığınızda Microsoft, dağıtılan Azure kaynaklarıyla İş ORTAĞı> yazılımının yüklenmesini <belirleyebilir. Microsoft, yazılımı desteklemek için kullanılan bu kaynakları ilişkilendirebilir. Microsoft, ürünleriyle ilgili en iyi deneyimleri sağlamak ve işlerini yürütmek için bu bilgileri toplar. Veriler, adresinde bulunan https://www.microsoft.com/trustcenterMicrosoft'un gizlilik ilkeleri tarafından toplanır ve yönetilir.
SDK veya API dağıtımları için bildirim
İş ORTAĞı> yazılımını dağıttığınızda <Microsoft, dağıtılan Azure kaynaklarıyla İş ORTAĞı> yazılımının yüklenmesini <belirleyebilir. Microsoft, yazılımı desteklemek için kullanılan bu kaynakları ilişkilendirebilir. Microsoft, ürünleriyle ilgili en iyi deneyimleri sağlamak ve işlerini yürütmek için bu bilgileri toplar. Veriler, adresinde bulunan https://www.microsoft.com/trustcenterMicrosoft'un gizlilik ilkeleri tarafından toplanır ve yönetilir.
Resource Manager API'lerini kullanma
Bazı durumlarda, Azure hizmetlerini dağıtmak için doğrudan Resource Manager REST API'lerine yönelik çağrılar yapabilirsiniz. bu çağrıları etkinleştirmek için birden çok SDK Azure desteği. SDK'lardan birini kullanabilir veya kaynakları dağıtmak için REST API'lerini doğrudan çağırabilirsiniz.
Müşteri kullanımı ilişkilendirmesini etkinleştirmek için, API çağrılarınızı tasarlarken, istekteki kullanıcı aracısı üst bilgisine izleme kimliğinizi ekleyin. Dizeyi ön ekiyle biçimlendirin pid- . Örnekler:
//Commercial Marketplace Azure app
pid-contoso-myoffer-partnercenter //copy the tracking ID exactly as it appears in Partner Center
//Other use cases
pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4 //enter your GUID after "pid-"
Önemli
Resource Manager API'lerini ticari marketteki bir Azure uygulamasıyla kullanıyorsanız İş Ortağı Merkezi'nde sağlanan izleme kimliğini kullanın. GUID KULLANMAYIN.
Çeşitli SDK'lar Resource Manager API'leriyle farklı etkileşim kurar ve kodunuzda bazı farklılıklar gerektirir. Aşağıdaki örneklerde GUID kullanan ticari olmayan market yaklaşımı yer alır ve daha popüler Azure SDK'ları ele alınmıştır.
Örnek: Python SDK'sı
Python için config özniteliğini kullanın. Özniteliği yalnızca UserAgent'a ekleyebilirsiniz. Örnek:
client = azure.mgmt.servicebus.ServiceBusManagementClient(**parameters)
client.config.add_user_agent("pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4")
Önemli
Her istemci için özniteliğini ekleyin. Genel statik yapılandırma yoktur. Her istemcinin izlediğini güvence altına almak için bir istemci fabrikasını etiketleyebilirsiniz. Daha fazla bilgi için GitHub'da bu istemci fabrikası örneğine bakın.
Örnek: .NET SDK
.NET için kullanıcı aracısını ayarladığınızdan emin olun. Kullanıcı aracısını aşağıdaki kodla ayarlamak için Microsoft.Azure.Management.Fluent kitaplığını kullanın (örneğin C#):
var azure = Microsoft.Azure.Management.Fluent.Azure
.Configure()
// Add your pid in the user agent header
.WithUserAgent("pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", String.Empty)
.Authenticate(/* Credentials created via Microsoft.Azure.Management.ResourceManager.Fluent.SdkContext.AzureCredentialsFactory */)
.WithSubscription("<subscription ID>");
Önemli
Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.
İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.
Örnek: Azure PowerShell
Kaynakları Azure PowerShell aracılığıyla dağıtırsanız şu yöntemi kullanarak GUID'nizi ekleyin:
[Microsoft.Azure.Common.Authentication.AzureSession]::ClientFactory.AddUserAgent("pid-eb7927c8-dd66-43e1-b0cf-c346a422063")
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.
Örnek: Azure CLI
GUID'nizi eklemek için Azure CLI'yı kullandığınızda, AZURE_HTTP_USER_AGENT ortam değişkenini bir betik kapsamında ayarlayın. Kabuk kapsamı için değişkeni genel olarak da ayarlayabilirsiniz:
export AZURE_HTTP_USER_AGENT='pid-eb7927c8-dd66-43e1-b0cf-c346a422063'
Daha fazla bilgi için bkz . Go için Azure SDK.
Terraform kullanma
Terraform desteği, Azure Sağlayıcı'nın 1.21.0 sürümü aracılığıyla sağlanır: https://github.com/terraform-providers/terraform-provider-azurerm/blob/master/CHANGELOG.md#1210-january-11-2019. Bu, çözümünü Terraform aracılığıyla dağıtan tüm iş ortakları ve Azure Sağlayıcısı tarafından dağıtılan ve ölçülen tüm kaynaklar (sürüm 1.21.0 veya üzeri) için geçerlidir.
Terraform için Azure sağlayıcısı, çözümünüz için kullanılan izleme GUID'sini belirtmek için partner_id adlı isteğe bağlı yeni bir alan ekledi. Bu alanın değeri ARM_PARTNER_ID Ortam Değişkeni'nden de kaynaklanabilir.
provider "azurerm" {
subscription_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
……
# new stuff for ISV attribution
partner_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}
Önemli
Terraform'ı ticari marketteki bir Azure uygulamasıyla kullanıyorsanız İş Ortağı Merkezi'nde sağlanan izleme kimliğinin tamamını kullanın. GUID KULLANMAYIN.
Destek alma
İş Ortağı Merkezi'ndeki ticari market programı için destek bölümünden ticari marketteki destek seçenekleri hakkında bilgi edinin.
Teknik danışmanlık isteği gönderme
- İş Ortağı Teknik Hizmetleri'ne gidin.
- Teknik yolculuğu görüntülemek için Bulut altyapısı ve yönetimi'ni seçin.
- Dağıtım Hizmetleri>İstek gönder'i seçin.
- MSA 'nızı (Microsoft AI Bulut İş Ortağı Programı hesabı) veya Microsoft Entra Kimliğinizi (İş Ortağı Panosu hesabı) kullanarak oturum açın.
- Açılan formdaki kişi bilgilerini tamamlayın/gözden geçirin. Danışmanlık ayrıntıları önceden doldurulmuş olabilir veya açılan seçenekleriniz olabilir.
- Sorunun başlığını ve ayrıntılı açıklamasını girin.
- Gönder'i seçin.
Teknik Satış Öncesi ve Dağıtım Hizmetlerini Kullanma sayfasında ekran görüntüleriyle birlikte adım adım yönergeleri görüntüleyin.
İhtiyaçlarınızı karşılayacak bir çağrı ayarlamak için bir Microsoft İş Ortağı Teknik Danışmanı ile iletişime geçileceksiniz.
SSS
bir izleme kimliği eklendikten sonra değiştirilebilir mi?
Ticari marketteki Azure uygulamaları için izleme kimlikleri, İş Ortağı Merkezi tarafından otomatik olarak yönetilir. Ancak müşteri bir şablon indirebilir ve izleme kimliğini değiştirebilir veya kaldırabilir. İş ortakları, kaldırmayı veya düzenlemeyi önlemek için izleme kimliğinin müşterilere rolünü proaktif olarak açıklamalıdır. İzleme kimliğinin değiştirilmesi, mevcut dağıtımları ve kaynakları değil yalnızca yeni dağıtımları ve kaynakları etkiler.
GitHub gibi Microsoft dışı bir depodan dağıtılan şablonları izleyebilir miyim?
Evet, şablon dağıtıldığında izleme kimliği mevcut olduğu sürece kullanım izlenir. Yayımcı olarak sizinle Microsoft dışı bir depodan dağıtılan şablonunuz arasındaki ilişkiyi korumak için, önce azure portalındaki teklifinizin ticari market listesinden yayımlanan şablonunuzun (izleme kimliğini içerecek) bir kopyasını indirin. Bu sürümü GitHub'da veya Microsoft dışı başka bir depoda yayımlayın.
Şablonunuz ticari markette listelenmiyorsa ve kayıtlı bir GUID içeriyorsa, GUID'nin GitHub'da yayımladığınız sürümde veya Microsoft dışı başka bir depoda bulunduğundan emin olun.
Microsoft Müşteri Kullanımı İlişkilendirme verilerini iş ortaklarıyla paylaşıyor mu?
Hayır Microsoft, Müşteri Kullanımı İlişkilendirmesi aracılığıyla izlenen Azure tüketim verilerini iş ortaklarıyla harici olarak paylaşmaz.
Müşteriler Müşteri Kullanımı İlişkilendirme bildirimi alıyor mu?
Hayır Müşteriler Azure portalındaki tüm kaynakların veya kaynak gruplarının kullanımını izleyebilir. Müşteriler, Kullanımın Müşteri Kullanımı İlişkilendirmesi izleme kimliğine göre ayrıldığını görmez.
Müşteri kullanımı ilişkilendirmesi, kaydın dijital iş ortağına (DPOR) veya iş ortağı yönetici bağlantısına (PAL) benzer mi?
Müşteri kullanımı ilişkilendirmesi, Azure kullanımını bir iş ortağının yinelenebilir, dağıtılabilir IP'siyle ilişkilendirerek dağıtım sırasında ilişkilendirmeyi oluşturan bir mekanizmadır. DPOR ve PAL, iş ortağı müşteriyle etkileşime geçerken bir danışmanlık (Sistem Tümleştiricisi) veya yönetim (Yönetilen Hizmet Sağlayıcısı) iş ortağını müşterinin ilgili Azure ayak iziyle ilişkilendirmeye yöneliktir.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin