Partilhar 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 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.


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.

Atenuação: Confirme que está a usar a conta correta no tenant correto do Microsoft Entra ID.


PropriedadeDaContaNãoPodeSerAtualizada

Gravidade: Crítica

Esse erro normalmente ocorre ao atualizar uma implantação de 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 foi 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 não tenhas a intenção de alterar esta configuração, confirma que a tua conta de armazenamento está configurada para utilizar criptografia de infraestrutura e volta a implementar o modelo do hub FinOps com o mesmo parâmetro (ativado ou desativado). Se você quiser alterar a configuração, recomendamos implantar uma nova instância do hub FinOps, pois isso exigirá a regestão 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 o testámos exaustivamente. Embora não prevejamos problemas, não podemos confirmar se isso causará problemas.


Versão do Hub Defeituosa

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 'Recursos' contém um valor duplicado

Gravidade: Crítica

Se você enfrentar o seguinte erro, isso significa que o Azure Resource Graph está retornando linhas com o mesmo valor lógico para a coluna id . Isso pode acontecer quando os valores de ID do recurso têm caixa inconsistente ou quando outra coluna é expandida entre linhas.

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

Mitigação: Garanta que está a utilizar a versão mais recente do relatório. Identifique a causa dos valores duplicados e atualize a consulta para contornar os valores duplicados. Informe 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 a causa do erro.


ErroDeConflito

Gravidade: Crítica

Pode haver várias instâncias desse erro. A única instância conhecida é quando o Key Vault retorna a seguinte mensagem de 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 suave.

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

Atenuação: Para corrigir isso, elimine o Key Vault excluído no Portal do Azure.

  1. Abra a lista de instâncias do Cofre da Chave 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 deslizante.
  6. Selecione Eliminar no diálogo de confirmação.

Agora você pode tentar novamente a implantação.


CustoContratadoMenorQueCustoEfetivo

Gravidade: Aviso

ContractedCost (com base em descontos negociados) é menor do que EffectiveCost (após descontos de compromisso) nos dados da Gestão de Custos. Isso nunca deve acontecer, a menos que o desconto de compromisso ofereça menos desconto do que os descontos negociados existentes. Isso fará com que seus cálculos de economia não sejam precisos.

Mitigação: confirme se os ContractedUnitPrice dados de custo correspondem ao que está nos dados de preço. Se o preço contratado estiver correto, apresente um pedido de suporte à equipa de Gestão de Custos para confirmar o x_EffectiveUnitPrice e EffectiveCost estão corretos. Se estiverem corretas, considere devolver o desconto de compromisso.


A política de acesso entre locatários não permite o acesso deste utilizador

Gravidade: Grave

Se ocorrer o seguinte erro, significa que o Microsoft Entra ID está configurado para não permitir que utilizadores de outros inquilinos iniciem sessão no inquilino atual.

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

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

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


DataExplorerFalhaNaIntegração

Gravidade: Crítica

Falha na ingestão do Data Explorer. Os novos dados não estarão disponíveis para comunicação.

Mitigation: Revise a mensagem de erro no Data Explorer e resolva o problema. Execute novamente a ingestão de dados para a pasta especificada usando o pipeline de ingestion_ExecuteETL no Azure Data Factory. Denuncie problemas não resolvidos em https://aka.ms/ftk/ideas.


FalhaNoMapeamentoDeIngestãoDataExplorer

Gravidade: Crítica

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

Mitigation: Corrija o erro e execute novamente a ingestão para o caminho da pasta especificada. Se continuar a ver este erro, reporte um problema em https://aka.ms/ftk/ideas.


DataExplorerIngestionTimeout

Gravidade: Crítica

A ingestão do Data Explorer expirou após 2 horas enquanto aguardava a capacidade disponível.

Mitigação: Execute novamente este pipeline para tentar ingerir novamente. Se continuar a ver este erro, reporte um problema em https://aka.ms/ftk/ideas.


Falha na Eliminação Pós-Ingestão do DataExplorer

Gravidade: Crítica

Falha na limpeza pós-ingestão do Data Explorer (soltar extensões 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.

Mitigation: Revise a mensagem de erro no Data Explorer e resolva o problema. Execute novamente a ingestão de dados para a pasta especificada usando o pipeline de ingestion_ExecuteETL no Azure Data Factory. Denuncie problemas não resolvidos em https://aka.ms/ftk/ideas.


DataExplorerPreIngestionDropFailed

Gravidade: Crítica

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

Mitigation: Revise a mensagem de erro no Data Explorer e resolva o problema. Execute novamente a ingestão de dados para a pasta especificada usando o pipeline de ingestion_ExecuteETL no Azure Data Factory. Denuncie problemas não resolvidos em https://aka.ms/ftk/ideas.


ImplementaçãoResultadoAvaliaçãoFalhou

Gravidade: Grave

O FinOps hubs 0.8 define 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 hubs FinOps 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: implante 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.

Atenuação: Confirme que uma exportação do Gerenciamento de Custos foi criada e configurada com a conta de armazenamento, o container 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.


TipoDeExportaçãoNãoDefinido

Gravidade: Crítica

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

Atenuação: remova o escopo de faturamento sem suporte do settings.json, confirme se o escopo de faturamento é suportado por hubs FinOps e crie manualmente novas exportações de gerenciamento de custos para o escopo de faturamento.


ExportTypeSem suporte

Gravidade: Crítica

Os Contratos de Cliente da Microsoft não são suportados para exportações geridas.

Atenuação: Remova o escopo de faturação do MCA do settings.json e crie manualmente novas exportações do Gerenciamento de Custos para cada perfil de faturação do MCA, incluindo custos, folha de preços, detalhes de reserva, transações de reserva e recomendações de reserva para o FOCUS.


DadosDoHubNãoEncontrados

Gravidade: Crítica

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

Mitigation: Este erro pressupõe que está a ligar-se a uma implementação de hub FinOps. Se estiver usando exportações brutas, corrija o caminho de armazenamento para não fazer referência ao contêiner ingestion. Confirme o seguinte:

  1. O URL de armazenamento deve corresponder à saída StorageUrlForPowerBI na implementaçã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 da fábrica de dados do hub FinOps devem todos ser iniciados.
  5. Os fluxos de trabalho da fábrica de dados do hub FinOps devem ser bem-sucedidos.

Para obter mais detalhes e etapas de depuração, consulte Validar a implementação do hub FinOps.


FicheirosDeIngestãoNãoEncontrados

Gravidade: Crítica

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

Mitigação: confirme se o caminho da pasta é o caminho completo, incluindo o recipiente de ingestão e que não deve começar nem terminar com uma barra (/). Copie o caminho a partir da última execução bem-sucedida do pipeline 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:

O cliente Kusto não conseguiu enviar uma solicitação para o serviço: 'Não é possível ler dados da conexão de transporte: uma conexão existente foi fechada à força pelo host remoto.' `

A razão exata para este erro é desconhecida. Se você experimentar, envie uma solicitação de suporte ao Microsoft Fabric para investigar mais.

Atenuação: como solução alternativa, altere o consumo mínimo da casa de eventos Fabric para Médio (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, consulte Consumo mínimo na visão geral da casa de eventos.


Custo Eficaz Inválido

Gravidade: Grave

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

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


ContentorDeExportaçãoInválido

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.


Versão de Exportação Inválida (InvalidExportVersion)

Gravidade: Crítica

Os hubs FinOps exigem exportações de custos FOCUS, mas este arquivo assemelha-se a uma exportação antiga da Gestão de Custos.

Mitigação: crie uma nova exportação da Gestão de Custos para os custos do FOCUS e interrompa a exportação atual ou altere-a para exportar para um contentor de armazenamento diferente.


VersãoDoHubInvá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 FinOps ou baixe relatórios do Power BI da versão 0.1.1.


InvalidScopeId

Gravidade: Informação

O caminho de exportação não é um ID de escopo válido. Os hubs FinOps esperam que o caminho de exportação seja o ID de um recurso do Azure para o âmbito no qual a exportação foi criada, de modo a 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 o identificador de recurso completo do Azure para o escopo.


LegacyFocusVersion

Gravidade: Informação

Esse código de erro é mostrado quando os dados ingeridos usam uma versão mais antiga do FOCUS. Quando encontrado na coluna x_SourceChanges, o código é apenas informativo. Quando os relatórios de armazenamento do Power BI mostram que a consulta de Custos falhou ao carregar, isso significa que o parâmetro Preterido: Executar otimizações de consulta extra está desabilitado.

Os hubs FinOps convertem dados para a versão mais recente do FOCUS, portanto, isso não deve causar problemas; 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 mitigar esta mensagem, dependendo da ferramenta que estás a usar.

Se estiver a usar hubs FinOps com o Data Explorer e a observar esta situação na coluna x_SourceChanges da tabela de Custos ou em funções relacionadas, atualize as exportações de custos da Gestão de Custos para usar a versão mais recente do FOCUS. Não é necessário fazer alterações adicionais, todos os dados serão mesclados durante a ingestão do Data Explorer.

Se estiver usando relatórios de armazenamento e ver isso na coluna x_SourceChanges da consulta Custos, esta mensagem é um aviso de que essa versão do 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 do Gerenciamento de Custos para a versão mais recente do FOCUS, exclua ou mova dados mais antigos usando uma versão mais antiga do FOCUS e reexporte os dados históricos. Se estiver a usar hubs FinOps, elimine ou mova dados para fora do contentor de ingestão de . Se hospedar suas próprias exportações no armazenamento, altere o parâmetro URL de armazenamento para um caminho de pasta diferente que não inclua versões mais antigas do FOCUS.

A partir do kit de ferramentas FinOps 0.7, o suporte para versões mais antigas do FOCUS 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 Descontinuado: Executar Otimizações de Consulta Extras como TRUE para garantir que as versões mais antigas do FOCUS sejam suportadas e defina-o como FALSE para acelerar o desempenho e oferecer suporte a conjuntos de dados maiores, abrangendo mais custo ou tempo. A partir de 0,7, esse parâmetro é habilitado por padrão para compatibilidade com versões anteriores. No FinOps toolkit 0.8, ele será desativado por padrão, mas ainda estará disponível para compatibilidade com versões anteriores até junho de 2025 ou após ele. Se você não puder sair das versões antigas do FOCUS ou para obter o melhor desempenho e suporte para contas maiores ou períodos de tempo mais longos, recomendamos o uso de hubs FinOps com o Data Explorer.


CustoListaInferiorAoCustoContratado

Gravidade: Aviso

ListCost (com base nos preços públicos, de retalho) é inferior ao ContractedCost (com base nos descontos negociados), segundo os dados de Gestão de Custos. Isso nunca deveria acontecer. Isso fará com que seus cálculos de economia não sejam precisos.

Mitigação: confirme se os ListUnitPrice dados de custo correspondem ao que está nos dados de preço. Se o preço de tabela estiver correto, envie um pedido de suporte à equipa de gestão de custos para confirmar se tanto ListUnitPrice quanto ContractedUnitPrice estão corretos e para explicar por que o preço após os descontos negociados seria mais alto do que as tarifas públicas de retalho.


Falha na Leitura do Manifesto

Gravidade: Crítica

O hub FinOps msexports_ExecuteETL pipeline falhou na leitura do ficheiro de manifesto do Gerenciamento de Custos.

Mitigação:

  1. Se o erro ocorreu numa instância de hub de trabalho, quando nenhuma alteração foi feita no hub ou na exportação, a Gestão 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 (#1) ou a versão da API (#2):

  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é Autor > Pipelines > msexports_ExecuteETL, selecione as atividades aplicáveis "Set" 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 assim, reporte o problema e considere partilhar 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 mudança disruptiva, crie uma questão de pedido de alteração no GitHub. Inclua o tipo, dataVersion e apiVersion do seu arquivo manifest.json.
    2. Envie uma solicitação de suporte à Gestão de Custos para pedir que a alteração deles seja revertida, pois afeta todos os utilizadores 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 (Azure Data Factory) que está a processar os dados quando os ficheiros de manifesto são criados. O meu pipeline foi construído na versão <your-supported-api-version> da API, que espera que as propriedades exportConfig.resourceId, exportConfig.type, e exportConfig.dataVersion 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 por os seguintes nomes de implantação:
    • principal
    • centro
    • dataFactoryRecursos
    • armazenamento
    • 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.


Custo Contratado Ausente

Gravidade: Informação

Esse código de x_SourceChanges 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 coluna ContractedCost nas linhas sinalizadas com este código de erro. As poupanças não estão disponíveis para estes registos.

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.


Preço Unitário Contratado em Falta

Gravidade: Informação

Esse código de x_SourceChanges 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 coluna ContractedUnitPrice nas linhas sinalizadas com este código de erro. As poupanças não estão disponíveis para estes registos.

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: Informação

Esse código de x_SourceChanges 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 coluna ListCost nas linhas sinalizadas com este código de erro. As poupanças não estão disponíveis para estes registos.

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.


PreçoUnitárioEmFalta

Gravidade: Informação

Esse código de x_SourceChanges 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 coluna ListUnitPrice nas linhas sinalizadas com este código de erro. As poupanças não estão disponíveis para estes registos.

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.


NomeDoFornecedorEmFalta

Gravidade: Informação

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

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


Consulta '...' faz referência a outras consultas ou etapas

gravidade: menor

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

Mitigação: Se receberes este erro, seleciona Aplicar mudança novamente.

Este erro só foi relatado em relatórios de armazenamento. Se tiver longos tempos de atualização de dados ou experienciar este 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.


ResourceAccessForbiddenException (or, if translation is needed for clarity, Exceção de Acesso a Recurso Proibido)

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


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

Gravidade: Grave

As consultas do Gráfico de Recursos do Azure nos relatórios de Governança e Otimização da 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: timestamp = {timestamp}, correlationId = {guid}. Detalhes: O tamanho da carga útil da resposta é {número} e excedeu o limite de 16777216. Por favor, considere consultar menos dados de cada vez e fazer chamadas paginadas, se necessário.

Este erro significa que tem mais recursos do que os suportados numa consulta do Gráfico de Recursos não filtrada. Isso acontece porque os relatórios do kit de ferramentas FinOps são projetados para mostrar detalhes no nível de recursos 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: Se experienciar este erro, existem várias opções para enfrentá-lo:

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

AtualizaçãoDeAtribuiçãoDeFunçãoNãoPermitida

gravidade: menor

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."

Atenuaçã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 o separador Atribuição de funções.
  • Encontre quaisquer atribuições de função com uma identidade "desconhecida" e exclua-as.

ExistênciaDeAtribuiçãoDeFunção

gravidade: menor

Ao atualizar hubs FinOps de uma versão para outra, você pode 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 explicitamente excluída sem primeiro remover todas as suas atribuições de função.

Atenuação: Para corrigir esse problema, elimine 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 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 hub de FinOps msexports_ETL_ingestion falhou ao carregar o ficheiro 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.


EsquemaNãoEncontrado

Gravidade: Crítica

O hub FinOps msexports_ExecuteETL pipeline não conseguiu encontrar o ficheiro de correspondência 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 a trabalhar para adicionar conjuntos de dados e considerar as diferenças de EA e MCA alinhando com o FOCUS.


O URL de armazenamento da importação não corresponde a nenhuma exportação

Gravidade: Grave

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

Mitigação: Isso foi corrigido no kit de ferramentas FinOps 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: () => "". Guarde, feche e aplique todas as alterações.


FicheiroDeExportaçãoDesconhecido

Gravidade: Informação

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.


VersãoDesconhecidaFoco

Gravidade: Informação

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á a usar uma versão FOCUS suportada. Denuncie esse problema com uma amostra anônima dos dados em https://aka.ms/ftk/ideas para investigar mais.


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.

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


Tipo de ficheiro de exportação não suportado

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 ficheiro para um formato suportado antes de adicioná-lo ao contentor msexports ou adicione suporte para converter o novo tipo de ficheiro para o pipeline msexports_ETL_ingestion.


TipoDeExportaçãoNãoSuportado

Gravidade: Aviso

O manifesto de exportação no armazenamento do hub indica que a exportação foi para um conjunto de dados não suportado. Os dados exportados são apresentados como erros de ingestão.

Mitigação: crie uma nova exportação da Gestão de Custos para os custos do FOCUS e interrompa a exportação atual ou altere-a para exportar para um contentor de armazenamento diferente.


O provedor de recursos {name} não está registrado na assinatura {guid}

gravidade: menor

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 vires esses valores, reexporta 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 a usar hubs FinOps, verifique a conta de armazenamento para garantir que os dados são preenchidos no contentor de ingestão. Você deve ver provedores ou uma pasta de assinaturas. Use as seções a seguir para solucionar problemas adicionais.

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

Se o contentor de ingestão estiver vazio, abra a instância do Data Factory no Data Factory Studio e selecione Gerir>Autor>Gatilhos e verifique se o gatilho 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 actualize os seus relatórios ou outras ferramentas conectadas.

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

Se o recipiente de ingestão não estiver vazio, confirme se tem arquivos parquet ou csv.gz nas suas 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: Não foi possível resolver o nome remoto: '<storage-account.dfs.core.windows.net>'

Indica que o nome da conta de armazenamento está incorreto. Se estiver a usar hubs FinOps, verifique o parâmetro StorageUrl da implementaçã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 O relatório informa que não deve 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 ingestão.

Se acabou de atualizar para o FinOps Hubs 0.2, o problema pode ser resultado de o relatório do Power BI ser antigo (versão 0.1.x) ou porque não está a usar as 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.


Enviar comentários

Dê-nos a sua opinião com uma breve avaliação. Usamos essas análises para melhorar e expandir as ferramentas e os recursos do FinOps.

Enviar comentários

Se você está procurando algo específico, vote em uma ideia existente ou crie uma nova. Partilhe ideias com outras pessoas para obter mais votos. Focamo-nos nas ideias mais votadas.

Votar ou sugerir ideias


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.


  • Last updated on