Bagikan melalui

Panduan REST API pemantauan Azure

  • Artikel

Artikel ini memperlihatkan kepada Anda cara menggunakan referensi REST API Azure Monitor.

Ambil definisi metrik, nilai dimensi, dan nilai metrik menggunakan AZURE Monitor API dan gunakan data di aplikasi Anda, atau simpan dalam database untuk analisis. Anda juga dapat mencantumkan aturan pemberitahuan dan melihat log aktivitas menggunakan AZURE Monitor API.

Mengautentikasi permintaan Azure Monitor

Permintaan yang dikirimkan menggunakan Azure Monitor API menggunakan model autentikasi Azure Resource Manager. Semua permintaan diautentikasi dengan ID Microsoft Entra. Salah satu pendekatan untuk mengautentikasi aplikasi klien adalah membuat perwakilan layanan Microsoft Entra dan mengambil token autentikasi. Anda dapat membuat perwakilan layanan Microsoft Entra menggunakan portal Azure, CLI, atau PowerShell. Untuk informasi selengkapnya, lihat Mendaftarkan Aplikasi untuk meminta token otorisasi dan bekerja dengan API.

Mengambil token

Setelah Anda membuat perwakilan layanan, ambil token akses. Tentukan resource=https://management.azure.com dalam permintaan token.

Dapatkan token autentikasi menggunakan salah satu metode berikut:

  • CLI
  • REST API
  • SDK

Saat meminta token, Anda harus memberikan resource parameter. Parameter resource adalah URL sumber daya yang ingin Anda akses.

Sumber daya meliputi:

  • https://management.azure.com
  • https://api.loganalytics.io
  • https://monitoring.azure.com

Mendapatkan token menggunakan permintaan REST

Gunakan panggilan REST API berikut untuk mendapatkan token. Permintaan ini menggunakan ID klien dan rahasia klien untuk mengautentikasi permintaan. ID klien dan rahasia klien diperoleh saat Anda mendaftarkan aplikasi Anda dengan ID Microsoft Entra. Untuk informasi selengkapnya, lihat Mendaftarkan Aplikasi untuk meminta token otorisasi dan bekerja dengan API

curl -X POST 'https://login.microsoftonline.com/<tennant ID>/oauth2/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<your apps client ID>' \
--data-urlencode 'client_secret=<your apps client secret' \
--data-urlencode 'resource=https://monitoring.azure.com'

Isi respons muncul dalam format berikut:

{
    "token_type": "Bearer",
    "expires_in": "86399",
    "ext_expires_in": "86399",
    "expires_on": "1672826207",
    "not_before": "1672739507",
    "resource": "https://monitoring.azure.com",
    "access_token": "eyJ0eXAiOiJKV1Qi....gpHWoRzeDdVQd2OE3dNsLIvUIxQ"
}

Setelah mengautentikasi dan mengambil token, gunakan token akses di permintaan AZURE Monitor API Anda dengan menyertakan header 'Authorization: Bearer <access token>'

Catatan

Untuk informasi selengkapnya tentang bekerja dengan Azure REST API, lihat referensi Azure REST API.

Mengambil ID sumber daya

Menggunakan REST API memerlukan ID sumber daya dari sumber daya Azure target. ID sumber daya mengikuti pola berikut:

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/<provider>/<resource name>/

Misalnya

  • Azure IoT Hub: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Devices/IotHubs/<iot-hub-name>
  • Kumpulan Elastic SQL: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<pool-db>/elasticpools/<sql-pool-name>
  • Azure SQL Database (v12): /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<server-name>/databases/<database-name>
  • Azure Bus Layanan: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ServiceBus/<namespace>/<servicebus-name>
  • Azure Virtual Machine Scale Sets: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachineScaleSets/<vm-name>
  • Azure Virtual Machines: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines/<vm-name>
  • Azure Event Hubs: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.EventHub/namespaces/<eventhub-namespace>

Gunakan portal Azure, PowerShell, atau Azure CLI untuk menemukan ID sumber daya.

Untuk menemukan resourceID di portal, dari halaman gambaran umum sumber daya, pilih tampilan JSONCuplikan layar memperlihatkan halaman gambaran umum untuk sumber daya dengan tautan tampilan JSON disorot.

Halaman JSON Sumber Daya ditampilkan. ID sumber daya dapat disalin menggunakan ikon di sebelah kanan ID.

Cuplikan layar memperlihatkan halaman JSON Sumber Daya untuk sumber daya.

Titik akhir API

Titik akhir API menggunakan pola berikut:
/<resource URI>/providers/microsoft.insights/<metrics|metricDefinitions>?api-version=<apiVersion>
resource URI Terdiri dari komponen-komponen berikut:
/subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/

Penting

Pastikan untuk menyertakan /providers/microsoft.insights/ setelah URI sumber daya saat Anda melakukan panggilan API untuk mengambil metrik atau definisi metrik.

Mengambil definisi metrik

Gunakan REST API Definisi Azure Monitor Metrics untuk mengakses daftar metrik yang tersedia untuk suatu layanan. Gunakan format permintaan berikut untuk mengambil definisi metrik.

GET /subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/providers/microsoft.insights/metricDefinitions?api-version=<apiVersion>
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Misalnya, Permintaan berikut mengambil definisi metrik untuk akun Azure Storage.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01'
--header 'Authorization: Bearer eyJ0eXAiOi...xYz

JSON berikut menunjukkan contoh isi respons. Dalam contoh ini, hanya metrik kedua yang memiliki dimensi.

{
    "value": [
        {
            "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/UsedCapacity",
            "resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Capacity",
            "name": {
                "value": "UsedCapacity",
                "localizedValue": "Used capacity"
            },
            "isDimensionRequired": false,
            "unit": "Bytes",
            "primaryAggregationType": "Average",
            "supportedAggregationTypes": [
                "Total",
                "Average",
                "Minimum",
                "Maximum"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                 ...
                {
                    "timeGrain": "PT12H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ]
        },
        {
            "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/Transactions",
            "resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Transaction",
            "name": {
                "value": "Transactions",
                "localizedValue": "Transactions"
            },
            "isDimensionRequired": false,
            "unit": "Count",
            "primaryAggregationType": "Total",
            "supportedAggregationTypes": [
                "Total"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT5M",
                    "retention": "P93D"
                },
                ...
                {
                    "timeGrain": "PT30M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                ...
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ],
            "dimensions": [
                {
                    "value": "ResponseType",
                    "localizedValue": "Response type"
                },
                {
                    "value": "GeoType",
                    "localizedValue": "Geo type"
                },
                {
                    "value": "ApiName",
                    "localizedValue": "API name"
                }
            ]
        },
        ...
    ]
}

Catatan

Sebaiknya gunakan API versi "01-01-2018" atau yang lebih baru. Versi LAMA api definisi metrik tidak mendukung dimensi.

Mengambil nilai dimensi

Setelah mengambil definisi metrik yang tersedia, ambil rentang nilai untuk dimensi metrik. Gunakan nilai dimensi untuk memfilter atau mengesegmentasi metrik dalam kueri Anda. Gunakan REST API Metrik Azure Monitor untuk menemukan semua nilai untuk dimensi metrik tertentu.

Gunakan elemen metrik name.value dalam definisi filter. Jika tidak ada filter yang ditentukan, metrik default akan dikembalikan. API hanya memungkinkan satu dimensi untuk memiliki filter kartubebas. Tentukan permintaan untuk nilai dimensi menggunakan "resultType=metadata" parameter kueri. dihilangkan resultType untuk permintaan nilai metrik.

Catatan

Untuk mengambil nilai dimensi dengan menggunakan REST API Azure Monitor, gunakan versi API "01-07-2019" atau yang lebih baru.

Gunakan format permintaan berikut untuk mengambil nilai dimensi.

GET /subscriptions/<subscription-id>/resourceGroups/  
<resource-group-name>/providers/<resource-provider-namespace>/  
<resource-type>/<resource-name>/providers/microsoft.insights/  
metrics?metricnames=<metric>  
&timespan=<starttime/endtime>  
&$filter=<filter>  
&resultType=metadata  
&api-version=<apiVersion>   HTTP/1.1
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Contoh berikut mengambil daftar nilai dimensi yang dipancarkan untuk API Name dimensi Transactions metrik, di mana GeoType dimensi memiliki nilai Primary, untuk rentang waktu yang ditentukan.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics  \
?metricnames=Transactions \
&timespan=2023-03-01T00:00:00Z/2023-03-02T00:00:00Z \
&resultType=metadata \
&$filter=GeoType eq \'Primary\' and ApiName eq \'*\' \
&api-version=2019-07-01'
-header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0e..meG1lWm9Y'

JSON berikut menunjukkan contoh isi respons.

{
  "timespan": "2023-03-01T00:00:00Z/2023-03-02T00:00:00Z",
  "value": [
    {
      "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "DeleteBlob"
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "SetBlobProperties"
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Mengambil nilai metrik

Setelah mengambil definisi metrik dan nilai dimensi, ambil nilai metrik. Gunakan REST API Azure Monitor Metrics untuk mengambil nilai metrik.

Gunakan elemen metrik name.value dalam definisi filter. Jika tidak ada filter dimensi yang ditentukan, metrik yang digulung, agregat dikembalikan.

Beberapa rangkaian waktu

Rangkaian waktu adalah sekumpulan titik data yang diurutkan menurut waktu untuk kombinasi dimensi tertentu. Dimensi adalah aspek metrik yang menjelaskan titik data seperti Id sumber daya, wilayah, atau ApiName.

  • Untuk mengambil beberapa deret waktu dengan nilai dimensi tertentu, tentukan parameter kueri filter yang menetapkan kedua nilai dimensi seperti "&$filter=ApiName eq 'ListContainers' or ApiName eq 'GetBlobServiceProperties'". Dalam contoh ini, Anda mendapatkan rangkaian waktu di mana ApiName adalah ListContainers dan rangkaian waktu kedua di mana ApiName adalah GetBlobServiceProperties.
  • Untuk mengembalikan deret waktu untuk setiap nilai dimensi tertentu, gunakan filter * seperti "&$filter=ApiName eq '*'". Top Gunakan parameter kueri dan OrderBy untuk membatasi dan mengurutkan jumlah rangkaian waktu yang dikembalikan. Dalam contoh ini, Anda mendapatkan rangkaian waktu untuk setiap nilai dalam tataan ApiNamehasil. Jika tidak ada data yang dikembalikan, API mengembalikan rangkaian "timeseries": []waktu kosong .

Catatan

Untuk mengambil nilai metrik multi-dimensi menggunakan REST API Azure Monitor, gunakan versi API "01-07-2019" atau yang lebih baru.

Gunakan format permintaan berikut untuk mengambil nilai metrik.

GET /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/<resource-provider-namespace>/<resource-type>/<resource-name>/providers/microsoft.insights/metrics?metricnames=<metric>&timespan=<starttime/endtime>&$filter=<filter>&interval=<timeGrain>&aggregation=<aggreation>&api-version=<apiVersion>
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Contoh berikut mengambil tiga API teratas, dengan jumlah Transactions dalam urutan nilai menurun, selama rentang 5 menit, di mana GeoType dimensi memiliki nilai Primary.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics \
?metricnames=Transactions \
&timespan=2023-03-01T02:00:00Z/2023-03-01T02:05:00Z \
& $filter=apiname eq '\''GetBlobProperties'\'
&interval=PT1M \
&aggregation=Total  \
&top=3 \
&orderby=Total desc \
&api-version=2019-07-01"' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer yJ0eXAiOi...g1dCI6Ii1LS'

JSON berikut menunjukkan contoh isi respons.

{
  "cost": 0,
  "timespan": "2023-03-01T02:00:00Z/2023-03-01T02:05:00Z",
  "interval": "PT1M",
  "value": [
    {
      "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "GetBlobProperties"
            }
          ],
          "data": [
            {
              "timeStamp": "2023-09-19T02:00:00Z",
              "total": 2
            },
            {
              "timeStamp": "2023-09-19T02:01:00Z",
              "total": 1
            },
            {
              "timeStamp": "2023-09-19T02:02:00Z",
              "total": 3
            },
            {
              "timeStamp": "2023-09-19T02:03:00Z",
              "total": 7
            },
            {
              "timeStamp": "2023-09-19T02:04:00Z",
              "total": 2
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Mengkueri metrik untuk beberapa sumber daya pada satu waktu.

Selain mengkueri metrik pada sumber daya individual, beberapa jenis sumber daya juga mendukung kueri untuk beberapa sumber daya dalam satu permintaan. API inilah yang mendukung pengalaman Multi-Sumber Daya di penjelajah metrik Azure. Kumpulan jenis sumber daya yang mendukung kueri untuk beberapa metrik dapat dilihat pada bilah Metrik di azure monitor melalui drop-down jenis sumber daya di pemilih cakupan pada bilah konteks. Untuk informasi selengkapnya, lihat dokumentasi UX Multi-Sumber Daya.

Ada beberapa perbedaan penting antara metrik kueri untuk beberapa sumber daya dan individu.

  • API multi-sumber daya metrik beroperasi di tingkat langganan alih-alih tingkat ID sumber daya. Pembatasan ini berarti pengguna yang mengkueri API ini harus memiliki izin Pembaca Pemantauan pada langganan itu sendiri.
  • API multi-sumber daya metrik hanya mendukung satu resourceType per kueri, yang harus ditentukan dalam bentuk parameter kueri namespace metrik.
  • API multi-sumber daya metrik hanya mendukung satu wilayah Azure per kueri, yang harus ditentukan dalam bentuk parameter kueri wilayah.

Mengkueri metrik untuk beberapa contoh sumber daya

Contoh berikut menunjukkan permintaan definisi metrik individual:

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1/providers/microsoft.insights/metricdefinitions?api-version=2021-05-01

Permintaan berikut menunjukkan permintaan definisi metrik yang setara untuk beberapa sumber daya. Satu-satunya perubahan adalah jalur langganan alih-alih jalur ID sumber daya, dan penambahan region parameter kueri dan metricNamespace .

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/metricdefinitions?api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines

Contoh berikut menunjukkan permintaan metrik individual.

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01

Di bawah ini adalah permintaan metrik yang setara untuk beberapa sumber daya:

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines&$filter=Microsoft.ResourceId eq '*'

Catatan

Microsoft.ResourceId eq '*' Filter ditambahkan dalam contoh untuk permintaan metrik multi sumber daya. * Filter memberi tahu API untuk mengembalikan rangkaian waktu terpisah untuk setiap sumber daya komputer virtual yang memiliki data di langganan dan wilayah. Tanpa filter, API akan mengembalikan satu rangkaian waktu yang menggabungkan CPU rata-rata untuk semua VM. Rangkaian waktu untuk setiap sumber daya dibingkai oleh Microsoft.ResourceId nilai metadata pada setiap entri rangkaian waktu, seperti yang dapat dilihat dalam nilai pengembalian sampel berikut. Jika tidak ada resourceId yang diambil oleh kueri ini, rangkaian"timeseries": [] waktu kosong dikembalikan.

{
    "timespan": "2023-06-25T22:35:00Z/2023-06-26T22:40:00Z",
    "interval": "PT6H",
    "value": [
        {
            "id": "subscriptions/12345678-abcd-98765432-abcdef012345/providers/Microsoft.Insights/metrics/Percentage CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "displayDescription": "The percentage of allocated compute units that are currently in use by the Virtual Machine(s)",
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 3.2618888888888886
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 4.696944444444445
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 6.19701388888889
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 2.630347222222222
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 21.288999999999998
                        }
                    ]
                },
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM2"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 7.567069444444444
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 5.111835883171071
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 10.078277777777778
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 8.399097222222222
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 2.647
                        }
                    ]
                },
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/Common-TESTING/providers/Microsoft.Compute/virtualMachines/CommonVM1"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 6.892319444444444
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 3.5054305555555554
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 8.398817802503476
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 6.841666666666667
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 3.3850000000000002
                        }
                    ]
                }
            ],
            "errorCode": "Success"
        }
    ],
    "namespace": "microsoft.compute/virtualmachines",
    "resourceregion": "eastus"
}

Pemecahan masalah metrik kueri untuk beberapa sumber daya

  • Rangkaian waktu kosong dikembalikan "timeseries": []

    • Rangkaian waktu kosong dikembalikan ketika tidak ada data yang tersedia untuk rentang waktu dan filter yang ditentukan. Penyebab paling umum adalah menentukan rentang waktu yang tidak berisi data apa pun. Misalnya, jika rentang waktu diatur ke tanggal mendatang.
    • Penyebab umum lainnya adalah menentukan filter yang tidak cocok dengan sumber daya apa pun. Misalnya, jika filter menentukan nilai dimensi yang tidak ada pada sumber daya apa pun dalam kombinasi langganan dan wilayah, "timeseries": [] dikembalikan.

  • Filter kartubebas
    Menggunakan filter kartubebas seperti Microsoft.ResourceId eq '*' menyebabkan API mengembalikan rangkaian waktu untuk setiap resourceId di langganan dan wilayah. Jika kombinasi langganan dan wilayah tidak berisi sumber daya, rangkaian waktu kosong dikembalikan. Kueri yang sama tanpa filter kartubebas akan mengembalikan satu rangkaian waktu, menggabungkan metrik yang diminta melalui dimensi yang diminta, misalnya langganan dan wilayah.

  • Kesalahan otorisasi 401:
    API metrik sumber daya individual mengharuskan pengguna memiliki izin Pembaca Pemantauan pada sumber daya yang sedang dikueri . Karena API metrik multi sumber daya adalah API tingkat langganan, pengguna harus memiliki izin Pembaca Pemantauan untuk langganan yang dikueri untuk menggunakan API metrik multi sumber daya. Bahkan jika pengguna memiliki Pembaca Pemantauan pada semua sumber daya dalam langganan, permintaan gagal jika pengguna tidak memiliki Pembaca Pemantauan pada langganan itu sendiri.

Langkah berikutnya