Partilhar via

Solucionar erros comuns do kit de ferramentas FinOps

  • Artigo

Este artigo descreve erros comuns do kit de ferramentas FinOps e fornece informações sobre soluções. Se você receber um erro ao usar as soluções do kit de ferramentas FinOps que não entende ou não consegue resolver, encontre o seguinte código de erro correspondente com as etapas de mitigação para resolver o problema.

Aqui está uma lista de códigos de erro comuns com informações de mitigação.

Se as informações fornecidas não resolverem o problema, tente o Guia de solução de problemas.


BadHubVersion

Gravidade: Crítica

Os hubs FinOps 0.2 não estão operacionais. Atualize para a versão 0.3 ou posterior.

Mitigação: atualize para a versão mais recente dos hubs FinOps.


InvalidExportContainer

Gravidade: Crítica

Esse arquivo parece que pode ter sido exportado do Gerenciamento de Custos, mas não está no contêiner correto.

Mitigação: atualize sua exportação do Cost Management para apontar para o contêiner de armazenamento 'msexports'. O recipiente de 'ingestão' é usado apenas para consultar dados de custo ingeridos.


InvalidExportVersion

Gravidade: Crítica

Os hubs FinOps exigem exportações de custos FOCUS, mas esse arquivo se parece com uma exportação herdada do Gerenciamento de Custos.

Mitigação: crie uma nova exportação do Cost Management para o custo do FOCUS e interrompa a exportação atual ou altere-a para exportar para um contêiner de armazenamento diferente.


InvalidHubVersion

Gravidade: Crítica

Os hubs FinOps 0.1.1 e anteriores não funcionam com o relatório do Power BI de ingestão de dados.

Mitigação: atualize para a versão mais recente dos hubs FinOps ou baixe relatórios do Power BI da versão 0.1.1.


InvalidScopeId

Gravidade: Informativo

O caminho de exportação não é um ID de escopo válido. Os hubs FinOps esperam que o caminho de exportação seja uma ID de recurso do Azure para o escopo que a exportação foi criada para simplificar o gerenciamento. Ele não deve causar falhas, mas pode resultar em resultados confusos para relatórios relacionados ao escopo.

Atenuação: atualize o caminho de armazenamento para a exportação do Gerenciamento de Custos para usar a ID de recurso completa do Azure para o escopo.


ExportDataNotFound

Gravidade: Crítica

As exportações não foram encontradas no caminho de armazenamento especificado.

Atenuação: confirme se uma exportação do Gerenciamento de Custos foi criada e configurada com a conta de armazenamento, o contêiner e o caminho de armazenamento corretos. Depois de criado, selecione 'Executar agora' para iniciar o processo de exportação. As exportações podem levar de 15 a 30 minutos para serem concluídas, dependendo do tamanho da conta. Se você pretendia usar hubs FinOps, corrija o URL de armazenamento para apontar para o contêiner de 'ingestão'. Consulte a storageUrlForPowerBI saída da implantação do hub FinOps para obter a URL completa.


HubDataNotFound

Gravidade: Crítica

Os dados do hub FinOps não foram encontrados na conta de armazenamento especificada.

Atenuação: este erro pressupõe que você esteja se conectando a uma implantação de hub FinOps. Se estiver usando exportações brutas, corrija o caminho de armazenamento para não fazer referência ao ingestion contêiner. Confirme as seguintes informações:

  1. A URL de armazenamento deve corresponder à StorageUrlForPowerBI saída na implantação do hub FinOps.
  2. As exportações do Gerenciamento de Custos devem ser configuradas para apontar para a mesma conta de armazenamento usando o msexports contêiner.
  3. As exportações do Gerenciamento de Custos devem mostrar uma exportação bem-sucedida no histórico de execução.
  4. Os gatilhos de fábrica de dados do hub FinOps devem ser iniciados.
  5. Os pipelines de fábrica de dados do hub FinOps devem ser bem-sucedidos.

Para obter mais informações e etapas de depuração, consulte Validar sua implantação do hub FinOps.


MissingContractedCost

Gravidade: Informativo

Esse código de x_DatasetChanges erro é mostrado na coluna quando ContractedCost é nulo ou 0 e EffectiveCost é maior que 0. O erro indica que o Microsoft Cost Management não incluiu ContractedCost para as linhas especificadas, o que significa que as economias não podem ser calculadas.

Atenuação: Como uma solução alternativa para os dados ausentes, os relatórios do kit de ferramentas FinOps copiam o EffectiveCost para a ContractedCost coluna para as linhas sinalizadas com esse código de erro. A economia não está disponível para esses registros.

Para calcular a economia completa, você pode juntar dados de custo e uso com preços. Para obter mais informações, consulte a edição #873.


MissingContractedUnitPrice

Gravidade: Informativo

Esse código de x_DatasetChanges erro é mostrado na coluna quando ContractedUnitPrice é nulo ou 0 e EffectiveUnitPrice é maior que 0. O erro indica que o Microsoft Cost Management não incluiu ContractedUnitPrice para as linhas especificadas, o que significa que as economias não podem ser calculadas.

Atenuação: Como uma solução alternativa para os dados ausentes, os relatórios do kit de ferramentas FinOps copiam o EffectiveUnitPrice para a ContractedUnitPrice coluna para as linhas sinalizadas com esse código de erro. A economia não está disponível para esses registros.

Para calcular a economia completa, você pode juntar dados de custo e uso com preços. Para obter mais informações, consulte a edição #873.


MissingListCost

Gravidade: Informativo

Esse código de x_DatasetChanges erro é mostrado na coluna quando ListCost é nulo ou 0 e ContractedCost é maior que 0. O erro indica que o Microsoft Cost Management não incluiu ListCost para as linhas especificadas, o que significa que as economias não podem ser calculadas.

Atenuação: Como uma solução alternativa para os dados ausentes, os relatórios do kit de ferramentas FinOps copiam o ContractedCost para a ListCost coluna para as linhas sinalizadas com esse código de erro. A economia não está disponível para esses registros.

Para calcular a economia completa, você pode juntar dados de custo e uso com preços. Para obter mais informações, consulte a edição #873.


MissingListUnitPrice

Gravidade: Informativo

Esse código de x_DatasetChanges erro é mostrado na coluna quando ListUnitPrice é nulo ou 0 e ContractedUnitPrice é maior que 0. O erro indica que o Microsoft Cost Management não incluiu ListUnitPrice para as linhas especificadas, o que significa que as economias não podem ser calculadas.

Atenuação: Como uma solução alternativa para os dados ausentes, os relatórios do kit de ferramentas FinOps copiam o ContractedUnitPrice para a ListUnitPrice coluna para as linhas sinalizadas com esse código de erro. A economia não está disponível para esses registros.

Para calcular a economia completa, você pode juntar dados de custo e uso com preços. Para obter mais informações, consulte a edição #873.


ManifestReadFailed

Gravidade: Crítica

O pipeline de msexports_ExecuteETL hub do FinOps não conseguiu ler o arquivo de manifesto do Gerenciamento de Custos.

Mitigação:

  1. Se o erro ocorreu em uma instância de hub de trabalho quando nenhuma alteração foi feita no hub ou na exportação, o Gerenciamento de Custos possivelmente alterou o esquema de manifesto para uma versão de API existente.
  2. Se o erro ocorreu depois de criar uma exportação nova ou alterar uma existente, a versão da API de exportação pode usar um novo esquema de manifesto sem suporte.
  3. Se o erro ocorreu após uma implantação de hub (instalação ou atualização inicial), a implantação possivelmente falhou ou pode haver um bug no pipeline.

Para confirmar o esquema de manifesto ou a versão da API :

  1. Abra a conta de armazenamento do hub no portal do Azure ou no explorador de armazenamento.
  2. Se estiver no portal do Azure, vá para Navegador de armazenamento no menu.
  3. Selecione o contêiner msexports .
  4. Navegue para baixo na hierarquia de arquivos para a exportação com o problema (consulte o local do manifesto na mensagem de erro).
  5. Localize o ficheiro manifest.json e selecione o menu (⋯) e, em seguida, selecione Ver/editar.
  6. Identifique as seguintes propriedades: 
    {
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}
  7. Confirme se eles estão definidos para os seguintes valores suportados:
    • resourceId pode ser qualquer ID de escopo e qualquer nome de exportação, mas deve existir com o tipo de recurso "Microsoft.CostManagement/exports". Não é sensível às maiúsculas e minúsculas.
    • type deve existir, mas não deve falhar com esse erro para qualquer valor não nulo.
    • dataVersion deve existir, mas não deve falhar com esse erro para qualquer valor não nulo.
    • apiVersion não é usado explicitamente, mas pode significar alterações no esquema de manifesto. Consulte as versões de API suportadas para obter detalhes.
  8. Se você estiver usando uma versão mais recente da API:
    1. Para acompanhar a adição de suporte para a nova versão da API, crie um problema de solicitação de alteração no GitHub.
    2. Exclua a exportação no Gerenciamento de custos.
    3. Crie uma exportação usando o comando New-FinOpsCostExport PowerShell usando uma versão de API suportada.

      Gorjeta

      Se você se considera um usuário avançado, você pode tentar atualizar o pipeline você mesmo para a resolução mais rápida. Para fazer isso, abra o Data Factory, navegue até Pipelines de autor > msexports_ExecuteETL, selecione as atividades "set" aplicáveis e atualize a propriedade Settings>Value conforme necessário.> Se você fizer isso, não precisará recriar a exportação com uma versão mais antiga. Ainda reporte o problema e considere compartilhar o novo JSON a {} partir do ícone no canto superior direito do pipeline designer._

  9. Se você notar que as propriedades foram alteradas para uma versão da API suportada:
    1. Para acompanhar a alteração de quebra, crie um problema de solicitação de alteração no GitHub. Inclua o tipo, dataVersion e apiVersion do seu arquivo manifest.json.
    2. Envie uma solicitação de suporte ao Gerenciamento de Custos para solicitar que sua alteração seja revertida, pois quebra todos os usuários de hubs FinOps ou outras soluções personalizadas. Inclua os seguintes detalhes para ajudar a equipe de suporte do Cost Management a identificar o problema em seu sistema. O Gerenciamento de Custos não tem contexto sobre hubs de FinOps, portanto, você deve manter os detalhes focados na funcionalidade de Gerenciamento de Custos. Eis um exemplo:

      Estou usando exportações do Cost Management para extrair meus dados de custo para o ADLS. Tenho um pipeline do ADF que está processando os dados quando os arquivos de manifesto são gravados. Meu pipeline foi construído na versão <your-supported-api-version> da API, que espera exportConfig.resourceIdque , exportConfig.typee exportConfig.dataVersion as propriedades sejam entregues de forma consistente. Notei que esses arquivos não estão sendo incluídos no arquivo de manifesto para esta versão da API para minha exportação que foi executada no <your-export-date>. Minha expectativa é que o arquivo de manifesto nunca seja alterado para uma versão de API existente. Pode, por favor, reverter essas alterações?

      Para ajudá-lo a solucionar problemas, aqui está meu arquivo de manifesto: {your-manifest-json}

Se as propriedades do manifesto parecerem boas e for uma instância de hub FinOps nova ou atualizada, confirme a implantação:

  1. Abra o grupo de recursos de hub no portal do Azure.
  2. Selecione Configurações>de implantações no menu à esquerda.
  3. Confirme se todas as implantações foram bem-sucedidas. Especificamente, procure os seguintes nomes de implantação:
    • main
    • hub
    • dataFactoryRecursos
    • storage
    • keyVault [en]
  4. Se alguma implantação falhar, revise a mensagem de erro para determinar se é algo que você pode resolver sozinho (por exemplo, conflito de nome, violação de política corrigível).
  5. Se o erro parecer transitório, tente implantar novamente.
  6. Se o erro persistir, crie uma discussão para ver se alguém está enfrentando um problema ou sabe de uma possível solução alternativa (especialmente para problemas de política).
  7. Se o erro for claramente um bug ou uma lacuna de recurso, crie um bug ou problema de solicitação de recurso no GitHub.

Tentamos responder a questões e discussões no prazo de dois dias úteis.


ResourceAccessForbiddenException

Power BI: Uma exceção do tipo 'Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException' foi lançada

Indica que a conta que carrega dados no Power BI não tem a função Leitor de Dados de Blob de Armazenamento. Conceda essa função à conta que carrega dados no Power BI.


RoleAssignmentUpdateNotAllowed

Se você excluiu Hubs FinOps e está tentando reimplantá-los com os mesmos valores, incluindo o nome da Identidade Gerenciada, poderá encontrar o seguinte problema conhecido:

"code": "RoleAssignmentUpdateNotPermitted",
"message": "Tenant ID, application ID, principal ID, and scope are not allowed to be updated."

Para corrigir esse problema, você precisa remover a identidade obsoleta:

  • Navegue até a conta de armazenamento e selecione Controle de acesso (IAM) no menu.
  • Selecione o separador Atribuição de funções.
  • Encontre quaisquer atribuições de função com uma identidade "desconhecida" e exclua-as.

SchemaLoadFailed

Gravidade: Crítica

O pipeline de msexports_ETL_ingestion hub do FinOps falhou ao carregar o arquivo de esquema.

Atenuação: revise a mensagem de erro para anotar o tipo e a versão do conjunto de dados, que são formatados com um sublinhado (por exemplo, <type>_<version> ou FocusCost_1.0). Confirme se o conjunto de dados e o tipo são suportados pela versão implantada dos hubs FinOps. Consulte os conjuntos de dados suportados para obter detalhes.


SchemaNotFound

Gravidade: Crítica

O pipeline de msexports_ExecuteETL hub do FinOps não conseguiu encontrar o arquivo de mapeamento de esquema para o conjunto de dados exportado.

Atenuação: confirme se o tipo e a versão do conjunto de dados são suportados. Consulte os conjuntos de dados suportados para obter detalhes. Se o conjunto de dados for suportado, confirme a versão do hub com o relatório de ingestão de dados.

Para adicionar suporte para outro conjunto de dados, crie um arquivo de mapeamento personalizado e salve-o no config/schemas/<dataset-type>_<dataset-version>.json. Os <dataset-type> <dataset-version> valores correspondem muito ao que a Gestão de Custos utiliza. Para identificar o tipo de dados para cada coluna, use um arquivo de esquema existente como modelo. Alguns conjuntos de dados têm esquemas diferentes para EA e Microsoft Customer Agreement (MCA). Eles não podem ser identificados por meio desses atributos e podem causar um problema se você tiver os dois tipos de conta. Estamos trabalhando para adicionar conjuntos de dados e levar em conta as diferenças de EA e MCA alinhando ao FOCUS.


UnknownExportFile

Gravidade: Informativo

O arquivo no armazenamento do hub não parece ter sido exportado do Gerenciamento de Custos. O arquivo é ignorado.

Mitigação: O contêiner msexports destina-se apenas a exportações de Gerenciamento de Custos. Mova outros arquivos para outro contêiner de armazenamento.


UnknownHubVersion

Gravidade: Crítica

Não é possível identificar a versão dos hubs FinOps a partir do arquivo de configurações. Verifique se as configurações estão corretas. Os hubs FinOps 0.1.1 e anteriores não funcionam com este relatório do Power BI.

Atenuação: atualize para a versão mais recente dos hubs FinOps ou baixe relatórios do Power BI da versão v0.1.1 do kit de ferramentas FinOps.


UnsupportedExportFileType

Gravidade: Crítica

Não é possível ingerir o arquivo de exportação especificado porque o tipo de arquivo não é suportado.

Atenuação: converta o arquivo em um formato de arquivo suportado antes de adicionar ao contêiner msexports ou adicione suporte para converter o novo tipo de arquivo para o pipeline msexports_ETL_ingestion .


UnsupportedExportType

Gravidade: aviso

O manifesto de exportação no armazenamento de hub indica que a exportação foi para um conjunto de dados sem suporte. Os dados exportados são relatados como erros de ingestão.

Mitigação: crie uma nova exportação do Cost Management para o custo do FOCUS e interrompa a exportação atual ou altere-a para exportar para um contêiner de armazenamento diferente.


O <provedor de recursos de nome> não está registrado no guid de assinatura <>

Abra a subscrição no portal do Azure e, em seguida, selecione Definições>Fornecedores de recursos, selecione a linha do fornecedor de recursos (por exemplo, Microsoft.EventGrid) e, em seguida, selecione o comando Registar na parte superior da página. O registo pode demorar alguns minutos.


x_PricingSubcategory mostra o ID de desconto de compromisso

As exportações do Gerenciamento de Custos antes de 28 de fevereiro de 2024 tinham um bug onde x_PricingSubcategory estava sendo configurado incorretamente para uso confirmado. Você deve esperar ver valores como Committed Spend e Committed Usage. Em vez disso, você pode ver valores como:

  • Committed /providers/Microsoft.BillingBenefits/savingsPlanOrders/###/savingsPlans/###
  • Committed /providers/Microsoft.Capacity/reservationOrders/###/reservations/###

Se você vir esses valores, reexporte os dados de custo desse mês. Se você precisar exportar dados de um mês anterior que não esteja disponível, entre em contato com o suporte para solicitar que os dados sejam exportados para que você resolva o problema de qualidade de dados das execuções de exportação anteriores.


Power BI: Relatórios estão faltando dados para datas específicas

Se o relatório estiver faltando todos os dados por um ou mais meses, verifique os parâmetros Number of Months, RangeStart e RangeEnd para garantir que os dados não estejam sendo filtrados.

Para verificar os parâmetros, selecione Transformar dados>Editar parâmetros na faixa de opções ou selecione os parâmetros individuais na 🛠pasta ️ Configuração na janela do editor de consultas.

  • Se quiser sempre mostrar um número específico de meses recentes, defina Número de Meses como o número de meses fechados (concluídos). O mês atual é um mês extra, além do número de meses fechados.
  • Se você quiser um intervalo de datas fixo que não mude ao longo do tempo (por exemplo, relatórios de ano fiscal), defina RangeStart e RangeEnd.
  • Se você quiser relatar todos os dados disponíveis, confirme se todos os três parâmetros de data estão vazios.

Para obter mais informações, consulte Configurar seu primeiro relatório.


Power BI: Os relatórios estão vazios (sem dados)

Se não vir quaisquer dados no seu Power BI ou noutros relatórios ou ferramentas, tente o seguinte com base na sua origem de dados:

  1. Se estiver usando o conector de Gerenciamento de Custos no Power BI, verifique os Billing Account ID parâmetros e Number of Months para garantir que eles estejam definidos corretamente. Lembre-se de que as contas de faturamento antigas podem não ter dados nos últimos meses.
  2. Se estiver usando hubs FinOps, verifique a conta de armazenamento para garantir que os dados sejam preenchidos no contêiner de ingestão. Você deve ver uma pasta de provedores ou assinaturas . Use as seções a seguir para solucionar problemas adicionais.

Hubs FinOps: O recipiente de ingestão está vazio

Se o contêiner de ingestão estiver vazio, abra a instância do Data Factory no Data Factory Studio e selecione Gerenciar>gatilhos de autor>e verifique se o gatilho de msexports_FileAdded foi iniciado. Se não, inicie-o.

Se o gatilho falhar ao iniciar com um erro "o provedor de recursos não está registrado", abra a assinatura no portal do Azure e, em seguida, selecione Configurações>Provedores de recursos, selecione a linha Microsoft.EventGrid e selecione o comando Registrar na parte superior da página. O registo pode demorar alguns minutos.

Após a conclusão do registro, inicie o gatilho msexports_FileAdded novamente.

Depois que o gatilho for iniciado, execute novamente todas as exportações conectadas do Gerenciamento de Custos. Os dados devem ser totalmente ingeridos dentro de 10-20 minutos, dependendo do tamanho da conta.

Se o problema persistir, verifique se as exportações do Gerenciamento de Custos estão configuradas com o particionamento de arquivos habilitado. Se você encontrá-lo desativado, ative-o e execute novamente as exportações.

Confirme se o recipiente de ingestão está preenchido e atualize seus relatórios ou outras ferramentas conectadas.

Hubs FinOps: arquivos disponíveis no recipiente de ingestão

Se o recipiente de ingestão não estiver vazio, confirme se você tem parquet ou csv.gz arquivos detalhando as pastas.

Depois de saber, verifique se o parâmetro FileType está definido como .parquet ou .gz no relatório do Power BI. Consulte Conectar-se aos seus dados para obter detalhes.

Se estiver a utilizar outra ferramenta, certifique-se de que suporta o tipo de ficheiro que está a utilizar.


Power BI: O nome remoto não pôde ser resolvido: '<storage-account.dfs.core.windows.net>'

Indica que o nome da conta de armazenamento está incorreto. Se estiver usando hubs FinOps, verifique o parâmetro StorageUrl da implantação. Consulte Conectar-se aos seus dados para obter detalhes.


Power BI: Não é possível converter o valor null para o tipo Lógico

Indica que o parâmetro ID da Conta de Cobrança está vazio. Se estiver usando hubs FinOps, defina o valor como o ID da conta de faturamento desejado. Se você não tiver acesso à conta de cobrança ou não quiser incluir compras e reembolsos de compromisso, defina o valor como 0 e abra a consulta CostDetails no editor avançado e altere o 2 para .1 Ele informa o relatório para não carregar dados de custo real/faturado do conector de gerenciamento de custos. Consulte Conectar-se aos seus dados para obter detalhes.

Versões aplicáveis: 0.1 - 0.1.1 (fixado em 0.2)


Hubs FinOps: Não podemos converter o valor null para o tipo Tabela

Esse erro geralmente indica que os dados não foram ingeridos no recipiente de ingestão.

Se você acabou de atualizar para hubs FinOps 0.2, o problema pode resultar do relatório do Power BI ser antigo (a partir de 0.1.x) ou porque você não está usando exportações FOCUS. Consulte o Guia de atualização para obter detalhes.

Consulte Relatórios vazios (sem dados) para obter mais etapas de solução de problemas.


Conteúdos relacionados

Se você não vir o erro que está enfrentando, percorra o guia de solução de problemas. Se você tiver alguma dúvida, inicie uma discussão ou crie um problema no GitHub.