Анализ использования Azure Stack с помощью локальных счетчиков использования — модульный центр обработки данных (MDC)

Статья
07/12/2023

Сведения о том, какие подписки используют, какие ресурсы хранятся в локальной базе данных об использовании. Администраторы могут получить эти данные, чтобы проанализировать, какие пользователи потребляют ресурсы.

Справка о вызовах API

Запрос

Запрос возвращает сведения о потреблении для указанной подписки и указанного периода времени. Запрос не содержит текст.

Этот API использования является API поставщика, поэтому вызывающему объекту должна быть назначена роль владельца, участника или читателя в подписке поставщика.

Метод	Универсальный код ресурса (URI) запроса
GET	`https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}`

Аргументы

Аргумент	Описание
`armendpoint`	Конечная точка Azure Resource Manager среды Azure Stack. В соответствии с соглашением Azure Stack имя конечной точки Azure Resource Manager должно быть в формате `https://adminmanagement.{domain-name}`.
`subId`	Идентификатор подписки пользователя, который выполняет вызов.
`reportedStartTime`	Время начала выполнения запроса. Значение `DateTime` должно быть в формате UTC и соответствовать началу нужного часа (например, 13:00). Для сбора сведений за сутки это значение должно соответствовать полуночи в формате UTC. В этом формате используется экранирование символов ISO 8601. Например, значение `2015-06-16T18%3a53%3a11%2b00%3a00Z` можно использовать в составе URI, так как символ двоеточия преобразован в `%3a`, а плюс — в `%2b`.
`reportedEndTime`	Время завершения выполнения запроса. Действуют те же ограничения, что и для аргумента `reportedStartTime`. Значение `reportedEndTime` не может относиться ни к будущему, ни к текущему дню. В противном случае возвращается результат "Обработка не завершена".
`aggregationGranularity`	Необязательный параметр, имеющий два дискретных потенциальных значения: ежедневное и ежечасное. Эти значения возвращают данные с разной степенью детализации: за сутки и за час. По умолчанию используется параметр daily .
`subscriberId`	Идентификатор подписки. Чтобы получить отфильтрованные данные, нужно указать идентификатор подписки для прямого клиента поставщика. Если идентификатор подписки не указан, вызов возвращает данные об использовании для всех прямых клиентов поставщика.
`api-version`	Версия протокола, который используется для выполнения этого запроса. Этот параметр имеет значение `2015-06-01-preview`.
`continuationToken`	Маркер, полученный из последнего вызова к API использования для поставщиков. Этот маркер требуется, когда ответ превышает 1000 строк. Он служит закладкой в процессе выполнения. Если маркер отсутствует, данные извлекаются с начала суток или часа, в зависимости от указанного уровня детализации.

Ответ

GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0

{
"value": [
{

"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-

meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",

"properties": {
"subscriptionId":"sub1.1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"

}
},

. . .

Сведения об ответе

Аргумент	Описание
`id`	Уникальный идентификатор статистического выражения использования.
`name`	Имя статистического выражения использования.
`type`	Определение ресурса.
`subscriptionId`	Идентификатор подписки пользователя Azure Stack.
`usageStartTime`	Начальное время включения в контейнер использования, к которому относится статистическое выражение использования (в формате UTC).
`usageEndTime`	Конечное время включения в контейнер использования, к которому относится статистическое выражение использования (в формате UTC).
`instanceData`	Пары "ключ-значение" из сведений об экземпляре (в новом формате): `resourceUri`: полный идентификатор ресурса, включающий группы ресурсов и имя экземпляра. `location`: регион, в котором была запущена эта служба. `tags`: теги ресурсов, указанные пользователем. `additionalInfo`: дополнительные сведения об используемом ресурсе; например, версия ОС или тип образа.
`quantity`	Объем потребления ресурса за указанный промежуток времени.
`meterId`	Уникальный идентификатор использованного ресурса (также обозначается `ResourceID`).

Получение сведений о потреблении

PowerShell

Чтобы данные об использовании создавались, должны существовать активно работающие ресурсы, например, действующая виртуальная машина или учетная запись хранения, содержащая некоторые данные. Если вы не знаете, есть ли у вас активные ресурсы в Azure Stack Marketplace, разверните виртуальную машину, откройте для нее колонку мониторинга и проверьте, выполняется ли виртуальная машина. Используйте следующие командлеты PowerShell для просмотра данных об использовании.

Модули Az
Модули AzureRM.

Установите PowerShell для Azure Stack.
Настройка пользователя или оператора Azure Stack в среде PowerShell.
Чтобы получить данные об использовании, вызовите PowerShell Get-AzsSubscriberUsage.
```
Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
```

Установите PowerShell для Azure Stack.
Настройка пользователя или оператора Azure Stack в среде PowerShell.
Чтобы получить данные об использовании, вызовите PowerShell Get-AzsSubscriberUsage.
```
Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
```

REST API

Вы можете собирать сведения об использовании для удаленных подписок путем вызова службы Microsoft.Commerce.Admin.

Возврат данных об использовании по всем клиентам для удаленных подписок для активных пользователей

Метод	Универсальный код ресурса (URI) запроса
GET	`https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview`

Возврат данных об использовании по удаленному или активному клиенту

Метод	Универсальный код ресурса (URI) запроса
GET	`https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview`