Подключение к Azure Consumption Insights в Power BI Desktop (бета-версия)Connect to Azure Consumption Insights in Power BI Desktop (Beta)

С помощью соединителя Azure Consumption Insights можно использовать Power BI Desktop для подключения к Azure и получения подробных данных и сведений об использовании служб Azure в организации.With the Azure Consumption Insights connector, you can use Power BI Desktop to connect to Azure and get in-depth data and information about your organization's Azure services usage. Можно также создавать меры, настраиваемые столбцы и визуальные элементы для формирования отчетов об использовании Azure в организации и предоставления доступа к ним.You can also create measures, custom columns, and visuals to report and share about your organization's Azure usage. Этот выпуск соединителя Azure Consumption Insights является бета-версией, которая может быть изменена.This release of the Azure Consumption and Insights connector is in Beta, and is subject to change.

Из этой статье вы узнаете, как подключиться к Azure с помощью соединителя Azure Consumption Insights и получить необходимые данные, выполнить миграцию из соединителя Azure Enterprise и найти сопоставление столбцов со сведениями об использовании в API ACI (Azure Consumption Insights).In this article, you learn how to connect using the Azure Consumption Insights connector and get the data you need, how to migrate from using the Azure Enterprise Connector, and you'll find a mapping of usage details columns available in the ACI (Azure Consumption Insights) API.

Подключение к Azure Consumption InsightsConnect to Azure Consumption Insights

Чтобы подключиться к Azure с помощью соединителя Azure Consumption Insights, нужен доступ к функциям Enterprise на портале Azure.To successfully connect using the Azure Consumption Insights connector, you need to have access to the Enterprise features within the Azure portal.

Чтобы подключиться с помощью соединителя Azure Consumption Insights, в Power BI Desktop на ленте Главная выберите элемент Получение данных.To connect using the Azure Consumption Insights connector, select Get Data from the Home ribbon in Power BI Desktop. Выберите слева категорию Веб-службы. В списке справа вы увидите Microsoft Azure Consumption Insights (бета-версия).Select Online Services from the categories on the left, and you see Microsoft Azure Consumption Insights (Beta). Нажмите кнопку Подключиться.Select Connect.

В открывшемся диалоговом окне укажите свой номер регистрации.In the dialog that appears, provide your Enrollment Number.

  • Номер регистрации можно найти на портале Azure Enterprise Portal в расположении, которое показано на следующем рисунке:You can get your enrollment number from the Azure Enterprise Portal, in the location shown in the following image:

    Эта версия соединителя поддерживает только корпоративные регистрации с https://ea.azure.com.This version of the connector only supports enterprise enrollments from https://ea.azure.com. Регистрации из Китая сейчас не поддерживаются.China enrollments are not currently supported.

Теперь введите свой ключ доступа для подключения.Next, provide your Access key to connect.

Когда вы введете ключ доступа и нажмете кнопку Подключиться, откроется окно навигатора с четырьмя таблицами: Сводка, Использование, Прайс-лист и MarketPlace.Once you provide your Access key and select Connect, a Navigator window appears and shows the four tables available to you: Summary, Usage, PriceSheet, and MarketPlace. Чтобы просмотреть сведения, установите флажок возле соответствующей таблицы.You can select a checkbox beside any table to see a preview. Чтобы выбрать одну или несколько таблиц, установите флажок рядом с именем таблицы, а затем нажмите кнопку Загрузить.You can select one or more tables by checking the box beside their name, then select Load.

Примечание

Таблицы Сводка и Прайс-лист доступны только для уровня регистрации ключа API.The Summary and PriceSheet tables are only available for the enrollment-level API Key. По умолчанию таблицы Использование и Прайс-лист содержат данные за текущий месяц.Also, the data in these tables has, by default, the current month's data for Usage and PriceSheet. Данные в таблицах Сводка и MarketPlace не ограничены текущим месяцем.The Summary and MarketPlace tables are not constrained to the current month.

После нажатия кнопки Загрузить данные загружаются в Power BI Desktop.When you select Load the data is loaded into Power BI Desktop.

Когда выбранные данные будут загружены, соответствующие таблицы и поля отобразятся в области Поля.Once the data you selected is loaded, the tables and fields you selected can be seen in the Fields pane.

Использование Azure Consumption InsightsUsing Azure Consumption Insights

Чтобы использовать соединитель Azure Consumption Insights, нужен доступ к функциям Enterprise на портале Azure.To use the Azure Consumption Insights connector, you need to have access to the Enterprise features within the Azure portal.

После загрузки данных с помощью соединителя Azure Consumption Insights вы можете создать собственные пользовательские меры и столбцы с помощью редактора запросов. Вы также можете создать визуальные элементы, отчеты и панели мониторинга, к которым вы можете предоставлять доступ в службе Power BI.Once you successfully load data using the Azure Consumption Insights connector, you can create your own custom measures and columns using Query Editor, and you can create visuals, reports, and dashboards that you can share in the Power BI service.

Azure также включает коллекцию примеров пользовательских запросов, которые можно извлечь с помощью пустого запроса.Azure also includes a collection of sample custom queries that you can retrieve using a blank query. Чтобы сделать это, в Power BI Desktop на вкладке Главная выберите стрелку раскрывающегося списка Получение данных, а затем выберите Пустой запрос.To do so, in the Home ribbon of Power BI Desktop, select the drop down arrow in Get Data and then select Blank Query. Это также можно сделать в редакторе запросов: щелкните правой кнопкой мыши область Запросы слева и в открывшемся меню выберите элементы Новый запрос > Пустой запрос.You can also do this in Query Editor by right-clicking in the Queries pane along the left, and selecting New Query > Blank Query from the menu that appears.

В строке формул введите следующее:In the Formula bar, type the following:

= MicrosoftAzureConsumptionInsights.Contents

Открывается коллекция примеров, как показано на следующем рисунке:A collection of samples appear, as shown in the following image:

При работе с отчетами и создании запросов используйте следующие параметры:When working with reports and creating queries, use the following:

  • Чтобы определить число месяцев начиная с текущей даты, используйте параметр numberOfMonth.To define the number of months starting from the current date, use numberOfMonth
    • Чтобы указать число месяцев с текущей даты, данные которых требуется импортировать, используйте значение от 1 до 36.Use a value between one and 36 to represent the number of months, from the current date, you want to import. Рекомендуем выбирать не более 12 месяцев данных, чтобы не превысить пороговые значения ограничений импорта и допустимого объема данных для запросов в Power BI.We recommend getting no more than 12 months of data to avoid thresholds with import constraints and the volume of data allowed for queries in Power BI.
  • Чтобы определить число месяцев в окне времени журнала, используйте параметры startBillingDataWindow и endBillingDataWindow.To define a period of months in a historical time window, use startBillingDataWindow and endBillingDataWindow
  • Не используйте параметр numberOfMonth вместе с параметрами startBillingDataWindow и endBillingDataWindow.Do not use numberOfMonth together with startBillingDataWindow or endBillingDataWindow

Миграция из соединителя Azure EnterpriseMigrating from the Azure Enterprise Connector

Некоторые пользователи создавали визуальные элементы с помощью соединителя Azure Enterprise (бета-версия), который рано или поздно перестанет поддерживаться и будет заменен соединителем Azure Consumption Insights.Some customers created visuals using the Azure Enterprise Connector (Beta), which will eventually be discontinued, and is being replaced by the Azure Consumption Insights connector. Соединитель Azure Consumption Insights содержит следующие функции и усовершенствования:The Azure Consumption Insights connector has features and enhancements that include the following:

  • Дополнительные источники данных для таблиц Сводка баланса и Покупки Marketplace.Additional data sources available for Balance Summary and Marketplace Purchases
  • Новые и расширенные параметры, такие как startBillingDataWindow и endBillingDataWindow.New and advanced parameters, such as startBillingDataWindow and endBillingDataWindow
  • Улучшенные производительность и скорость реагирования.Better performance and responsiveness

Ниже приведены инструкции, которые помогут клиентам перейти к использованию нового соединителя Azure Consumption Insights и сохранить все данные в пользовательских панелях мониторинга и отчетах.To help customers transition to the newer Azure Consumption Insights connector, and to preserve the work they've done in creating custom dashboards or reports, the following steps show how to move to the new connector.

Шаг 1. Подключение к Azure с помощью нового соединителяStep 1: Connect to Azure using the new connector

Сначала нужно подключиться к Azure с помощью соединителя Azure Consumption Insights. Эта процедура подробно описана ранее в этой статье.The first step is to connect using the Azure Consumption Insights connector, which was described earlier in this article in detail. В Power BI Desktop на ленте Главная последовательно выберите элементы Получение данных > Пустой запрос.In this step, select Get Data > Blank Query from the Home ribbon in Power BI Desktop.

Шаг 2. Создание запроса с помощью расширенного редактораStep 2: Use the Advanced Editor to create a query

В редакторе запросов на ленте Главная в разделе Запрос выберите Расширенный редактор.In Query Editor, select Advanced Editor from the Query section of the Home ribbon. В открывшемся окне Расширенный редактор введите следующий запрос:In the Advanced Editor window that appears, enter the following query:

let    
    enrollmentNumber = "100",
    optionalParameters = [ numberOfMonth = 6, dataType="DetailCharges" ],
    data = MicrosoftAzureConsumptionInsights.Contents(enrollmentNumber, optionalParameters)   
in     
    data

Разумеется, вам нужно заменить значение enrollmentNumber собственным номером регистрации, который можно найти на портале Azure Enterprise Portal.Of course, you'll need to replace the value of enrollmentNumber with your own enrollment number, which you can get from the Azure Enterprise Portal. Параметр numberOfMonth — это число месяцев начиная с текущей даты, данные за которые вы хотите просмотреть.The numberOfMonth parameter is how many months of data you want going back, from the current data. Чтобы просмотреть данные за текущий месяц, укажите ноль (0).Use zero (0) for the current month.

Когда вы нажмете кнопку Готово в окне Расширенный редактор, предварительный просмотр обновится и вы увидите данные за месяцы, которые вы указали в таблице.Once you select Done in the Advanced Editor window, the preview refreshes and you'll see data from the specified month range in the table. Выберите Закрыть и применить.Select Close & Apply and return.

Шаг 3. Перемещение мер и настраиваемых столбцов в новый отчетStep 3: Move measures and custom columns to the new report

Теперь необходимо переместить все созданные пользовательские столбцы и меры в новую таблицу со сведениями.Next you'll need to move any custom columns or measures you created into the new details table. Это делается следующим образом.Here are the steps.

  1. Откройте Блокнот (или другой текстовый редактор).Open Notepad (or another text editor).

  2. Выберите меру, которую нужно переместить, скопируйте текст из поля Формула и вставьте его в Блокнот.Select the measure you want to move, copy the text from the Formula field, and place it in Notepad.

  3. Замените имя Query1 исходным именем таблицы со сведениями.Rename Query1 to the original details table name.

  4. Создайте новые меры и настраиваемые столбцы в таблице. Для этого щелкните правой кнопкой мыши таблицу и выберите элемент Новая мера, затем вырежьте и вставьте все сохраненные меры и столбцы.Create new measures and custom columns in your table by right-clicking on your table, and choosing New Measure, then cut and paste your stored measures and columns until they're all done.

На многих панелях мониторинга есть дополнительные таблицы, которые используются для поиска или фильтрации, например таблицы дат или таблицы, используемые для пользовательских проектов.Many dashboards have additional tables that are used for lookup or filtering, such as date tables or tables used for custom projects. Восстановление связей между таблицами решает большинство задач.Reestablishing those relationships resolves most remaining issues. Вот как это сделать.Here's how to do it.

  • В Power BI Desktop на вкладке Моделирование выберите элемент Управление связями, чтобы открыть окно управления связями в модели.In the Modeling tab in Power BI Desktop, select Manage Relationships to bring up a window that lets you manage relationships within the model. При необходимости восстановите связи между таблицами.Re-link your tables, as needed.

Шаг 5. Проверка визуальных элементов и изменение форматирования полей при необходимостиStep 5: Verify your visuals, and adjust field formatting as needed

После выполнения описанных выше шагов большая часть исходных визуальных элементов, таблиц и детализаций должна работать правильно.Once you get this far, most of your original visuals, tables, and drill-downs should be working as expected. Но, возможно, нужно внести другие небольшие изменения, чтобы полностью завершить настройку.However, there may be some minor tweaks necessary for formatting, to get things looking just how you want them. Просмотрите все свои панели мониторинга и визуальные элементы, чтобы убедиться, что они выглядят, как вы хотите.Take a bit of time to look over each of your dashboards and visuals, to ensure they look how you want them.

Использование API Azure Consumption Insights (ACI) для получения данных потребленияUsing the Azure Consumption and Insights (ACI) API to get consumption data

В Azure также доступен API Azure Consumption Insights (ACI).Azure also provides the Azure Consumption and Insights (ACI) API. Вы можете создавать собственные пользовательские решения для сбора, создания отчетов и визуализации сведений об использовании служб Azure с помощью ACI.You can create your own custom solutions to gathering, reporting, and visualizing Azure consumption information using the ACI API.

Сопоставление имен и сведений об использовании между порталом, соединителем и APIMapping names and usage details between the portal, the connector, and the API

Столбцы и имена сведений на портале Azure похожи на столбцы и имена в API и соединителе, но они не всегда совпадают.The columns and names of details in the Azure Portal are similar in the API and the connector, but they're not always identical. Чтобы вы могли увидеть разницу, см. следующую таблицу. Она содержит сопоставления между API, соединителем и столбцы, отображаемые на портале Azure.To help clarify, the following table provides a mapping between the API, the connector, and columns you see in the Azure Portal. Также в таблице указано, является ли столбец устаревшим.Also indicated is whether the column is obsolete. Дополнительные сведения и определения этих терминов см. в статье API-интерфейсы отчетов для корпоративных клиентов: сведения об использовании.For more information and definitions of these terms, take a look at the Azure billing data dictionary.

Соединитель ACI/Имя столбца пакета содержимогоACI Connector / ContentPack ColumnName Имя столбца API ACIACI API Column Name Имя столбца EAEA Column Name Устаревший/представлен для обеспечения обратной совместимостиObsolete / Present for backward compatibility
AccountNameAccountName accountNameaccountName Имя учетной записиAccount Name НетNo
AccountIdAccountId accountIdaccountId ДаYes
AcccountOwnerIdAcccountOwnerId accountOwnerEmailaccountOwnerEmail AccountOwnerIdAccountOwnerId НетNo
AdditionalInfoAdditionalInfo additionalInfoadditionalInfo AdditionalInfoAdditionalInfo НетNo
AdditionalInfoldAdditionalInfold ДаYes
Consumed QuantityConsumed Quantity consumedQuantityconsumedQuantity Consumed QuantityConsumed Quantity НетNo
Consumed ServiceConsumed Service consumedServiceconsumedService Consumed ServiceConsumed Service НетNo
ConsumedServiceIdConsumedServiceId consumedServiceIdconsumedServiceId ДаYes
CostCost costcost Расширенные затратыExtendedCost НетNo
Cost CenterCost Center costCentercostCenter Cost CenterCost Center НетNo
ДатаDate датаdate ДатаDate НетNo
ДеньDay ДеньDay НетNo
DepartmentNameDepartmentName departmentNamedepartmentName Название отделаDepartment Name НетNo
DepartmentIDDepartmentID departmentIddepartmentId ДаYes
Instance IDInstance ID ДаYes
InstanceIdInstanceId instanceIdinstanceId Instance IDInstance ID НетNo
РасположениеLocation ДаYes
Meter CategoryMeter Category meterCategorymeterCategory Meter CategoryMeter Category НетNo
Meter IDMeter ID ДаYes
Название индикатораMeter Name meterNamemeterName Название индикатораMeter Name НетNo
Meter RegionMeter Region meterRegionmeterRegion Meter RegionMeter Region НетNo
Meter Sub-CategoryMeter Sub-Category meterSubCategorymeterSubCategory Meter Sub-CategoryMeter Sub-Category НетNo
MeterIdMeterId meterIdmeterId Meter IDMeter ID НетNo
МесяцMonth МесяцMonth НетNo
ПродуктProduct productproduct ПродуктProduct НетNo
ProductIdProductId productIdproductId ДаYes
Группа ресурсовResource Group resourceGroupresourceGroup Группа ресурсовResource Group НетNo
Resource LocationResource Location resourceLocationresourceLocation Resource LocationResource Location НетNo
ResourceGroupIdResourceGroupId ДаYes
ResourceLocationIdResourceLocationId resourceLocationIdresourceLocationId ДаYes
ResourceRateResourceRate resourceRateresourceRate ResourceRateResourceRate НетNo
ServiceAdministratorIdServiceAdministratorId serviceAdministratorIdserviceAdministratorId ServiceAdministratorIdServiceAdministratorId НетNo
ServiceInfo1ServiceInfo1 serviceInfo1serviceInfo1 ServiceInfo1ServiceInfo1 НетNo
ServiceInfo1IdServiceInfo1Id ДаYes
ServiceInfo2ServiceInfo2 serviceInfo2serviceInfo2 ServiceInfo2ServiceInfo2 НетNo
ServiceInfo2IdServiceInfo2Id ДаYes
Store Service IdentifierStore Service Identifier storeServiceIdentifierstoreServiceIdentifier Store Service IdentifierStore Service Identifier НетNo
StoreServiceIdentifierIdStoreServiceIdentifierId ДаYes
Название подпискиSubscription Name subscriptionNamesubscriptionName Название подпискиSubscription Name НетNo
ТегиTags tagstags ТегиTags НетNo
TagsIdTagsId ДаYes
Unit Of MeasureUnit Of Measure unitOfMeasureunitOfMeasure Unit Of MeasureUnit Of Measure НетNo
ГодYear ГодYear НетNo
SubscriptionIdSubscriptionId subscriptionIdsubscriptionId SubscriptionIdSubscriptionId ДаYes
SubscriptionGuidSubscriptionGuid subscriptionGuidsubscriptionGuid SubscriptionGuidSubscriptionGuid НетNo

Дальнейшие действияNext steps

В Power BI Desktop можно подключаться к данным самых разных видов.There are all sorts of data you can connect to using Power BI Desktop. Дополнительные сведения об источниках данных см. в перечисленных ниже статьях.For more information on data sources, check out the following resources: