Conectar-se ao Azure Consumption Insights no Power BI Desktop (Beta)Connect to Azure Consumption Insights in Power BI Desktop (Beta)

Com o conector do Azure Consumption Insights, você pode usar o Power BI Desktop para se conectar ao Azure e obter dados e informações detalhadas sobre o uso de serviços do Azure por sua organização.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. Você também pode criar medidas, colunas personalizadas e visuais para relatar e compartilhar sobre o uso do Azure por sua organização.You can also create measures, custom columns, and visuals to report and share about your organization's Azure usage. Esta versão do conector do Azure Consumption and Insights está na versão Beta e está sujeita a alterações.This release of the Azure Consumption and Insights connector is in Beta, and is subject to change.

Neste artigo, você saberá como se conectar usando o conector do Azure Consumption Insights e obter os dados necessários, como migrar do uso do Conector do Azure Enterprise, além de encontrar um mapeamento das colunas de detalhes de uso disponíveis na API do 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.

Conectar-se ao Azure Consumption InsightsConnect to Azure Consumption Insights

Para se conectar com êxito usando o conector do Azure Consumption Insights, é necessário ter acesso aos recursos do Enterprise no portal do Azure.To successfully connect using the Azure Consumption Insights connector, you need to have access to the Enterprise features within the Azure portal.

Para se conectar usando o conector do Azure Consumption Insights, selecione Obter Dados na faixa de opções Página Inicial do Power BI Desktop.To connect using the Azure Consumption Insights connector, select Get Data from the Home ribbon in Power BI Desktop. Selecione Serviços Online nas categorias à esquerda e você verá Microsoft Azure Consumption Insights (Beta).Select Online Services from the categories on the left, and you see Microsoft Azure Consumption Insights (Beta). Selecione Conectar.Select Connect.

Na caixa de diálogo exibida, forneça seu Número de Registro.In the dialog that appears, provide your Enrollment Number.

  • Obtenha o número de registro no Azure Enterprise Portal, no local mostrado na imagem a seguir:You can get your enrollment number from the Azure Enterprise Portal, in the location shown in the following image:

    Esta versão do conector é compatível apenas com registros empresariais de https://ea.azure.com.This version of the connector only supports enterprise enrollments from https://ea.azure.com. Atualmente, não há suporte para registros da China.China enrollments are not currently supported.

Em seguida, forneça sua Chave de acesso para se conectar.Next, provide your Access key to connect.

Depois de fornecer sua Chave de acesso e selecionar Conectar, uma janela Navegador é exibida, mostrando as quatro tabelas disponíveis para você: Summary, Usage, PriceSheet e 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. Selecione uma caixa de seleção ao lado de qualquer tabela para ver uma visualização.You can select a checkbox beside any table to see a preview. Selecione uma ou mais tabelas marcando a caixa ao lado de seu nome e, em seguida, selecione Carregar.You can select one or more tables by checking the box beside their name, then select Load.

Observação

As tabelas Resumo e Tabela de Preços estão disponíveis apenas para a Chave de API no nível do registro.The Summary and PriceSheet tables are only available for the enrollment-level API Key. Além disso, os dados nessas tabelas têm, por padrão, dados do mês atual para Usage e PriceSheet.Also, the data in these tables has, by default, the current month's data for Usage and PriceSheet. As tabelas Summary e MarketPlace não são restritas ao mês atual.The Summary and MarketPlace tables are not constrained to the current month.

Quando você seleciona Carregar, os dados são carregados no Power BI Desktop.When you select Load the data is loaded into Power BI Desktop.

Depois que os dados selecionados forem carregados, as tabelas e os campos selecionados poderão ser vistos no painel Campos.Once the data you selected is loaded, the tables and fields you selected can be seen in the Fields pane.

Usando o Azure Consumption InsightsUsing Azure Consumption Insights

Para usar o conector do Azure Consumption Insights, é necessário ter acesso aos recursos do Enterprise no portal do Azure.To use the Azure Consumption Insights connector, you need to have access to the Enterprise features within the Azure portal.

Depois de carregar os dados com êxito usando o conector do Azure Consumption Insights, você pode criar suas próprias medidas e colunas personalizadas usando o Editor de Consultas e criar visuais, relatórios e dashboards que você pode compartilhar no serviço do 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.

O Azure também inclui uma coleção de consultas personalizadas de exemplo que podem ser recuperadas usando uma consulta em branco.Azure also includes a collection of sample custom queries that you can retrieve using a blank query. Para fazer isso, na faixa de opções Página Inicial do Power BI Desktop, selecione a seta suspensa em Obter Dados e, em seguida, selecione Consulta em Branco.To do so, in the Home ribbon of Power BI Desktop, select the drop down arrow in Get Data and then select Blank Query. Também faça isso no Editor de Consultas clicando com o botão direito do mouse no painel Consultas à esquerda e selecionando Nova Consulta > Consulta em Branco no menu exibido.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.

No Barra de fórmulas, digite o seguinte:In the Formula bar, type the following:

= MicrosoftAzureConsumptionInsights.Contents

Uma coleção de amostras é exibida, conforme mostrado na imagem a seguir:A collection of samples appear, as shown in the following image:

Ao trabalhar com relatórios e criar consultas, use o seguinte:When working with reports and creating queries, use the following:

  • Para definir o número de meses a partir da data atual, use numberOfMonthTo define the number of months starting from the current date, use numberOfMonth
    • Use um valor entre 1 e 36 para representar o número de meses, a partir da data atual, que você deseja importar.Use a value between one and 36 to represent the number of months, from the current date, you want to import. Recomendamos obter não mais de 12 meses de dados para evitar limites com restrições de importação e o volume de dados permitido para consultas no 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.
  • Para definir um período de meses em uma janela de tempo histórico, use startBillingDataWindow e endBillingDataWindowTo define a period of months in a historical time window, use startBillingDataWindow and endBillingDataWindow
  • Não use numberOfMonth junto com startBillingDataWindow ou endBillingDataWindowDo not use numberOfMonth together with startBillingDataWindow or endBillingDataWindow

Migrando do Conector do Azure EnterpriseMigrating from the Azure Enterprise Connector

Alguns clientes criaram visuais usando o Conector do Azure Enterprise (Beta), que, em última análise, será descontinuado e está sendo substituído pelo conector do 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. O conector do Azure Consumption Insights tem recursos e melhorias que incluem os seguintes:The Azure Consumption Insights connector has features and enhancements that include the following:

  • Fontes de dados adicionais disponíveis para Resumo de Saldo e Compras do MarketplaceAdditional data sources available for Balance Summary and Marketplace Purchases
  • Novos e avançados parâmetros, como startBillingDataWindow e endBillingDataWindowNew and advanced parameters, such as startBillingDataWindow and endBillingDataWindow
  • Melhor desempenho e capacidade de respostaBetter performance and responsiveness

Para ajudar os clientes a fazer a transição para o novo conector do Azure Consumption Insights e preservar o trabalho feito na criação de dashboards e relatórios personalizados, as etapas a seguir mostram como migrar para o novo conector.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.

Etapa 1: Conectar-se ao Azure usando o novo conectorStep 1: Connect to Azure using the new connector

A primeira etapa é conectar-se usando o conector do Azure Consumption Insights, descrito anteriormente neste artigo em detalhes.The first step is to connect using the Azure Consumption Insights connector, which was described earlier in this article in detail. Nesta etapa, selecione Obter Dados > Consulta em Branco na faixa de opções Página Inicial no Power BI Desktop.In this step, select Get Data > Blank Query from the Home ribbon in Power BI Desktop.

Etapa 2: Usar o Editor Avançado para criar uma consultaStep 2: Use the Advanced Editor to create a query

No Editor de Consultas, selecione Editor Avançado na seção Consulta da faixa de opções Página Inicial.In Query Editor, select Advanced Editor from the Query section of the Home ribbon. Na janela do Editor Avançado exibida, insira a consulta a seguir: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

Evidentemente, você precisará substituir o valor de enrollmentNumber por seu próprio número de registro, que pode ser obtido no 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. O parâmetro numberOfMonth é o número de meses de dados aos quais você deseja voltar, a partir dos dados atuais.The numberOfMonth parameter is how many months of data you want going back, from the current data. Use zero (0) para o mês atual.Use zero (0) for the current month.

Depois de selecionar Concluído na janela do Editor Avançado, a visualização é atualizada e você verá os dados do intervalo de meses especificado na tabela.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. Selecione Fechar e Aplicar e retorne.Select Close & Apply and return.

Etapa 3: Mover medidas e colunas personalizadas para o novo relatórioStep 3: Move measures and custom columns to the new report

Em seguida, você precisará mover as medidas e colunas personalizadas que você criou para a nova tabela de detalhes.Next you'll need to move any custom columns or measures you created into the new details table. Veja abaixo as etapas.Here are the steps.

  1. Abra o Bloco de notas (ou outro editor de texto).Open Notepad (or another text editor).

  2. Selecione a medida que você deseja mover, copie o texto do campo Fórmula e coloque-o no Bloco de notas.Select the measure you want to move, copy the text from the Formula field, and place it in Notepad.

  3. Renomeie Query1 com o nome da tabela de detalhes original.Rename Query1 to the original details table name.

  4. Crie medidas e colunas personalizadas na tabela clicando com o botão direito do mouse na tabela e escolhendo Nova Medida. Em seguida, recorte e cole as medidas e colunas armazenadas até terminar.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.

Muitos dashboards têm tabelas adicionais que são usadas para pesquisa ou filtragem, tabelas de data ou tabelas, tais como essas usadas para projetos personalizados.Many dashboards have additional tables that are used for lookup or filtering, such as date tables or tables used for custom projects. O restabelecimento dessas relações resolve a maioria dos problemas restantes.Reestablishing those relationships resolves most remaining issues. Veja como fazer isso.Here's how to do it.

  • Na guia Modelagem no Power BI Desktop, selecione Gerenciar Relações para exibir uma janela que permite gerenciar relações no modelo.In the Modeling tab in Power BI Desktop, select Manage Relationships to bring up a window that lets you manage relationships within the model. Vincule novamente as tabelas, conforme necessário.Re-link your tables, as needed.

Etapa 5: Verificar os visuais e ajustar a formatação do campo, conforme necessárioStep 5: Verify your visuals, and adjust field formatting as needed

Depois de chegar até aqui, a maioria dos visuais, das tabelas e drill downs originais deverá funcionar conforme esperado.Once you get this far, most of your original visuals, tables, and drill-downs should be working as expected. No entanto, pode ser que alguns ajustes secundários sejam necessários para a formatação, para fazer com que tudo fique exatamente como desejado.However, there may be some minor tweaks necessary for formatting, to get things looking just how you want them. Reserve algum tempo para examinar cada um dos dashboards e visuais, para garantir que eles tenham a aparência desejada.Take a bit of time to look over each of your dashboards and visuals, to ensure they look how you want them.

Usando a API do ACI (Azure Consumption and Insights) para obter dados de consumoUsing the Azure Consumption and Insights (ACI) API to get consumption data

O Azure também fornece a API do ACI (Azure Consumption and Insights).Azure also provides the Azure Consumption and Insights (ACI) API. Crie suas próprias soluções personalizadas para coleta, relatório e visualização de informações de consumo do Azure usando a API do ACI.You can create your own custom solutions to gathering, reporting, and visualizing Azure consumption information using the ACI API.

Mapeamento de nomes e detalhes de uso entre o portal, o conector e a APIMapping names and usage details between the portal, the connector, and the API

As colunas e os nomes dos detalhes no Portal do Azure são semelhantes na API e no conector, mas não são sempre idênticos.The columns and names of details in the Azure Portal are similar in the API and the connector, but they're not always identical. Para ajudar a esclarecer isso, a tabela a seguir fornece um mapeamento entre a API, o conector e as colunas vistas no Portal do Azure.To help clarify, the following table provides a mapping between the API, the connector, and columns you see in the Azure Portal. Também é indicado se a coluna é obsoleta.Also indicated is whether the column is obsolete. Para obter mais informações e definições desses termos, examine o dicionário de dados de cobrança do Azure.For more information and definitions of these terms, take a look at the Azure billing data dictionary.

Conector do ACI/ColumnName do ContentPackACI Connector / ContentPack ColumnName Nome da Coluna de API do ACIACI API Column Name Nome da Coluna do EAEA Column Name Obsoleto/presente para compatibilidade com versões anterioresObsolete / Present for backward compatibility
AccountNameAccountName accountNameaccountName Nome da contaAccount Name NãoNo
AccountIdAccountId accountIdaccountId SimYes
AcccountOwnerIdAcccountOwnerId accountOwnerEmailaccountOwnerEmail AccountOwnerIdAccountOwnerId NãoNo
AdditionalInfoAdditionalInfo additionalInfoadditionalInfo AdditionalInfoAdditionalInfo NãoNo
AdditionalInfoldAdditionalInfold SimYes
Quantidade ConsumidaConsumed Quantity consumedQuantityconsumedQuantity Quantidade ConsumidaConsumed Quantity NãoNo
Serviço ConsumidoConsumed Service consumedServiceconsumedService Serviço ConsumidoConsumed Service NãoNo
ConsumedServiceIdConsumedServiceId consumedServiceIdconsumedServiceId SimYes
CustoCost costcost ExtendedCostExtendedCost NãoNo
Centro de CustoCost Center costCentercostCenter Centro de CustoCost Center NãoNo
DataDate datadate DataDate NãoNo
DiaDay DiaDay NãoNo
DepartmentNameDepartmentName departmentNamedepartmentName Nome do DepartamentoDepartment Name NãoNo
DepartmentIDDepartmentID departmentIddepartmentId SimYes
ID da InstânciaInstance ID SimYes
InstanceIdInstanceId instanceIdinstanceId ID da InstânciaInstance ID NãoNo
LocalizaçãoLocation SimYes
Categoria de MedidorMeter Category meterCategorymeterCategory Categoria de MedidorMeter Category NãoNo
ID de MedidorMeter ID SimYes
Nome do MedidorMeter Name meterNamemeterName Nome do MedidorMeter Name NãoNo
Região do MedidorMeter Region meterRegionmeterRegion Região do MedidorMeter Region NãoNo
Subcategoria de MedidorMeter Sub-Category meterSubCategorymeterSubCategory Subcategoria de MedidorMeter Sub-Category NãoNo
MeterIdMeterId meterIdmeterId ID de MedidorMeter ID NãoNo
MêsMonth MêsMonth NãoNo
ProdutoProduct produtoproduct ProdutoProduct NãoNo
ProductIdProductId productIdproductId SimYes
Grupo de recursosResource Group resourceGroupresourceGroup Grupo de recursosResource Group NãoNo
Local do RecursoResource Location resourceLocationresourceLocation Local do RecursoResource Location NãoNo
ResourceGroupIdResourceGroupId SimYes
ResourceLocationIdResourceLocationId resourceLocationIdresourceLocationId SimYes
ResourceRateResourceRate resourceRateresourceRate ResourceRateResourceRate NãoNo
ServiceAdministratorIdServiceAdministratorId serviceAdministratorIdserviceAdministratorId ServiceAdministratorIdServiceAdministratorId NãoNo
ServiceInfo1ServiceInfo1 serviceInfo1serviceInfo1 ServiceInfo1ServiceInfo1 NãoNo
ServiceInfo1IdServiceInfo1Id SimYes
ServiceInfo2ServiceInfo2 serviceInfo2serviceInfo2 ServiceInfo2ServiceInfo2 NãoNo
ServiceInfo2IdServiceInfo2Id SimYes
Identificador de Serviço de RepositórioStore Service Identifier storeServiceIdentifierstoreServiceIdentifier Identificador de Serviço de RepositórioStore Service Identifier NãoNo
StoreServiceIdentifierIdStoreServiceIdentifierId SimYes
Nome da assinaturaSubscription Name subscriptionNamesubscriptionName Nome da assinaturaSubscription Name NãoNo
MarcasTags tagstags MarcasTags NãoNo
TagsIdTagsId SimYes
Unidade de MedidaUnit Of Measure unitOfMeasureunitOfMeasure Unidade de MedidaUnit Of Measure NãoNo
AnoYear AnoYear NãoNo
SubscriptionIdSubscriptionId subscriptionIdsubscriptionId SubscriptionIdSubscriptionId SimYes
SubscriptionGuidSubscriptionGuid subscriptionGuidsubscriptionGuid SubscriptionGuidSubscriptionGuid NãoNo

Próximas etapasNext steps

Há todos os tipos de dados aos quais você pode se conectar usando o Power BI Desktop.There are all sorts of data you can connect to using Power BI Desktop. Para obter mais informações sobre fontes de dados, confira os seguintes recursos:For more information on data sources, check out the following resources: