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.

Erro comum: SEM0080 assert() falhou com a seguinte mensagem 'Falha na ingestão'

Se você vir o seguinte erro semântico no pipeline do Azure Data Factory:

Erro semântico: Erro semântico de operador relacional: SEM0080: assert() falhou com a mensagem: 'Falha na ingestão'

Esse erro indica que o comando Data Explorer .ingest detectou erros durante o processo de ingestão. O comando de ingestão inclui uma checagem de asserção (assert(iff(toscalar($command_results | project-keep HasErrors) == false, true, false), "Ingestion Failed")) que verifica a coluna HasErrors nos resultados do comando. Quando HasErrors é true, a asserção falha e dispara esse erro.

Causas raiz comuns:

  • Arquivo parquet vazio: o arquivo parquet não contém linhas de dados. Essa é a causa mais comum.

    • A exportação de Gerenciamento de Custos gerou um arquivo vazio (sem dados para o período de tempo)
    • O pipeline de ETL criou um arquivo parquet vazio durante a transformação
    • O arquivo foi criado, mas a operação de gravação de dados falhou

  • Incompatibilidade de esquema: o esquema de arquivo parquet não corresponde à referência de mapeamento de ingestão para a tabela de destino.

    • As colunas no arquivo parquet podem ter nomes ou tipos de dados diferentes do esperado
    • O mapeamento de ingestão (por exemplo, <table>_mapping) pode estar desatualizado ou incorreto
    • Novas colunas foram adicionadas ao esquema de exportação que não estão no mapeamento

  • Arquivos parquet corrompidos ou inválidos: o arquivo de origem pode estar malformado, corrompido ou não ser um arquivo parquet válido.

  • Mapeamento de ingestão ausente ou incorreto: o mapeamento referenciado (por exemplo, Costs_raw_mapping) não existe ou tem definições de coluna incorretas.

  • Erros de conversão de tipo de dados: os dados no arquivo parquet não podem ser convertidos nos tipos de coluna de destino definidos no esquema de tabela.

  • Problemas de acesso a arquivos: o Data Explorer não pode acessar o arquivo parquet no armazenamento devido a permissões ou problemas de rede.

Etapas de mitigação:

  1. Verifique falhas de ingestão no Data Explorer:

    • Conectar-se ao cluster/banco de dados do Data Explorer
    • Execute a consulta a seguir para ver informações detalhadas de erro: 
      .show ingestion failures
| where FailedOn > ago(4h) and Database == "<YourDatabaseName>"
| project FailedOn, Table, IngestionSourcePath, ErrorCode, Details
    • Examine a Details coluna para obter mensagens de erro específicas sobre arquivos vazios, incompatibilidades de esquema ou problemas de dados
    • Procure códigos de erro como BadRequest_NoRecordsOrWrongFormat o que indica um arquivo vazio

  2. Verifique se o arquivo parquet está vazio:

    • Baixe o arquivo parquet problemático do contêiner de ingestão (o caminho está na mensagem de erro)
    • Use uma ferramenta de visualização de arquivos Parquet ou Azure Storage Explorer para inspecionar o arquivo
    • Verifique o tamanho do arquivo - se ele for muito pequeno (< 1KB), provavelmente estará vazio
    • Verificar se o arquivo contém linhas de dados
    • Se estiver vazio: esse é o comportamento esperado quando não há dados para o período de tempo. O arquivo pode ser excluído com segurança do contêiner de ingestão. O Gerenciamento de Custos pode exportar arquivos vazios por meses sem uso.

  3. Verifique se o mapeamento de ingestão existe e se está correto:

    • Execute esta consulta no Data Explorer para verificar se o mapeamento existe: 
      .show table <TableName> ingestion mappings
    • Se o mapeamento estiver ausente, ele precisará ser recriado. Verifique os logs de implantação do hub FinOps para identificar erros de criação de mapeamento.
    • Se o mapeamento existir, verifique se ele corresponde ao esquema esperado para sua fonte de dados

  4. Verifique se há alterações de esquema:

    • Se você atualizou recentemente as exportações de Gerenciamento de Custos ou alterou as versões de exportação (por exemplo, de FOCUS 1.0 para 1.2), o esquema pode ter sido alterado
    • Verificar a versão do conjunto de dados de exportação no arquivo manifest.json no contêiner msexports
    • Confirme se os hubs FinOps dão suporte à versão do conjunto de dados – consulte os conjuntos de dados com suporte

  5. Verifique o diagnóstico do Data Explorer:

    • No portal do Azure, navegue até o cluster do Data Explorer
    • Ir para Monitoramento>as configurações de Diagnóstico
    • Habilitar FailedIngestion logs de diagnóstico caso ainda não estejam habilitados
    • Revisar logs no Log Analytics para obter informações detalhadas sobre erros

  6. Reimplante hubs FinOps se os mapeamentos estiverem ausentes:

    • Se os mapeamentos de ingestão estiverem ausentes ou corrompidos, reimplante hubs FinOps para recriá-los
    • Isso recriará todas as tabelas, mapeamentos e funções sem perda de dados

  7. Examine as métricas do Azure Data Explorer:

    • Verificar a métrica do Resultado de Ingestão no Azure Monitor
    • Filtrar por status para ver êxito versus taxas de falha
    • Consulte Monitorar a ingestão enfileirada para obter mais detalhes

  8. Execute a ingestão novamente após corrigir o problema:

    • Depois de resolver a causa raiz, execute novamente o ingestion_ExecuteETL pipeline
    • Especificar o caminho da pasta da mensagem de erro como o parâmetro
    • Monitorar a execução do pipeline para confirmar uma bem-sucedida ingestão.
    • Observação: arquivos vazios não precisam ser reingestados - eles podem ser ignorados com segurança

Recursos adicionais:

Se você continuar a experimentar esse erro após seguir estas etapas, relate o problema com as seguintes informações:

  • Mensagem de erro completa do pipeline do ADF
  • Saída da .show ingestion failures consulta
  • Tipo de conjunto de dados e versão do arquivo manifest.json
  • Versão dos hubs FinOps

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.

Esse erro pode acontecer quando:

  • O cluster do Data Explorer está enfrentando problemas de capacidade ou alta utilização de recursos
  • O comando drop extents encontra uma expressão inválida ou erro de sintaxe
  • Há problemas de permissão ao acessar o banco de dados do Data Explorer
  • Problemas de conectividade de rede entre o Data Factory e o Data Explorer

Atenuação:

  1. Revise a mensagem de erro detalhada: Navegue até Azure Data Factory > Monitor > Execuções de Pipeline > Clique na execução com falha > Veja a atividade "Erro de Falha Pós-Ingestão" para ver o código de erro específico e a mensagem do Data Explorer.

  2. Soluções comuns com base no tipo de erro:

    • Se você vir "Falha ao interpretar a mensagem ou código de erro de falha após a ingestão": Isso indica que a expressão dinâmica na atividade Fail não pôde ser avaliada. Isso normalmente significa:

      • A Post-Ingest Cleanup atividade falhou, mas não retornou detalhes de erro no formato esperado
      • Verificar a saída da atividade Post-Ingest Cleanup para o erro real do Data Explorer
      • Consulte ErrorCodeNotString para obter mais detalhes sobre esse padrão de erro específico

    • Para problemas de capacidade/recurso:

      • Aguarde alguns minutos e execute novamente o pipeline
      • Verificar as métricas de cluster do Data Explorer no Azure Monitor
      • Considere expandir o cluster se atingir consistentemente os limites de capacidade

    • Para problemas de permissão:

      • Verifique se a identidade gerenciada do Data Factory tem permissões adequadas no banco de dados do Data Explorer
      • Verifique se a identidade gerenciada tem pelo menos funções "Ingestor de Banco de Dados" e "Administrador de Banco de Dados"

    • Para erros de sintaxe/expressão:

      • Revise os logs de comandos do Data Explorer usando o editor de consultas do Data Explorer .show commands
      • Verifique se há alterações recentes de esquema que podem afetar a consulta de extensões de queda

  3. Executar novamente a ingestão: depois que o problema for resolvido, execute novamente a ingestão de dados para a pasta especificada usando o ingestion_ExecuteETL pipeline no Azure Data Factory.

  4. Impedir a duplicação de dados: se o erro persistir, talvez seja necessário limpar manualmente extensões duplicadas usando comandos do Data Explorer antes de executar novamente a ingestão. Contate o suporte para obter assistência.

Para obter mais informações, consulte:

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.

Esse erro ocorre quando a etapa de limpeza do Data Explorer que é executada antes da ingestão de novos dados falhar. Essa limpeza é necessária para evitar dados duplicados nas tabelas brutas.

Atenuação:

  1. Revise a mensagem de erro detalhada: Navegue até Azure Data Factory > execuções do Pipeline > de monitoramento > Clique na execução falhada > Exibir a atividade "Erro de Falha na Queda de Pré-Ingestão" para ver o código de erro e a mensagem específicos do Data Explorer.

  2. Soluções comuns com base no tipo de erro:

    • Se você vir "Falha ao interpretar a mensagem ou código de erro 'Pre-Ingest Drop Failed Error'": consulte ErrorCodeNotString para obtenção de etapas de solução de problemas.

    • Para problemas de capacidade/recurso:

      • Aguarde alguns minutos e reexecute o pipeline
      • Verificar as métricas de cluster do Data Explorer no Azure Monitor

    • Para problemas de permissão:

      • Verifique se a identidade gerenciada do Data Factory tem a função "Administrador de Banco de Dados" no banco de dados do Data Explorer

    • Para erros de sintaxe/expressão:

      • Revise os logs de comandos do Data Explorer no editor de consultas do Data Explorer usando .show commands

  3. Executar novamente a ingestão: depois que o problema for resolvido, execute novamente a ingestão de dados para a pasta especificada usando o ingestion_ExecuteETL pipeline no Azure Data Factory.

Para obter mais informações, consulte os procedimentos de mitigação para o DataExplorerPostIngestionDropFailed.

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, 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 os hubs de FinOps, corrija a URL de armazenamento para apontar para o contêiner de 'ingestion'. Consulte a saída storageUrlForPowerBI da implantação do hub FinOps para ver 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.


ErrorCodeNotString

Gravidade: Crítica

Esse erro ocorre quando uma atividade de falha do Azure Data Factory não pode avaliar sua mensagem de erro dinâmica ou expressão de código de erro para uma cadeia de caracteres válida. Normalmente, a mensagem de erro é exibida como "Falha ao interpretar [activity_name] mensagem de falha ou código de erro" com código ErrorCodeNotStringde erro.

Cenários comuns:

  • Uma atividade pai (como Post-Ingest Cleanup, Pre-Ingest Cleanupou Ingest Data) falhou, mas não produziu saída de erro no formato esperado
  • A expressão dinâmica tenta acessar uma propriedade que não existe na saída da atividade
  • A saída da atividade é nula, vazia ou não está no formato esperado de estrutura JSON.

Atenuação:

  1. Identifique a atividade de causa raiz: examine qual atividade disparou a atividade Fail (por exemplo, se você vir "Erro de Falha no Descarte pós-ingestão", verifique a atividade "Limpeza pós-ingestão").

  2. Revise a saída da atividade principal:

    • Navegue para o Monitor do Azure Data Factory > execuções de Pipeline >
    • Clique na execução do pipeline com falha
    • Localize e clique na atividade que foi executada pouco antes da atividade Fail
    • Examine a guia "Saída" para ver os detalhes reais do erro
    • Procure mensagens de erro ou códigos que expliquem por que a atividade falhou

  3. Verifique se há problemas específicos do Data Explorer relacionados a erros no pipeline de ingestão:

    • Capacidade do recurso: o cluster do Data Explorer pode estar em capacidade. Verifique as métricas do cluster no Azure Monitor.
    • Erros de sintaxe de comando: examine o histórico de comandos do Data Explorer usando .show commands o editor de consultas.
    • Problemas de permissão: verifique se a identidade gerenciada tem permissões de banco de dados adequadas.
    • Conectividade de rede: verifique se o Data Factory pode alcançar o cluster do Data Explorer.

  4. Comandos comuns de solução de problemas do Data Explorer:

    // Check recent failed operations
.show operations
| where StartedOn > ago(4h) and State == "Failed"

// Check ingestion failures
.show ingestion failures
| where FailedOn > ago(4h)

// Check command history
.show commands
| where StartedOn > ago(4h)

  5. Depois de resolver o problema subjacente: execute novamente o pipeline com falha do Azure Data Factory.

Erros relacionados: Esse erro geralmente é visto em conjunto com:

Para obter mais informações, consulte:

Relate os problemas não resolvidos no https://aka.ms/ftk/ideas.


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 à saída StorageUrlForPowerBI 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. Todos os gatilhos do 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 de 'ingestão' é usado apenas para consultar os dados de custo ingeridos.


VersãoDeExportaçãoInválida

Gravidade: Crítica

Os hubs do 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 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 de Hub inválida

Gravidade: Crítica

Os FinOps hubs 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: Informacional

O caminho de exportação não é uma ID de escopo válida. Os hubs do FinOps esperam que o caminho de exportação seja um ID de recurso do Azure para o escopo no qual 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, utilizando o ID completo do recurso do Azure para o escopo.


LegacyFocusVersion

Gravidade: Informacional

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.

Para obter detalhes sobre como os problemas de qualidade dos dados afetam os cálculos de economia, consulte Noções básicas sobre cálculos de economia.


Falha na Leitura do Manifesto

Gravidade: Crítica

O pipeline do hub FinOps msexports_ExecuteETL 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 para baixo pela hierarquia de arquivos para localizar 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 configurados com 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 diferencia maiúsculas de minúsculas.
    • type deve existir, mas não deve apresentar 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é Autor> Pipeline> msexports_ExecuteETL, selecione as atividades aplicáveis de "Set" e atualize a propriedade Configurações>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 designer de pipeline.

  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 (Azure Data Factory) que processa os dados quando os arquivos de manifesto são escritos. 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. 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
    • hub
    • 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 questões e discussões dentro de três dias úteis. Precisa de ajuda ao vivo? Ingresse em nosso horário de escritório quinzenal.


Ausência de Custo Contratado

Gravidade: Informacional

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 para as linhas especificadas, o que significa que as economias não podem ser calculadas.

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. Economias não estão disponíveis 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: Informacional

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 para as linhas especificadas, o que significa que a economia não pode ser calculada.

Mitigação: Como solução alternativa para os dados ausentes, nos relatórios do Kit de Ferramentas FinOps, copia-se o EffectiveUnitPrice para a coluna ContractedUnitPrice das linhas sinalizadas com esse código de erro. Economias não estão disponíveis 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.

Para obter detalhes sobre como os preços ausentes afetam os cálculos de poupança, consulte Noções básicas sobre cálculos de poupança.


MissingListCost

Gravidade: Informacional

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 nas 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 conjunto de ferramentas FinOps copiam o ContractedCost para a coluna ListCost 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: Informacional

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 nas linhas especificadas, o que significa que não é possível calcular economias.

Mitigação: como solução alternativa para os dados ausentes, os relatórios do kit de ferramentas FinOps copiam o ContractedUnitPrice na coluna ListUnitPrice para as 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.

Para obter detalhes sobre como os preços ausentes afetam os cálculos de poupança, consulte Noções básicas sobre cálculos de poupança.


NomeDoProvedorFaltando

Gravidade: Informacional

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çãoDeAcessoARecursoProibido

Severidade: Grave

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

Indica que a conta de carregamento de 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.

RoleAssignmentUpdateNãoPermitido

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.

SchemaLoadFailed

Gravidade: Crítica

O hub FinOps msexports_ETL_ingestion pipeline 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 FinOps hub msexports_ExecuteETL 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: Informacional

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: Informacional

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: Ou converta o arquivo para um formato de arquivo com suporte antes de adicioná-lo ao contêiner msexports, ou adicione suporte para a conversão do 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 o 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 chamada provedores ou assinaturas. Use as seções a seguir para solucionar problemas adicionais.

Centros de 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>Autor>Gatilhos e verifique se o gatilho msexports_FileAdded 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 disparador 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 arquivos csv.gz navegando pelas 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 para 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)


Power BI: Não é possível converter o valor nulo para digitar Tabela

Gravidade: Crítica

Esse erro pode ocorrer ao conectar relatórios de armazenamento do Power BI a uma conta de armazenamento usando o ponto de extremidade blob em vez do ponto de extremidade necessário do Data Lake Storage (DFS).

Mitigação: Atualize o parâmetro de URL de armazenamento para utilizar o ponto de extremidade do Data Lake Storage.

  1. Altere .blob.core.windows.net para .dfs.core.windows.net na sua URL de Armazenamento.
  2. Se estiver usando o portal do Azure:
    • Abrir sua conta de armazenamento
    • Selecione Configurações>Pontos de Extremidade
    • Copiar a URL do Data Lake Storage (não a URL do serviço Blob)

Por exemplo:

  • ❌ Incorreto: https://mystorageaccount.blob.core.windows.net/container
  • ✅ Correto: https://mystorageaccount.dfs.core.windows.net/container

Se você ainda estiver enfrentando problemas depois de usar o ponto de extremidade correto, consulte Hubs FinOps: Não é possível converter o valor nulo para o tipo Tabela para etapas adicionais de solução de problemas.


Hubs FinOps: não podemos converter o valor nulo para o tipo Tabela

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

Se você acabou de atualizar para o FinOps Hubs 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 você 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