Power BI Desktop での Azure Consumption Insights への接続 (Beda)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 Consumption Insights コネクタを使用して接続し、必要なデータを取得する方法と、Azure Enterprise Connector の使用からの移行方法について説明します。また、ACI (Azure Consumption Insights) API で使用可能な使用状況の詳細列 のマッピングについても説明します。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 Insights への接続Connect to Azure Consumption Insights

Azure Consumption Insights コネクタを使用して正常に接続するには、Azure Portal 内の Enterprise 機能にアクセスする必要があります。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 to using the Azure Consumption Insights connector, select Get Data from the Home ribbon in Power BI Desktop. 左側のカテゴリから [オンライン サービス] を選択すると、[Microsoft Azure Consumption Insights (Beta)] が表示されます。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.

アクセス キーを指定して [接続] を選択すると、[ナビゲーター] ウィンドウが開き、使用可能な 4 つのテーブル (SummaryUsagePriceSheet、および 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. 1 つ以上のテーブルを選択するには、名前の横のチェック ボックスをオンにしてから [読み込み] を選択します。You can select one or more tables by checking the box beside their name, then select Load.

注意

Summary と *PriceSheet テーブルを使用できるのは、登録レベルの API キーの場合のみです。The Summary and *PriceSheet tables are only available for the enrollment-level API Key. また、これらのテーブル内のデータには、既定で UsagePriceSheet の現在の月のデータが含まれます。Also, the data in these tables has, by default, the current month's data for Usage and PriceSheet. SummaryMarketPlace テーブルは現在の月に制限されません。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 Insights の使用Using Azure Consumption Insights

Azure Consumption Insights コネクタを使用するには、Azure Portal 内の Enterprise 機能にアクセスする必要があります。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:

  • 現在の日付を起点として月数を定義するには、noOfMonths を使用します。To define the number of months starting from the current date, use noOfMonths
    • 現在の日付を起点として、インポートする月数を表す 1 から 36 までの値を使用します。Use a value between one and 36 to represent the number of months, from the current date, you want to import. インポートの制約と Power BI のクエリで許容されるデータ量のしきい値を回避するため、12 か月を超えるデータを取得しないようにしてください。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.
  • 過去の期間の月数を定義するには、startBillingDataWindowendBillingDataWindow を使用します。To define a period of months in a historical time window, use startBillingDataWindow and endBillingDataWindow
  • noOfMonths は、startBillingDataWindowendBillingDataWindow と併用しないでください。Do not use noOfMonths together with startBillingDataWindow or endBillingDataWindow

Azure Enterprise Connector からの移行Migrating from the Azure Enterprise Connector

一部の顧客は Azure Enterprise Connector (Beta) を使用してビジュアルを作成しています。このベータ版は最終的には廃止され、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
  • startBillingDataWindowendBillingDataWindow などの、新しい拡張パラメーター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 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 secified 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, and 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 store measures and columns until they're all done.

多くのダッシュボードには、日付テーブルやカスタム プロジェクトで使用されるテーブルなど、検索またはフィルタリングに使用されるテーブルが追加されています。Many dashboards have additional tables that are used for lookup or filtering, such 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.

Azure Consumption Insights (ACI) API を使用して使用量データを取得するUsing the Azure Consumption and Insights (ACI) API to get consumption data

Azure では Azure Consumption Insights (ACI) API も提供されます。Azure also provides the Azure Consumption and Insights (ACI) API. ACI API を使用して、Azure の使用量情報の収集、レポート作成、および視覚化に関する独自のカスタム ソリューションを作成することができます。You can create your own custom solutions to gathering, reporting, and visualizing Azure consumption information using the ACI API.

ポータル、コネクタ、および API 間での名前と使用状況の詳細のマッピングMapping names and usage details between the portal, the connector, and the API

Azure Portal の詳細の列と名前は、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 Portal に表示される列のマッピングを示します。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. これらの用語の詳細と定義については、「企業ユーザー向けの Reporting API - 使用状況の詳細」を参照してください。For more information and definitions of these terms, take a look at the Azure billing data dictionary.

ACI コネクタ / ContentPack ColumnNameACI Connector / ContentPack ColumnName ACI API の列名ACI API Column Name EA の列名EA Column Name 古い / 旧バージョンとの互換性のために存在するObsolete / Present for backward compatiblity
AccountNameAccountName accountNameaccountName Account NameAccount 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 ExtendedCostExtendedCost いいえNo
Cost CenterCost Center costCentercostCenter Cost CenterCost Center いいえNo
日付Date datedate 日付Date いいえNo
Day Day いいえNo
DepartmentNameDepartmentName departmentNamedepartmentName Department NameDepartment 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 NameMeter Name meterNamemeterName Meter NameMeter 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
ProductProduct productproduct ProductProduct いいえNo
ProductIdProductId productIdproductId はいYes
Resource GroupResource Group resourceGroupresourceGroup Resource GroupResource 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 NameSubscription Name subscriptionNamesubscriptionName Subscription NameSubscription 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: