Alerts - Get Summary

Referensi

Service:: Monitor

API Version:: 2019-03-01

Dapatkan jumlah ringkasan pemberitahuan Anda yang dikelompokkan menurut berbagai parameter (misalnya pengelompokan menurut 'Tingkat Keparahan' mengembalikan jumlah pemberitahuan untuk setiap tingkat keparahan).

GET https://management.azure.com/{scope}/providers/Microsoft.AlertsManagement/alertsSummary?groupby={groupby}&api-version=2019-03-01

With optional parameters:

GET https://management.azure.com/{scope}/providers/Microsoft.AlertsManagement/alertsSummary?groupby={groupby}&includeSmartGroupsCount={includeSmartGroupsCount}&targetResource={targetResource}&targetResourceType={targetResourceType}&targetResourceGroup={targetResourceGroup}&monitorService={monitorService}&monitorCondition={monitorCondition}&severity={severity}&alertState={alertState}&alertRule={alertRule}&timeRange={timeRange}&customTimeRange={customTimeRange}&api-version=2019-03-01

Parameter URI

Name	In	Required	Type	Description
scope	path	True	string	cakupan di sini adalah resourceId yang pemberitahuannya dibuat.
api-version	query	True	api-version	Versi API.
groupby	query	True	AlertsSummaryGroupByFields	Parameter ini memungkinkan tataan hasil dikelompokkan menurut bidang input. Misalnya, groupby=severity,alertstate.
alertRule	query		string	Filter menurut aturan pemberitahuan tertentu. Nilai defaultnya adalah memilih semua.
alertState	query		AlertState	Filter menurut status instans pemberitahuan. Nilai defaultnya adalah memilih semua.
customTimeRange	query		string	Filter menurut rentang waktu kustom dalam format / di mana waktu berada dalam (format ISO-8601)'. Nilai yang diizinkan dalam waktu 30 hari sejak waktu kueri. TimeRange atau customTimeRange dapat digunakan tetapi tidak keduanya. Defaultnya adalah tidak ada.
includeSmartGroupsCount	query		boolean	Sertakan jumlah SmartGroups sebagai bagian dari ringkasan. Nilai defaultnya adalah 'false'.
monitorCondition	query		MonitorCondition	Filter menurut kondisi monitor yang 'Diaktifkan' atau 'Diselesaikan'. Nilai defaultnya adalah memilih semua.
monitorService	query		MonitorService	Filter menurut layanan monitor yang menghasilkan instans pemberitahuan. Nilai defaultnya adalah pilih semua.
severity	query		Severity	Filter menurut tingkat keparahan. Nilai defaultnya adalah pilih semua.
targetResource	query		string	Filter menurut sumber daya target( yang merupakan ARM ID lengkap) Nilai default adalah pilih semua.
targetResourceGroup	query		string	Filter menurut nama grup sumber daya target. Nilai defaultnya adalah pilih semua.
targetResourceType	query		string	Filter menurut jenis sumber daya target. Nilai defaultnya adalah pilih semua.
timeRange	query		TimeRange	Filter menurut rentang waktu menurut nilai yang tercantum di bawah ini. Nilai defaultnya adalah 1 hari.

Respons

Name	Type	Description
200 OK	alertsSummary	OK. Ringkasan pemberitahuan dikembalikan.
Other Status Codes	AlertsManagementErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Contoh

Summary

Sample Request

HTTP

GET https://management.azure.com/subscriptions/1e3ff1c0-771a-4119-a03b-be82a51e232d/providers/Microsoft.AlertsManagement/alertsSummary?groupby=severity,alertState&api-version=2019-03-01

Sample Response

Status code:: 200

{
  "properties": {
    "groupedby": "severity",
    "smartGroupsCount": 100,
    "total": 14189,
    "values": [
      {
        "name": "Sev0",
        "count": 6517,
        "groupedby": "alertState",
        "values": [
          {
            "name": "New",
            "count": 6517
          },
          {
            "name": "Acknowledged",
            "count": 0
          },
          {
            "name": "Closed",
            "count": 0
          }
        ]
      },
      {
        "name": "Sev1",
        "count": 3175,
        "groupedby": "alertState",
        "values": [
          {
            "name": "New",
            "count": 3175
          },
          {
            "name": "Acknowledged",
            "count": 0
          },
          {
            "name": "Closed",
            "count": 0
          }
        ]
      },
      {
        "name": "Sev2",
        "count": 1120,
        "groupedby": "alertState",
        "values": [
          {
            "name": "New",
            "count": 1120
          },
          {
            "name": "Acknowledged",
            "count": 0
          },
          {
            "name": "Closed",
            "count": 0
          }
        ]
      },
      {
        "name": "Sev3",
        "count": 1902,
        "groupedby": "alertState",
        "values": [
          {
            "name": "New",
            "count": 1902
          },
          {
            "name": "Acknowledged",
            "count": 0
          },
          {
            "name": "Closed",
            "count": 0
          }
        ]
      },
      {
        "name": "Sev4",
        "count": 1475,
        "groupedby": "alertState",
        "values": [
          {
            "name": "New",
            "count": 1475
          },
          {
            "name": "Acknowledged",
            "count": 0
          },
          {
            "name": "Closed",
            "count": 0
          }
        ]
      }
    ]
  },
  "id": "/subscriptions/1e3ff1c0-771a-4119-a03b-be82a51e232d/providers/Microsoft.AlertsManagement/alertsSummary/current",
  "type": "Microsoft.AlertsManagement/alertsSummary",
  "name": "current"
}

Definisi

AlertsManagementErrorResponse	Respons kesalahan dari layanan.
alertsSummary	Ringkasan pemberitahuan berdasarkan filter input dan parameter 'groupby'.
alertsSummaryGroup	Kelompokkan kumpulan hasil.
AlertsSummaryGroupByFields	Parameter ini memungkinkan tataan hasil dikelompokkan menurut bidang input. Misalnya, groupby=severity,alertstate.
alertsSummaryGroupItem	Item grup ringkasan pemberitahuan
AlertState	Status objek pemberitahuan, yang dapat dimodifikasi oleh pengguna.
api-version	Versi API.
errorResponseBody	Detail respons kesalahan.
MonitorCondition	Dapat berupa 'Diaktifkan' atau 'Diselesaikan', yang mewakili apakah kondisi yang mendasarinya telah melewati ambang batas aturan pemberitahuan yang ditentukan.
MonitorService	Layanan pemantauan tempat aturan (monitor) diatur.
Severity	Tingkat keparahan pemberitahuan Sev0 tertinggi dan Sev4 terendah.
TimeRange	Filter menurut rentang waktu menurut nilai yang tercantum di bawah ini. Nilai defaultnya adalah 1 hari.

AlertsManagementErrorResponse

Respons kesalahan dari layanan.

Name	Type	Description
error	errorResponseBody	Detail respons kesalahan.

alertsSummary

Ringkasan pemberitahuan berdasarkan filter input dan parameter 'groupby'.

Name	Type	Description
id	string	Id sumber daya Azure
name	string	Nama sumber daya Azure
properties	alertsSummaryGroup	Kelompokkan kumpulan hasil.
type	string	Jenis sumber daya Azure

alertsSummaryGroup

Kelompokkan kumpulan hasil.

Name	Type	Description
groupedby	string	Nama bidang yang diagregasi
smartGroupsCount	integer	Jumlah total grup pintar.
total	integer	Jumlah total kumpulan hasil.
values	alertsSummaryGroupItem[]	Daftar item

AlertsSummaryGroupByFields

Parameter ini memungkinkan tataan hasil dikelompokkan menurut bidang input. Misalnya, groupby=severity,alertstate.

Name	Type	Description
alertRule	string
alertState	string
monitorCondition	string
monitorService	string
severity	string
signalType	string

alertsSummaryGroupItem

Item grup ringkasan pemberitahuan

Name	Type	Description
count	integer	Jumlah bidang agregat
groupedby	string	Nama bidang yang diagregasi
name	string	Nilai bidang agregat
values	alertsSummaryGroupItem[]	Daftar item

AlertState

Status objek pemberitahuan, yang dapat dimodifikasi oleh pengguna.

Name	Type	Description
Acknowledged	string
Closed	string
New	string

api-version

Versi API.

Name	Type	Description
2018-05-05	string

errorResponseBody

Detail respons kesalahan.

Name	Type	Description
code	string	Kode kesalahan, dimaksudkan untuk dikonsumsi secara terprogram.
details	errorResponseBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Deskripsi kesalahan, ditujukan untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu, misalnya nama properti.

MonitorCondition

Dapat berupa 'Diaktifkan' atau 'Diselesaikan', yang mewakili apakah kondisi yang mendasarinya telah melewati ambang batas aturan pemberitahuan yang ditentukan.

Name	Type	Description
Fired	string
Resolved	string

MonitorService

Layanan pemantauan tempat aturan (monitor) diatur.

Name	Type	Description
ActivityLog Administrative	string
ActivityLog Autoscale	string
ActivityLog Policy	string
ActivityLog Recommendation	string
ActivityLog Security	string
Application Insights	string
Log Analytics	string
Nagios	string
Platform	string
Resource Health	string
SCOM	string
ServiceHealth	string
SmartDetector	string
VM Insights	string
Zabbix	string

Severity

Tingkat keparahan pemberitahuan Sev0 tertinggi dan Sev4 terendah.

Name	Type	Description
Sev0	string
Sev1	string
Sev2	string
Sev3	string
Sev4	string

TimeRange

Filter menurut rentang waktu menurut nilai yang tercantum di bawah ini. Nilai defaultnya adalah 1 hari.

Name	Type	Description
1d	string
1h	string
30d	string
7d	string