Compartilhar via

Solucionar erros comuns do kit de ferramentas FinOps

Este artigo descreve erros comuns do kit de ferramentas FinOps e fornece informações sobre soluções. Se você receber um erro ao usar soluções de kit de ferramentas FinOps que não entende ou não consegue resolver, encontre o seguinte código de erro correspondente com 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.


O acesso ao recurso é proibido

Gravidade: crítica

Esse erro geralmente significa que a conta com a qual você está conectado não tem acesso ao recurso que você está tentando usar.

Mitigação: confirme que você está usando a conta correta no tenant correto do Microsoft Entra ID.


PropriedadeDaContaNãoPodeSerAtualizada

Gravidade: crítica

Esse erro normalmente ocorre ao atualizar uma implantação do hub FinOps com uma configuração de conta de armazenamento diferente da usada originalmente durante a criação. Embora a maioria das propriedades possa ser alterada, há algumas propriedades que só podem ser definidas uma vez quando a conta de armazenamento é criada e não podem ser alteradas. O único caso conhecido disso para hubs FinOps é a propriedade "requireInfrastructureEncryption". Se essa propriedade estiver habilitada ou desabilitada durante a primeira implantação do hub FinOps, ela não poderá ser alterada. Você verá o seguinte erro quando isso acontecer:

A propriedade 'requireInfrastructureEncryption' foi especificada na entrada, mas não pode ser atualizada, pois é somente leitura.

Mitigação: Caso você não tenha a intenção de alterar esta configuração, verifique se sua conta de armazenamento está configurada para usar criptografia de infraestrutura e reimplante o modelo do hub FinOps com o mesmo valor (ativado ou desativado). Se você quiser alterar a configuração, recomendamos implantar uma nova instância do hub FinOps, pois isso exigirá o novo teste de todos os dados.

Você pode tentar excluir a conta de armazenamento existente e reimplantar o modelo com a criptografia de infraestrutura alterada; no entanto, não testamos completamente isso. Embora não prevejo problemas, não podemos confirmar se isso causará problemas.


Versão do BadHub

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.


A coluna 'id' na tabela 'Resources' contém um valor duplicado

Gravidade: crítica

Se você experimentar o erro a seguir, isso significa que o Azure Resource Graph está retornando linhas com o mesmo valor lógico para a coluna de ID . Isso pode acontecer quando os valores do identificador do recurso têm maiúsculas e minúsculas inconsistentes ou quando outra coluna é expandida ao longo das linhas.

A coluna 'id' na tabela 'Resources' contém um valor duplicado '{resource-id}' e isso não é permitido para colunas do lado único de uma relação muitos para um ou para colunas que são usadas como a chave primária de uma tabela.

Mitigação: verifique se você está na versão mais recente do relatório. Identifique a causa dos valores duplicados e atualize a consulta para contornar os valores duplicados. Relate também esse problema no GitHub para que ele possa ser corrigido em uma versão futura. Isso pode exigir detalhes adicionais ou uma reunião para solucionar o problema da causa do erro.


Erro de Conflito

Gravidade: crítica

Pode haver várias instâncias desse erro. A única instância conhecida é quando o Key Vault retorna o seguinte erro:

Um cofre com o mesmo nome já existe no estado excluído. Você precisa recuperar ou limpar o cofre de chaves existente. Siga este link https://go.microsoft.com/fwlink/?linkid=2149745 para obter mais informações sobre exclusão reversível.

Isso geralmente significa que você está implantando em cima de uma implantação antiga que foi excluída, mas o Key Vault manteve a instância do cofre antiga em um estado de exclusão recuperável.

Mitigação: Para solucionar esse problema, remova o Key Vault excluído no portal do Azure.

  1. Abra a lista de instâncias do Key Vault no portal do Azure.
  2. Selecione o comando Gerenciar cofres excluídos na parte superior da página.
  3. Selecione a assinatura na lista suspensa.
  4. Verifique os cofres a serem removidos.
  5. Selecione Limpar na parte inferior do menu flutuante.
  6. Selecione Eliminar na caixa de diálogo de confirmação.

Agora você pode repetir a implantação.


CustoContratadoMenorQueCustoEfetivo

Severidade: Aviso

ContractedCost (com base em descontos negociados) é menor que EffectiveCost (após descontos de compromisso) nos dados do Gerenciamento de Custos. Isso nunca deve acontecer a menos que o desconto de compromisso forneça menos desconto do que seus descontos negociados existentes. Isso fará com que seus cálculos de poupança não coincidam com precisão.

Mitigação: confirme se os ContractedUnitPrice dados de custo estão em conformidade com os dados de preço. Se o preço contratado estiver correto, registre uma solicitação de suporte com a equipe de Gerenciamento de Custos para confirmar se x_EffectiveUnitPrice e EffectiveCost estão corretos. Se estiverem corretos, considere retornar o desconto de compromisso.


A política de acesso entre locatários não permite o acesso deste usuário.

Severidade: Grave

Se você tiver o seguinte erro, isso significa que a ID do Microsoft Entra está configurada para não permitir que usuários de outros locatários entrem no locatário atual.

Mensagem: AADSTS500213: a política de acesso entre locatários do locatário do recurso não permite que esse usuário acesse esse locatário.

Esta mensagem de erro não está relacionada ao kit de ferramentas FinOps.

Mitigação: verifique se você está conectado à conta correta e se entrou por meio do diretório de destino. Entre em contato com o administrador do diretório se precisar de mais assistência.


FalhaNaIngestãoNoDataExplorer

Gravidade: crítica

Falha na ingestão do Data Explorer. Os novos dados não estarão disponíveis para relatórios.

Mitigação: examine a mensagem de erro do Data Explorer e resolva o problema. Execute novamente a ingestão de dados para a pasta especificada usando o pipeline ingestion_ExecuteETL no Azure Data Factory. Relate os problemas não resolvidos no https://aka.ms/ftk/ideas.


FalhaNoMapeamentoDeIngestãoDoDataExplorer

Gravidade: crítica

Não foi possível criar o mapeamento de ingestão do Data Explorer para a tabela especificada.

Mitigação: corrija o erro e reexecute o processamento para o caminho da pasta especificado. Se você continuar a ver esse erro, relate um problema em https://aka.ms/ftk/ideas.


TempoLimiteDeIngestãoDoDataExplorer

Gravidade: crítica

A ingestão do Data Explorer atingiu o tempo limite após 2 horas enquanto esperava pela capacidade disponível.

Mitigação: execute este pipeline novamente para tentar fazer a ingestão novamente. Se você continuar a ver esse erro, relate um problema em https://aka.ms/ftk/ideas.


FalhaNoDescarteApósIngestãoDataExplorer

Gravidade: crítica

Falha na limpeza após ingestão de dados do Data Explorer (remover fragmentos de dados da tabela final). Os dados de uma ingestão anterior podem estar presentes nos relatórios, o que pode resultar em custos duplicados e imprecisos.

Mitigação: examine a mensagem de erro do Data Explorer e resolva o problema. Execute novamente a ingestão de dados para a pasta especificada usando o pipeline ingestion_ExecuteETL no Azure Data Factory. Relate os problemas não resolvidos no https://aka.ms/ftk/ideas.


DataExplorerPreIngestionDropFailed

Gravidade: crítica

Falha na limpeza de pré-ingestão do Data Explorer (exclusão de extensões da tabela bruta). A ingestão não foi concluída.

Mitigação: examine a mensagem de erro do Data Explorer e resolva o problema. Execute novamente a ingestão de dados para a pasta especificada usando o pipeline ingestion_ExecuteETL no Azure Data Factory. Relate os problemas não resolvidos no https://aka.ms/ftk/ideas.


Falha na Avaliação da Saída de Implantação

Severidade: Grave

Os hubs FinOps 0.8 definem a configuração de segurança "trustedExternaltenants" do Azure Data Explorer para bloquear o cluster para que ele só possa ser acessado de locatários específicos e confiáveis. Essa configuração pode ser definida para a primeira implantação, mas não pode ser definida novamente em uma segunda implantação. Você poderá ver o seguinte erro se tentar reimplantar os FinOps hubs 0.8 sobre uma implantação 0.8 existente:

A saída do modelo 'clusterUri' não é válida: a propriedade de expressão de linguagem 'uri' não existe, as propriedades disponíveis são 'trustedExternalTenants, enableStreamingIngest, publicNetworkAccess, enableAutoStop, provisioningState'.

Estamos acompanhando a equipe do Azure Data Explorer para identificar a resolução correta.

Mitigação: Desdobrar os Hubs FinOps 0,9. Essa configuração foi removida do modelo.


DadosDeExportaçãoNãoEncontrados

Gravidade: crítica

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

Mitigaçã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 a 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.


ExportTypeNotDefined

Gravidade: crítica

Esse tipo de escopo de cobrança não é suportado por exportações gerenciadas.

Mitigação: Remova o escopo de cobrança sem suporte do settings.json, confirme se o escopo de cobrança é compatível com os hubs do FinOps e crie manualmente novas exportações de gerenciamento de custos para o escopo de cobrança.


Tipo de Exportação Não Suportado

Gravidade: crítica

Não há suporte para Contratos de Cliente da Microsoft para exportações gerenciadas.

Mitigação: remova o escopo de cobrança do MCA de settings.json e crie manualmente novas exportações do Gerenciamento de Custos para cada perfil de cobrança do MCA, incluindo custo do FOCUS, folha de preços, detalhes da reserva, transações de reserva e recomendações de reserva.


DadosDoHubNãoEncontrados

Gravidade: crítica

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

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

  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ções.
  4. Os gatilhos de data factory do hub FinOps devem ser iniciados.
  5. Os pipelines de data factory do hub FinOps devem ser bem-sucedidos.

Para obter mais detalhes e etapas de depuração, confira Validar a implantação do seu hub FinOps.


ArquivosDeIngestãoNãoEncontrados

Gravidade: crítica

Não é possível localizar arquivos parquet para ingerir do caminho da pasta especificado.

Mitigação: confirme se o caminho da pasta é o caminho completo, incluindo o contêiner de ingestão e que não começa nem termina com uma barra (/). Copie o caminho da última execução bem-sucedida de pipeline de ingestion_ExecuteETL.


ErroInternoDoServiço

O Microsoft Fabric Real-Time Intelligence pode retornar um código de erro "InternalServiceError (520-UnknownError)" ao ingerir dados. A mensagem de erro detalhada pode dizer:

Falha no cliente Kusto ao enviar uma solicitação ao serviço: "Não é possível ler dados da conexão de transporte: uma conexão existente foi fechada à força pelo host remoto.". `

O motivo exato desse erro é desconhecido. Caso você passe por essa situação, abra uma solicitação de suporte para que a Microsoft Fabric possa investigar mais a fundo.

Mitigação: como solução alternativa, altere o consumo mínimo da casa de eventos Fabric para Média (18 CUs), aguarde 30 minutos e execute novamente o pipeline ingestion_ExecuteETL para esse conjunto de dados e mês. Para saber mais sobre o consumo mínimo, confira o consumo mínimo na visão geral do eventhouse.


CustoEfetivoInválido

Severidade: Grave

A partir de novembro de 2024, o Gerenciamento de Custos tem um bug conhecido em que as compras do plano de poupança são controladas internamente como custos reais e amortizados. Por isso, o FOCUS inclui compras de plano de poupança no cálculo de EffectiveCost, o que leva a números imprecisos em relatórios do kit de ferramentas FinOps.

Mitigação: faça uma solicitação de suporte com a equipe de Gerenciamento de Custos da Microsoft, incluindo detalhes sobre o problema para corrigir os dados subjacentes. A partir de novembro de 2024, a equipe está ciente do problema, mas a correção ainda não foi priorizada. Nesse ínterim, atualize para o FinOps toolkit 0.7, que inclui uma solução alternativa para hubs FinOps e relatórios do Power BI baseados em armazenamento.


Contêiner de exportação inválido

Gravidade: crítica

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

Mitigação: atualize sua exportação do Gerenciamento de Custos para apontar para o contêiner de armazenamento 'msexports'. O contêiner 'ingestion' é usado apenas para consultar dados de custo ingeridos.


VersãoDeExportaçãoInválida

Gravidade: crítica

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

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


Versão inválida

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 FinOpsou baixe relatórios do Power BI da versão 0.1.1.


InvalidScopeId

Gravidade: Informativo

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

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


LegacyFocusVersion

Gravidade: Informativo

Esse código de erro é mostrado quando os dados ingeridos usam uma versão mais antiga do FOCUS. Quando encontrado na x_SourceChanges coluna, o código é somente informativo. Quando aparecer nos relatórios de armazenamento do Power BI e a consulta Custos não for carregada, isso significa que o parâmetro Deprecated: Execute Extra Query Optimizations está desativado.

Os hubs FinOps convertem dados na versão mais recente do FOCUS, portanto, isso não deve causar um problema; no entanto, a transformação de modernização não pode levar em conta todos os cenários e pode resultar em resultados inesperados em alguns casos. Consulte a documentação para problemas conhecidos.

Mitigação: há várias maneiras de atenuar essa mensagem, dependendo de qual ferramenta você está usando.

Se estiver usando hubs FinOps com o Data Explorer e vendo isso na coluna x_SourceChanges da tabela de Custos ou em funções relacionadas, atualize as exportações de custo do Gerenciamento de Custos para usar a versão mais recente do FOCUS. Nenhuma alteração adicional precisa ser feita, todos os dados serão mesclados durante a ingestão do Data Explorer.

Se estiver usando relatórios de armazenamento e vendo isso na x_SourceChanges coluna da consulta Custos, essa mensagem será um aviso de que essa versão FOCUS será removida em uma atualização futura. Embora você possa ignorar essa mensagem com segurança, ela exigirá uma atualização em uma versão futura. Para evitar a mensagem, atualize as exportações de Gerenciamento de Custos para a versão mais recente do FOCUS, exclua ou mova os dados mais antigos usando uma versão focus mais antiga e reexporte dados históricos. Se estiver usando hubs FinOps, exclua ou mova dados para fora do contêiner de ingestão . Se você estiver hospedando suas próprias exportações no armazenamento, altere o parâmetro de URL de Armazenamento para um caminho de pasta diferente que não inclua versões mais antigas do FOCUS.

A partir do FinOps toolkit 0.7, o suporte para versões focus mais antigas foi preterido para melhorar o desempenho e a escalabilidade. Recomendamos atualizar para a versão mais recente do FOCUS e reexportar dados para melhorar sua experiência. Defina o parâmetro Preterido: Otimizações de Consulta Extras para TRUE garantir a compatibilidade com versões mais antigas do FOCUS e ajuste-o para FALSE a fim de acelerar o desempenho e dar suporte a conjuntos de dados maiores, abrangendo mais custo ou tempo. A partir da versão 0.7, esse parâmetro é habilitado por padrão para compatibilidade com versões anteriores. No FinOps toolkit 0.8, ele será desabilitado por padrão, mas ainda disponível para compatibilidade com versões anteriores até junho de 2025 ou posteriores. Se você não puder sair das versões focus antigas ou para obter o melhor desempenho e suporte para contas maiores ou períodos mais longos de tempo, recomendamos usar hubs FinOps com o Data Explorer.


CustoDaListaMenorQueCustoContratado

Severidade: Aviso

ListCost (com base nos preços públicos e de varejo) é menor que ContractedCost (com base em descontos negociados) nos dados do Gerenciamento de Custos. Isso nunca deve acontecer. Isso fará com que seus cálculos de poupança não coincidam com precisão.

Mitigação: confirme se os ListUnitPrice dados de custo estão em conformidade com os dados de preço. Se o preço de lista estiver correto, registre uma solicitação de suporte com a equipe de Gerenciamento de Custos para confirmar que ambos os ListUnitPrice e ContractedUnitPrice estão corretos e para explicar por que o preço após os descontos negociados seria maior do que as taxas públicas de varejo.


Falha na Leitura do Manifesto

Gravidade: crítica

O pipeline de msexports_ExecuteETL hub FinOps falhou ao ler o arquivo de manifesto do Gerenciamento de Custos.

Atenuação:

  1. Se o erro ocorreu em uma instância de hub em funcionamento 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 que você criou uma nova exportação ou alterou uma existente, a versão da API de exportação poderá 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 (# 1) ou a versão da API (#2):

  1. Abra a conta de armazenamento do hub no portal do Azure ou no gerenciador de armazenamento.
  2. Se estiver no portal do Azure, acesse Navegador de armazenamento no menu.
  3. Selecione o contêiner msexports .
  4. Navegue pela hierarquia de arquivos para a exportação com o problema (consulte o local do manifesto na mensagem de erro).
  5. Localize o arquivo manifest.json e selecione o menu (⋯) e, em seguida, selecione Exibir/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 com os seguintes valores com suporte:
    • 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 diferencia maiúsculas de minúsculas.
    • type deve existir, mas não deve falhar com esse erro para nenhum valor não nulo.
    • dataVersion deve existir, mas não deve falhar com esse erro para nenhum valor não nulo.
    • apiVersion não é usado explicitamente, mas pode significar alterações no esquema de manifesto. Consulte as versões de API compatíveis 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 do PowerShell usando uma versão de API com suporte.

      Dica

      Se você se considera um usuário avançado, talvez queira tentar atualizar o pipeline por conta própria para obter a resolução mais rápida. Para fazer isso, abra o Data Factory, navegue até o msexports_ExecuteETL Pipeline de Criação>, selecione as atividades "Definir" aplicáveis e atualize a propriedade Valor>conforme necessário. Se você fizer isso, não precisará recriar a exportação com uma versão mais antiga. Ainda assim, relate o problema e considere compartilhar o novo JSON do {} ícone no canto superior direito do pipeline designer._

  9. Se você notar que as propriedades foram alteradas para uma versão de API compatível:
    1. Para acompanhar a alteração significativa, crie um problema de solicitação de alteração no GitHub. Inclua o tipo, dataVersion e apiVersion do arquivo manifest.json.
    2. Registre uma solicitação de suporte com o Gerenciamento de Custos para solicitar que sua alteração seja revertida, pois isso interrompe todos que usam hubs FinOps ou outras soluções personalizadas. Inclua os detalhes a seguir para ajudar a equipe de suporte do Gerenciamento de Custos a identificar o problema em seu sistema. O Gerenciamento de Custos não tem contexto sobre hubs FinOps, portanto, você deve manter os detalhes focados na funcionalidade do Gerenciamento de Custos. Este é um exemplo:

      Estou usando as exportações do Gerenciamento de Custos para extrair meus dados de custo para o ADLS. Eu 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 exportConfig.resourceIdAPI que espera que , exportConfig.type, e exportConfig.dataVersion as propriedades sejam entregues de forma consistente. Percebi que esses arquivos não estão sendo incluídos no arquivo de manifesto para esta versão da API para minha exportação executada no <your-export-date>. Minha expectativa é que o arquivo de manifesto nunca seja alterado para uma versão de API existente. Você pode 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 do hub no portal do Azure.
  2. Selecione Configurações>Implantações no menu à esquerda.
  3. Confirme se todas as implantações foram bem-sucedidas. Especificamente, procure os seguintes nomes de implantação:
    • principal
    • centro
    • dataFactoryResources
    • armazenamento
    • Cofre de chaves
  4. Se alguma implantação falhar, examine 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 mais 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 problemas e discussões dentro de dois dias úteis.


Custo Contratado Ausente

Gravidade: Informativo

Esse código de erro é mostrado na x_SourceChanges coluna quando ContractedCost é nulo ou 0 e EffectiveCost é maior que 0. O erro indica que o Gerenciamento de Custos da Microsoft não incluiu ContractedCost as linhas especificadas, o que significa que a economia não pode ser calculada.

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

Para calcular a economia total, é possível unir dados de custo e utilização com preços. Para obter mais informações, consulte o problema #873.


Preço Unitário Contratado Ausente

Gravidade: Informativo

Esse código de erro é mostrado na x_SourceChanges coluna quando ContractedUnitPrice é nulo ou 0 e EffectiveUnitPrice é maior que 0. O erro indica que o Gerenciamento de Custos da Microsoft não incluiu ContractedUnitPrice as linhas especificadas, o que significa que a economia não pode ser calculada.

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

Para calcular a economia total, é possível unir dados de custo e utilização com preços. Para obter mais informações, consulte o problema #873.


MissingListCost

Gravidade: Informativo

Esse código de erro é mostrado na x_SourceChanges coluna quando ListCost é nulo ou 0 e ContractedCost é maior que 0. O erro indica que o Gerenciamento de Custos da Microsoft não incluiu ListCost as linhas especificadas, o que significa que a economia não pode ser calculada.

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

Para calcular a economia total, é possível unir dados de custo e utilização com preços. Para obter mais informações, consulte o problema #873.


PreçoUnitárioFaltandoNaLista

Gravidade: Informativo

Esse código de erro é mostrado na x_SourceChanges coluna quando ListUnitPrice é nulo ou 0 e ContractedUnitPrice é maior que 0. O erro indica que o Gerenciamento de Custos da Microsoft não incluiu ListUnitPrice as linhas especificadas, o que significa que a economia não pode ser calculada.

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

Para calcular a economia total, é possível unir dados de custo e utilização com preços. Para obter mais informações, consulte o problema #873.


NomeDoProvedorFaltando

Gravidade: Informativo

Esse código de erro é mostrado na coluna x_SourceChanges quando ProviderName é nulo. O erro indica que o provedor do conjunto de dados (por exemplo, Gerenciamento de Custos da Microsoft) não incluiu um ProviderName valor para as linhas especificadas.

Mitigação: como alternativa aos dados ausentes, os relatórios do kit de ferramentas FinOps tentam identificar o provedor com base nas colunas disponíveis.


Consulta '...' referencia outras consultas ou etapas

Gravidade: Menor

A origem desse erro é desconhecida. Esse erro pode ser exibido aleatoriamente ao atualizar dados do Power BI.

Mitigação: Se você receber esse erro, por favor, selecione Aplicar alteração novamente.

Esse erro só foi relatado em relatórios de armazenamento. Se você estiver enfrentando tempos longos de atualização de dados ou esse erro com frequência, considere mudar para hubs FinOps com o Data Explorer. O Data Explorer usa relatórios KQL que não exigem agendamento ou atualização incremental. Os dados são extraídos quando o relatório é aberto, portanto, os relatórios sempre mostram os dados mais recentes.


Exceção de Acesso a Recurso Proibido

Severidade: Grave

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 do Blob de Armazenamento. Conceda essa função à conta que carrega dados no Power BI.


O tamanho da carga de resposta é... e excedeu o limite

Severidade: Grave

As consultas do Azure Resource Graph nos relatórios de governança e otimização de carga de trabalho do Power BI podem retornar um erro semelhante a:

Erro OLE DB ou ODBC: [Expression.Error] Forneça as informações abaixo ao solicitar suporte: data e hora = {timestamp}, ID de correlação = {guid}. Detalhes: o tamanho da carga de resposta é {number}e excedeu o limite de 16777216. Considere consultar menos dados por vez e fazer uma chamada paginada, se necessário.

Esse erro significa que você tem mais recursos do que há suporte em uma consulta do Resource Graph não filtrada. Isso acontece porque os relatórios do kit de ferramentas FinOps foram projetados para mostrar detalhes no nível do recurso e não são agregados. Eles são projetados para ambientes de pequeno e médio porte e não projetados para dar suporte a organizações com milhões de recursos.

Mitigação: Caso você experiencie este erro, há várias opções disponíveis:

  • Remova colunas que não são necessárias para suas necessidades.
  • Filtre a consulta para retornar menos recursos com base no que é mais importante para você (por exemplo, assinaturas, marcas).
  • Desabilite a consulta para que ela não bloqueie a execução de outras consultas.

RoleAssignmentUpdateNotAllowed

Gravidade: Menor

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

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

Mitigação: 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 a guia Atribuições de função.
  • Encontre todas as atribuições de função com uma identidade "desconhecida" e exclua-as.

AtribuiçãoDeFunçãoExiste

Gravidade: Menor

Ao atualizar hubs FinOps de uma versão para outra, você poderá encontrar o seguinte erro se as atribuições de função criadas em uma implantação anterior ainda existirem:

"code": "RoleAssignmentExists",
"message": "The role assignment already exists."

Isso provavelmente ocorre porque uma identidade gerenciada foi excluída explicitamente sem remover primeiro todas as atribuições de função.

Mitigação: Para corrigir o problema, exclua as atribuições de função órfãs no Portal do Azure:

  • Navegue até o grupo de recursos ou o recurso afetado (como o cluster do Data Explorer).
  • Selecione controle de acesso (IAM) no menu.
  • Selecione a guia Atribuições de função.
  • Localize as atribuições de função com uma identidade desconhecida e exclua-as.

Falha no SchemaLoadFailed

Gravidade: crítica

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

Mitigação: examine a mensagem de erro para observar 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 compatíveis com a versão implantada dos hubs FinOps. Consulte conjuntos de dados compatíveis para obter detalhes.


EsquemaNãoEncontrado

Gravidade: crítica

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

Mitigação: confirme se há suporte para o tipo e a versão do conjunto de dados. Consulte conjuntos de dados compatíveis para obter detalhes. Se houver suporte para o conjunto de dados, confirme a versão do hub com o relatório de assimilação de dados.

Para adicionar suporte a 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 o Gerenciamento de Custos usa. Para identificar o tipo de dados de cada coluna, use um arquivo de esquema existente como modelo. Alguns conjuntos de dados têm esquemas diferentes para o EA e o MCA (Contrato de Cliente) da Microsoft. 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-nos ao FOCUS.


A URL de armazenamento para importação não corresponde a nenhuma exportação

Severidade: Grave

Se você estiver experimentando isso em relatórios do FinOps toolkit 0.8, o erro será devido a uma referência a um parâmetro que não existe.

Mitigação: isso foi corrigido no FinOps toolkit 0.9. Atualize para a versão mais recente para aplicar a correção. Se você precisar aplicar a correção diretamente aos relatórios 0.8, edite a função ftk_DemoFilter no editor avançado e altere o conteúdo para: () => "". Salve e feche e aplique todas as alterações.


Arquivo de exportação desconhecido

Gravidade: Informativo

O arquivo no armazenamento de 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 do Gerenciamento de Custos. Mova outros arquivos em outro contêiner de armazenamento.


VersãoDesconhecidaDoFoco

Gravidade: Informativo

Esse código de erro é mostrado na coluna x_SourceChanges quando uma versão FOCUS não pôde ser identificada.

Mitigação: Valide se o conjunto de dados FOCUS está usando uma versão compatível do FOCUS. Relate este problema com uma amostra anônima dos dados em https://aka.ms/ftk/ideas para investigação adicional.


Versão UnknownHubVersion

Gravidade: crítica

Não é possível identificar a versão dos hubs FinOps no 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.

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


TipoDeArquivoDeExportaçãoNãoSuportado

Gravidade: crítica

Não é possível ingerir o arquivo de exportação especificado porque não há suporte para o tipo de arquivo.

Mitigação: converta o arquivo em um formato de arquivo com suporte antes de adicioná-lo ao contêiner msexports ou adicione suporte para converter o novo tipo de arquivo no pipeline msexports_ETL_ingestion .


TipoDeExportaçãoNãoSuportado

Severidade: 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 Gerenciamento de Custos 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 {name} não está registrado na assinatura {guid}

Gravidade: Menor

Abra a assinatura no portal do Azure, selecione Configurações>Provedores de recursos, selecione a linha do provedor de recursos (por exemplo, Microsoft.EventGrid) e selecione o comando Registrar na parte superior da página. O registro pode levar alguns minutos.


x_PricingSubcategory mostra a ID do desconto de compromisso

As exportações do Gerenciamento de Custos antes de 28 de fevereiro de 2024 tinham um bug em que x_PricingSubcategory estava sendo definido 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, exporte novamente os dados de custo desse mês. Se você precisar exportar dados de um mês mais antigo que não está disponível, entre em contato com o suporte para solicitar que os dados sejam exportados para resolver o problema de qualidade de dados das execuções de exportação anteriores.


Power BI: os relatórios não têm dados para datas específicas

Se o relatório não tiver 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 você 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 fechado de meses.
  • 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 você não vir nenhum dado em seu Power BI ou em outros relatórios ou ferramentas, tente o seguinte com base em sua fonte 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 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 contêiner 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>e verifique se o > foi iniciado. Se não, inicie-o.

Se o gatilho não for iniciado com um erro "provedor de recursos não está registrado", abra a assinatura no portal do Azure, selecione Configurações>Provedores de recursos, selecione a linha Microsoft.EventGrid e selecione o comando Registrar na parte superior da página. O registro pode levar 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 do Gerenciamento de Custos conectadas. Os dados devem ser totalmente ingeridos dentro de 10 a 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 contêiner de ingestão está preenchido e atualize seus relatórios ou outras ferramentas conectadas.

Hubs FinOps: arquivos disponíveis no contêiner de ingestão

Se o contêiner de assimilação não estiver vazio, confirme se você tem arquivos parquet ou csv.gz 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 você estiver usando outra ferramenta, verifique se ela é compatível com o tipo de arquivo que você está usando.


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 nulo 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 a ID da conta de cobrança desejada. Se você não tiver acesso à conta de cobrança ou não quiser incluir compras e reembolsos de compromisso, defina o valor e 0 abra a consulta CostDetails no editor avançado e altere o 2 para um 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 (corrigido em 0.2)


Hubs FinOps: não é possível converter o valor nulo para o tipo Table

Esse erro normalmente indica que os dados não foram ingeridos no contêiner de ingestão.

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

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


Fornecer comentários

Deixe-nos saber como estamos indo com uma avaliação rápida. Usamos essas revisões para melhorar e expandir ferramentas e recursos do FinOps.

Envie comentários

Se você estiver procurando algo específico, vote em um existente ou crie uma ideia. Compartilhe ideias com outras pessoas para obter mais votos. Nós nos concentramos nas ideias com mais votos.

Votar ou sugerir ideias


Conteúdo relacionado

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


  • Last updated on