Azure panolarının yapısı
Bu belge, örnek olarak aşağıdaki panoyu kullanarak bir Azure panosunun yapısında yol gösterilir:
Paylaşılan Azure panoları kaynak olduğundan bu pano JSON olarak temsil edilebilir. Azure portal Dışarı Aktar'ı ve ardından İndir'i seçerek panonun JSON gösterimini indirebilirsiniz.
Aşağıdaki JSON, yukarıda gösterilen panoyu temsil eder.
{
{
"properties": {
"lenses": {
"0": {
"order": 0,
"parts": {
"0": {
"position": {
"x": 0,
"y": 0,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [],
"type": "Extension/HubsExtension/PartType/MarkdownPart",
"settings": {
"content": {
"settings": {
"content": "## Azure Virtual Machines Overview\r\nNew team members should watch this video to get familiar with Azure Virtual Machines.",
"markdownUri": null
}
}
}
}
},
"1": {
"position": {
"x": 3,
"y": 0,
"colSpan": 8,
"rowSpan": 4
},
"metadata": {
"inputs": [],
"type": "Extension/HubsExtension/PartType/MarkdownPart",
"settings": {
"content": {
"settings": {
"content": "This is the team dashboard for the test VM we use on our team. Here are some useful links:\r\n\r\n1. [Create a Linux virtual machine](https://docs.microsoft.com/azure/virtual-machines/linux/quick-create-portal)\r\n1. [Create a Windows virtual machine](https://docs.microsoft.com/azure/virtual-machines/windows/quick-create-portal)\r\n1. [Create a virtual machine scale set](https://docs.microsoft.com/azure/virtual-machine-scale-sets/quick-create-portal)",
"title": "Test VM Dashboard",
"subtitle": "Contoso",
"markdownUri": null
}
}
}
}
},
"2": {
"position": {
"x": 0,
"y": 2,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [],
"type": "Extension/HubsExtension/PartType/VideoPart",
"settings": {
"content": {
"settings": {
"src": "https://www.youtube.com/watch?v=rOiSRkxtTeU",
"autoplay": false
}
}
}
}
},
"3": {
"position": {
"x": 0,
"y": 4,
"colSpan": 11,
"rowSpan": 3
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Percentage CPU",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"4": {
"position": {
"x": 0,
"y": 7,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Disk Read Operations/Sec",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Disk Write Operations/Sec",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"5": {
"position": {
"x": 3,
"y": 7,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Disk Read Bytes",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Disk Write Bytes",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"6": {
"position": {
"x": 6,
"y": 7,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Network In Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Network Out Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"7": {
"position": {
"x": 9,
"y": 7,
"colSpan": 2,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "id",
"value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
],
"type": "Extension/HubsExtension/PartType/ResourcePart",
"asset": {
"idInputName": "id",
"type": "VirtualMachine"
}
}
}
}
}
},
"metadata": {
"model": {
"timeRange": {
"value": {
"relative": {
"duration": 24,
"timeUnit": 1
}
},
"type": "MsPortalFx.Composition.Configuration.ValueTypes.TimeRange"
}
}
}
},
"name": "Simple VM Dashboard",
"type": "Microsoft.Portal/dashboards",
"location": "INSERT LOCATION",
"tags": {
"hidden-title": "Simple VM Dashboard"
},
"apiVersion": "2015-08-01-preview"
}
Ortak kaynak özellikleri
Şimdi JSON'un ilgili bölümlerini ayıralım. Ortak kaynak özellikleri yukarıdaki örneğin sonuna yakın bir şekilde görünür. Bu özellikler tüm Azure kaynak türlerinde paylaşılır. Bunlar özellikle panonun içeriğiyle ilgili değildir.
ID
, ID Azure kaynaklarını adlandırma kurallarına tabi olarak panonun Azure kaynak kimliğini temsil eder. Portal bir pano oluşturduğunda genellikle guid biçiminde bir kimlik seçer, ancak program aracılığıyla bir pano oluşturduğunuzda geçerli herhangi bir adı kullanabilirsiniz.
Azure portal bir panoyu dışarı aktardığınızda, id alan dahil değildir. Alanını içeren id bir JSON dosyasını içeri aktararak yeni bir pano oluşturursanız, değer yoksayılır ve her yeni panoya yeni bir kimlik değeri atanır.
Name
Azure portal pano için kullandığı kaynak adı.
Tür
Tüm panolar türündedir Microsoft.Portal/dashboards.
Konum
Diğer kaynaklardan farklı olarak panoların çalışma zamanı bileşeni yoktur. Panolar için "konum", panonun JSON gösterimini depolayan birincil coğrafi konumu gösterir. Değer, abonelik kaynağındaki konumlar API'sini kullanarak getirilebilen konum kodlarından biri olmalıdır.
Etiketler
Etiketler, Azure kaynaklarının kaynağınızı rastgele ad değer çiftlerine göre düzenlemenize olanak sağlayan yaygın bir özelliğidir. Panolar adlı hidden-titleözel bir etiket içerir. Panonuzda bu özellik doldurulmuşsa bu değer portalda panonuzun görünen adı olarak kullanılır. Bu etiket, panonuz için yeniden adlandırılabilir bir görünen ada sahip olmak için size bir yol sağlar
Özellikler
properties nesnesi ve metadataadlı iki özellik lenses içerir. özelliği panodaki lenses kutucuklar hakkında bilgi içerir. Tesis metadata , gelecekteki olası özellikler için ayrılmıştır.
Lens -ler
lenses özelliği panoyu içerir. Bu örnekteki lens nesnesi "0" adlı tek bir özellik içerir. Lensler şu anda uygulanmamış bir gruplandırma kavramıdır. Şimdilik tüm panolarınızın lens nesnesinde bu tek "0" özelliği vardır.
Bölümler
"0" öğesinin altındaki nesne iki özellik order içerir ve parts. order Şu anda her zaman 0 olarak ayarlanmıştır. özelliği, parts panodaki tek tek bölümleri (kutucuklar olarak da adlandırılır) tanımlayan bir nesne içerir.
parts nesnesi, her parça için bir özellik içerir ve burada özelliğin adı bir sayıdır. Sayı önemli değil.
Tek tek her parça nesnesi ve metadataiçerirposition.
Position
position özelliği, , y, rowSpanve olarak xifade edilen bölümün boyut ve colSpankonum bilgilerini içerir. Değerler kılavuz birimleri cinsindendir. Pano burada gösterildiği gibi özelleştirme modundayken bu kılavuz birimleri görünür.
Örneğin, bir kutucuğun iki kılavuz birimi genişliğine, bir kılavuz biriminin yüksekliğine ve panonun sol üst köşesinde bir konuma sahip olmasını istiyorsanız konum nesnesi şöyle görünür:
position: { x: 0, y: 0, rowSpan: 2, colSpan: 1 }
Meta Veriler
Her bölümün bir meta veri özelliği vardır. Nesnenin yalnızca bir gerekli özelliği vardır: type. Bu dize portala hangi kutucuk türünün göstereceğini söyler. Örnek panomuzda şu kutucuk türleri kullanılır:
Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart– İzleme ölçümlerini göstermek için kullanılırExtension[azure]/HubsExtension/PartType/MarkdownPart– Listeler, bağlantılar vb. için temel biçimlendirmeye sahip metin veya resim gibi özelleştirilmiş markdown içeriğini göstermek için kullanılır.Extension[azure]/HubsExtension/PartType/VideoPart– YouTube, Kanal 9 ve HTML video etiketinde çalışan diğer video türlerini göstermek için kullanılır.
Her parça türünün yapılandırma için kendi seçenekleri vardır. Olası yapılandırma özellikleri , settingsve assetolarak adlandırılırinputs.
Girişler
Inputs nesnesi genellikle bir kutucuğu kaynak örneğine bağlayan bilgiler içerir.
Örneğimizdeki her MetricsChartPart biri, vm'nin Azure kaynak kimliğini ve görüntülenen verilerle ilgili bilgileri temsil eden bağlanacak kaynağı ifade eden tek bir girişe sahiptir. Örneğin, kutucuğun inputsNetwork In Total ve Network Out Total ölçümlerini gösteren nesnesi aşağıda verilmiştir.
"inputs":
[
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Network In Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Network Out Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
]
Ayarlar
settings nesnesi bir parçanın yapılandırılabilir öğelerini içerir. Örnek panomuzda Markdown bölümü, özel markdown içeriğinin yanı sıra yapılandırılabilir bir başlık ve alt başlık depolamak için ayarları kullanır.
"settings": {
"content": {
"settings": {
"content": "This is the team dashboard for the test VM we use on our team. Here are some useful links:\r\n\r\n1. [Create a Linux virtual machine](https://docs.microsoft.com/azure/virtual-machines/linux/quick-create-portal)\r\n1. [Create a Windows virtual machine](https://docs.microsoft.com/azure/virtual-machines/windows/quick-create-portal)\r\n1. [Create a virtual machine scale set](https://docs.microsoft.com/azure/virtual-machine-scale-sets/quick-create-portal)",
"title": "Test VM Dashboard",
"subtitle": "Contoso"
}
}
}
Benzer şekilde, video kutucuğunun yürütülecek videonun işaretçisini, otomatik yürütme ayarını ve isteğe bağlı başlık bilgilerini içeren kendi ayarları vardır.
"settings": {
"content": {
"settings": {
"src": "https://www.youtube.com/watch?v=rOiSRkxtTeU",
"autoplay": false
}
}
}
Varlık
Birinci sınıf yönetilebilir portal nesnelerine (varlıklar olarak adlandırılır) bağlı kutucuklar, nesne aracılığıyla asset ifade edilen bu ilişkiye sahiptir. Örnek panomuzda sanal makine kutucuğu bu varlık açıklamasını içerir. idInputName özelliği portala kimlik girişinin varlığın benzersiz tanımlayıcısını (bu durumda kaynak kimliğini) içerdiğini söyler. Çoğu Azure kaynak türünün portalda tanımlanmış varlıkları vardır.
"asset": { "idInputName": "id", "type": "VirtualMachine" }
Sonraki adımlar
- Azure portal veya program aracılığıyla pano oluşturmayı öğrenin.
- Özel içeriği göstermek için Azure panolarında markdown kutucuklarını kullanmayı öğrenin.