Se connecter à Azure Consumption Insights dans Power BI Desktop (bêta)Connect to Azure Consumption Insights in Power BI Desktop (Beta)

Le connecteur Azure Consumption Insights vous permet d’utiliser Power BI Desktop pour vous connecter à Azure afin d’obtenir des données et informations détaillées sur l’utilisation des services Azure par votre organisation.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. Vous pouvez également créer des mesures, des colonnes personnalisées et des visuels afin de rapporter et partager l’utilisation d’Azure par votre organisation.You can also create measures, custom columns, and visuals to report and share about your organization's Azure usage. Le connecteur Azure Consumption Insights étant publié en version bêta, il est susceptible de changer.This release of the Azure Consumption and Insights connector is in Beta, and is subject to change.

Cet article explique comment se connecter avec le connecteur Azure Consumption Insights pour obtenir des données et comment migrer depuis le connecteur Azure Enterprise. Il présente également un mappage des colonnes de détails d’utilisation disponibles dans l’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.

Se connecter à Azure Consumption InsightsConnect to Azure Consumption Insights

Pour pouvoir vous connecter à l’aide du connecteur Azure Consumption Insights, vous devez avoir accès aux fonctionnalités d’entreprise au sein du portail Azure.To successfully connect using the Azure Consumption Insights connector, you need to have access to the Enterprise features within the Azure portal.

Pour vous connecter avec le connecteur Azure Consumption Insights, dans le ruban Accueil de Power BI Desktop, sélectionnez Obtenir des données.To connect using the Azure Consumption Insights connector, select Get Data from the Home ribbon in Power BI Desktop. Sélectionnez Services en ligne dans les catégories à gauche pour afficher Microsoft Azure Consumption Insights (bêta).Select Online Services from the categories on the left, and you see Microsoft Azure Consumption Insights (Beta). Sélectionnez Se connecter.Select Connect.

Dans la boîte de dialogue qui s’affiche, entrez votre Numéro d’inscription.In the dialog that appears, provide your Enrollment Number.

  • Vous pouvez trouver celui-ci sur le portail Azure Enterprise Portal, à l’emplacement montré dans l’image suivante :You can get your enrollment number from the Azure Enterprise Portal, in the location shown in the following image:

    Cette version du connecteur prend en charge seulement les inscriptions d’entreprise depuis https://ea.azure.com.This version of the connector only supports enterprise enrollments from https://ea.azure.com. Les inscriptions en Chine ne sont pas prises en charge actuellement.China enrollments are not currently supported.

Ensuite, entrez votre Clé d’accès pour établir la connexion.Next, provide your Access key to connect.

Après que avez entré votre Clé d’accès et sélectionné Se connecter, une fenêtre du Navigateur affiche les quatre tables à votre disposition : Résumé, Utilisation, Grille tarifaire et Place de marché.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. Vous pouvez activer une case à cocher en regard d’une table pour afficher un aperçu.You can select a checkbox beside any table to see a preview. Vous pouvez sélectionner une ou plusieurs tables en cochant la case en regard de leur nom, puis sélectionner Charger.You can select one or more tables by checking the box beside their name, then select Load.

Note

Les tableaux Résumé et Grille tarifaire sont disponibles seulement pour la clé d’API au niveau inscription.The Summary and PriceSheet tables are only available for the enrollment-level API Key. De plus, les données de ces tables sont, par défaut, celles du mois en cours pour l’Utilisation et la Grille tarifaire.Also, the data in these tables has, by default, the current month's data for Usage and PriceSheet. Les tables Résumé et Place de marché ne sont pas limitées au mois en cours.The Summary and MarketPlace tables are not constrained to the current month.

Lorsque vous sélectionnez Charger, les données sont chargées dans Power BI Desktop.When you select Load the data is loaded into Power BI Desktop.

Une fois les données sélectionnées chargées, les tables et les champs que vous avez sélectionnés sont visibles dans le volet Champs.Once the data you selected is loaded, the tables and fields you selected can be seen in the Fields pane.

Utilisation d’Azure Consumption InsightsUsing Azure Consumption Insights

Pour pouvoir utiliser le connecteur Azure Consumption Insights, vous devez avoir accès aux fonctionnalités d’entreprise au sein du portail Azure.To use the Azure Consumption Insights connector, you need to have access to the Enterprise features within the Azure portal.

Une fois les données chargées à l’aide du connecteur Azure Consumption Insights, vous pouvez créer vos propres mesures et colonnes personnalisées à l’aide de l’Éditeur de requête, ainsi que générer des visuels, rapports et tableaux de bord à partager dans le service 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 comprend également une collection d’exemples de requêtes personnalisées que vous pouvez récupérer à l’aide d’une requête vide.Azure also includes a collection of sample custom queries that you can retrieve using a blank query. Pour cela, dans le ruban Accueil de Power BI Desktop, sélectionnez la flèche déroulante Obtenir des données, puis choisissez Requête vide.To do so, in the Home ribbon of Power BI Desktop, select the drop down arrow in Get Data and then select Blank Query. Vous pouvez également faire cela dans l’Éditeur de requête en cliquant avec le bouton droit sur le voletRequêtes à gauche, puis en sélectionnant Nouvelle requête > Requête vide dans le menu qui s’affiche.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.

Dans la Barre de formule, tapez ce qui suit :In the Formula bar, type the following:

= MicrosoftAzureConsumptionInsights.Contents

Une collection d’exemples s’affiche, comme illustré dans l’image suivante :A collection of samples appear, as shown in the following image:

Lors de la manipulation de rapports et de la création de requêtes, utilisez ce qui suit :When working with reports and creating queries, use the following:

  • Pour définir le nombre de mois à partir de la date actuelle, utilisez numberOfMonth.To define the number of months starting from the current date, use numberOfMonth
    • Utilisez une valeur comprise entre 1 et 36 pour représenter le nombre de mois que vous voulez importer à partir de la date actuelle.Use a value between one and 36 to represent the number of months, from the current date, you want to import. Nous vous recommandons de ne pas récupérer plus de 12 mois de données afin d’éviter les seuils en lien avec les contraintes d’importation et le volume autorisé de données pour les requêtes dans 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.
  • Pour définir une période de mois dans une fenêtre de temps historique, utilisez startBillingDataWindow et endBillingDataWindow.To define a period of months in a historical time window, use startBillingDataWindow and endBillingDataWindow
  • N’utilisez pas numberOfMonth avec startBillingDataWindow ou endBillingDataWindow.Do not use numberOfMonth together with startBillingDataWindow or endBillingDataWindow

Migration à partir du connecteur Azure EnterpriseMigrating from the Azure Enterprise Connector

Certains clients ont créé des visuels l’aide du connecteur Azure Enterprise (bêta), qui sera finalement supprimé et remplacé par le connecteur 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. Le connecteur Azure Consumption Insights intègre les fonctionnalités et améliorations suivantes :The Azure Consumption Insights connector has features and enhancements that include the following:

  • Sources de données supplémentaires disponibles pour la Synthèse de solde et les Achats sur la Place de marché.Additional data sources available for Balance Summary and Marketplace Purchases
  • Paramètres nouveaux et avancés, tels que startBillingDataWindow et endBillingDataWindow.New and advanced parameters, such as startBillingDataWindow and endBillingDataWindow
  • Performances et réactivité améliorées.Better performance and responsiveness

Pour aider les clients à opérer la transition vers le nouveau connecteur Azure Consumption Insights, ainsi qu’à préserver leur travail de création de tableaux de bord ou de rapports personnalisés, les étapes suivantes montrent comment migrer vers le nouveau connecteur.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.

Étape 1 : se connecter à Azure à l’aide du nouveau connecteurStep 1: Connect to Azure using the new connector

La première étape consiste à se connecter à l’aide du connecteur Azure Consumption Insights décrit en détail précédemment dans cet article.The first step is to connect using the Azure Consumption Insights connector, which was described earlier in this article in detail. Dans le cadre de cette étape, dans le ruban Accueil de Power BI Desktop, sélectionnez Obtenir des données > Requête vide.In this step, select Get Data > Blank Query from the Home ribbon in Power BI Desktop.

Étape 2 : utiliser l’Éditeur avancé pour créer une requêteStep 2: Use the Advanced Editor to create a query

Dans l’Éditeur de requête, dans la section Requête du ruban Accueil, sélectionnez Éditeur avancé.In Query Editor, select Advanced Editor from the Query section of the Home ribbon. Dans la fenêtre Éditeur avancé qui apparaît, entrez la requête suivante :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

Bien entendu, vous devez remplacer la valeur enrollmentNumber par votre propre numéro d’inscription, que vous pouvez obtenir sur le portail 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. Le paramètre numberOfMonth spécifie le nombre de mois de données sur lesquels vous voulez revenir à partir de la date en cours.The numberOfMonth parameter is how many months of data you want going back, from the current data. Utilisez zéro (0) pour le mois en cours.Use zero (0) for the current month.

Quand vous sélectionnez Terminé dans la fenêtre Éditeur avancé, l’aperçu est actualisé pour afficher les données de la plage de mois spécifiée dans la table.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. Sélectionnez Fermer & appliquer, puis appuyez sur Entrée.Select Close & Apply and return.

Étape 3 : déplacer les mesures et les colonnes personnalisées vers le nouveau rapportStep 3: Move measures and custom columns to the new report

Vous devez à présent déplacer les colonnes personnalisées ou les mesures que vous avez créées vers la nouvelle table des détails.Next you'll need to move any custom columns or measures you created into the new details table. Voici comment procéder.Here are the steps.

  1. Ouvrez l’application Bloc-notes (ou un autre éditeur de texte).Open Notepad (or another text editor).

  2. Sélectionnez la mesure à déplacer, puis copiez le texte du champ Formule et collez-le dans l’application Bloc-notes.Select the measure you want to move, copy the text from the Formula field, and place it in Notepad.

  3. Remplacez Query1 par le nom de la table des détails d’origine.Rename Query1 to the original details table name.

  4. Créez de nouvelles mesures et des colonnes personnalisées dans votre table en cliquant avec le bouton droit sur la table et en choisissant Nouvelle mesure, puis coupez et collez toutes les mesures et colonnes de votre magasin.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.

De nombreux tableaux de bord comportent des tables supplémentaires qui sont utilisées pour la recherche ou le filtrage, telles que des tables de dates ou des tables destinées à des projets personnalisés.Many dashboards have additional tables that are used for lookup or filtering, such as date tables or tables used for custom projects. Le rétablissement de ces relations résout la plupart des problèmes restants.Reestablishing those relationships resolves most remaining issues. Voici comment procéder.Here's how to do it.

  • Sous l’onglet Modélisation de Power BI Desktop, sélectionnez Gérer les relations pour afficher une fenêtre permettant de gérer les relations au sein du modèle.In the Modeling tab in Power BI Desktop, select Manage Relationships to bring up a window that lets you manage relationships within the model. Liez de nouveau vos tables, en fonction des besoins.Re-link your tables, as needed.

Étape 5 : vérifier vos visuels et ajuster la mise en forme des champs au besoinStep 5: Verify your visuals, and adjust field formatting as needed

À ce stade, la plupart de vos visuels, tables et vues détaillées d’origine devraient fonctionner comme prévu.Once you get this far, most of your original visuals, tables, and drill-downs should be working as expected. Toutefois, quelques ajustements mineurs de la mise en forme peuvent être nécessaires pour obtenir l’aspect souhaité.However, there may be some minor tweaks necessary for formatting, to get things looking just how you want them. Prendre un peu de temps pour jeter un coup d’œil à chacun de vos tableaux de bord et visuels afin de vous assurer qu’ils s’affichent comme vous le souhaitez.Take a bit of time to look over each of your dashboards and visuals, to ensure they look how you want them.

Utilisation de l’API ACI (Azure Consumption Insights) pour obtenir des données de consommationUsing the Azure Consumption and Insights (ACI) API to get consumption data

Azure fournit également l’ API ACI (Azure Consumption Insights).Azure also provides the Azure Consumption and Insights (ACI) API. L’API ACI vous permet de créer vos propres solutions personnalisées pour la collecte et la visualisation d’informations, ainsi que la création de rapports.You can create your own custom solutions to gathering, reporting, and visualizing Azure consumption information using the ACI API.

Mappage des noms et des détails d’utilisation entre le portail, le connecteur et l’APIMapping names and usage details between the portal, the connector, and the API

Les colonnes et les noms des détails sur le portail Azure sont similaires dans l’API et le connecteur, mais pas toujours rigoureusement identiques.The columns and names of details in the Azure Portal are similar in the API and the connector, but they're not always identical. Par souci de clarté, le tableau ci-dessous fournit un mappage entre l’API, le connecteur et les colonnes que vous voyez sur le portail Azure.To help clarify, the following table provides a mapping between the API, the connector, and columns you see in the Azure Portal. Il spécifie également si des colonnes sont obsolètes.Also indicated is whether the column is obsolete. Pour plus d’informations et des définitions de ces termes, consultez le dictionnaire des données de facturation d’Azure.For more information and definitions of these terms, take a look at the Azure billing data dictionary.

Connecteur ACI / ContentPack ColumnNameACI Connector / ContentPack ColumnName Nom de colonne dans l’API ACIACI API Column Name Nom de colonne dans EAEA Column Name Obsolète / présent pour la compatibilité descendanteObsolete / Present for backward compatibility
AccountNameAccountName accountNameaccountName Account NameAccount Name NonNo
AccountIdAccountId accountIdaccountId OuiYes
AcccountOwnerIdAcccountOwnerId accountOwnerEmailaccountOwnerEmail AccountOwnerIdAccountOwnerId NonNo
AdditionalInfoAdditionalInfo additionalInfoadditionalInfo AdditionalInfoAdditionalInfo NonNo
AdditionalInfoldAdditionalInfold OuiYes
Consumed QuantityConsumed Quantity consumedQuantityconsumedQuantity Consumed QuantityConsumed Quantity NonNo
Consumed ServiceConsumed Service consumedServiceconsumedService Consumed ServiceConsumed Service NonNo
ConsumedServiceIdConsumedServiceId consumedServiceIdconsumedServiceId OuiYes
CostCost costcost ExtendedCostExtendedCost NonNo
Cost CenterCost Center costCentercostCenter Cost CenterCost Center NonNo
DateDate datedate DateDate NonNo
DayDay DayDay NonNo
DepartmentNameDepartmentName departmentNamedepartmentName Department NameDepartment Name NonNo
DepartmentIDDepartmentID departmentIddepartmentId OuiYes
Instance IDInstance ID OuiYes
InstanceIdInstanceId instanceIdinstanceId Instance IDInstance ID NonNo
EmplacementLocation OuiYes
Meter CategoryMeter Category meterCategorymeterCategory Meter CategoryMeter Category NonNo
Meter IDMeter ID OuiYes
Meter NameMeter Name meterNamemeterName Meter NameMeter Name NonNo
Meter RegionMeter Region meterRegionmeterRegion Meter RegionMeter Region NonNo
Meter Sub-CategoryMeter Sub-Category meterSubCategorymeterSubCategory Meter Sub-CategoryMeter Sub-Category NonNo
MeterIdMeterId meterIdmeterId Meter IDMeter ID NonNo
MonthMonth MonthMonth NonNo
ProductProduct productproduct ProductProduct NonNo
ProductIdProductId productIdproductId OuiYes
Groupe de ressourcesResource Group resourceGroupresourceGroup Groupe de ressourcesResource Group NonNo
Resource LocationResource Location resourceLocationresourceLocation Resource LocationResource Location NonNo
ResourceGroupIdResourceGroupId OuiYes
ResourceLocationIdResourceLocationId resourceLocationIdresourceLocationId OuiYes
ResourceRateResourceRate resourceRateresourceRate ResourceRateResourceRate NonNo
ServiceAdministratorIdServiceAdministratorId serviceAdministratorIdserviceAdministratorId ServiceAdministratorIdServiceAdministratorId NonNo
ServiceInfo1ServiceInfo1 serviceInfo1serviceInfo1 ServiceInfo1ServiceInfo1 NonNo
ServiceInfo1IdServiceInfo1Id OuiYes
ServiceInfo2ServiceInfo2 serviceInfo2serviceInfo2 ServiceInfo2ServiceInfo2 NonNo
ServiceInfo2IdServiceInfo2Id OuiYes
Store Service IdentifierStore Service Identifier storeServiceIdentifierstoreServiceIdentifier Store Service IdentifierStore Service Identifier NonNo
StoreServiceIdentifierIdStoreServiceIdentifierId OuiYes
Nom de l’abonnementSubscription Name subscriptionNamesubscriptionName Nom de l’abonnementSubscription Name NonNo
BalisesTags tagstags BalisesTags NonNo
TagsIdTagsId OuiYes
Unit Of MeasureUnit Of Measure unitOfMeasureunitOfMeasure Unit Of MeasureUnit Of Measure NonNo
YearYear YearYear NonNo
SubscriptionIdSubscriptionId subscriptionIdsubscriptionId SubscriptionIdSubscriptionId OuiYes
SubscriptionGuidSubscriptionGuid subscriptionGuidsubscriptionGuid SubscriptionGuidSubscriptionGuid NonNo

Étapes suivantesNext steps

Vous pouvez connecter toutes sortes de données à l’aide de Power BI Desktop.There are all sorts of data you can connect to using Power BI Desktop. Pour plus d’informations sur les sources de données, consultez les ressources suivantes :For more information on data sources, check out the following resources: