Compartilhar via

Guia de solução de problemas do kit de ferramentas FinOps

Este artigo descreve como validar se as soluções do kit de ferramentas FinOps foram implantadas e configuradas corretamente. Se você tiver um código de erro específico, examine os erros comuns para obter detalhes e etapas de mitigação. Se você precisar de um passo a passo mais completo para validar sua configuração, use as etapas a seguir que se aplicam a você.


Você tem um código de erro específico?

Se você tiver um código de erro específico, recomendamos começar com erros comuns para obter uma explicação direta do problema que está enfrentando. Também há informações sobre como mitigar ou contornar o problema.


Validar a implantação do hub FinOps

Use as seguintes etapas para validar a implantação do hub FinOps:

Etapa 1: Verificar as exportações de Gerenciamento de Custos

  1. Vá para Exportações do Gerenciamento de Custos e verifique se o status da exportação é Successful.
  2. Se não for bem-sucedido, verifique se você tem o provedor de recursos de Gerenciamento de Custos registrado para a assinatura em que o hub está implantado.
  3. Registre uma solicitação de suporte com a equipe de Gerenciamento de Custos para investigar mais a fundo.

Etapa 2: Verificar pipelines do Data Factory

  1. No Data Factory Studio, selecione Monitor no menu esquerdo e confirme se os pipelines estão sendo executados com êxito.
  2. Se os pipelines estiverem falhando, examine o código de erro e a mensagem e verifique os erros comuns para etapas de mitigação.
  3. Compare o último tempo de execução com o tempo da última exportação. Eles devem estar próximos.
  4. Selecione Gerenciar>Autor>Gatilhos e verifique se o msexports_ManifestAdded gatilho está iniciado. Se não, inicie-o.
  5. Se o gatilho falhar ao iniciar com um erro "o 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 Registrar. O registro pode levar alguns minutos.
  6. Após a conclusão do registro, inicie o msexports_ManifestAdded gatilho novamente.
  7. Depois que o gatilho for iniciado, execute novamente todas as exportações de Gerenciamento de Custos conectadas. Os dados devem ser totalmente ingeridos dentro de 10 a 20 minutos.
  8. Se o pipeline de ingestão não estiver em execução e estiver mostrando uma MappingColumnNameNotFoundInSourceFile mensagem de erro, verifique se a exportação está configurada para um conjunto de dados e uma versão com suporte.

Etapa 3: Verificar a conta de armazenamento – contêiner msexports

  1. O contêiner msexports é para onde o Gerenciamento de Custos envia exportações "brutas".
  2. Verifique se não há arquivos CSV ou parquet no caminho de exportação mais recente.
  3. Se houver arquivos CSV ou parquet das exportações de Gerenciamento de Custos, abra o Data Factory Studio e confirme se os pipelines msexports_ExecuteETL e msexports_ETL_ingestion foram concluídos com sucesso.
    • Os arquivos exportados são removidos quando a ingestão é concluída, a menos que o contêiner msexports esteja configurado para ter uma política de retenção positiva.

Etapa 4: Verificar a conta de armazenamento – contêiner de ingestão

  1. O contêiner de ingestão é onde os clientes, como o Power BI, se conectam aos dados de pull. Esse contêiner deve sempre ter um ou mais arquivos parquet para cada mês.
  2. Se você não encontrar nenhum arquivo parquet no contêiner de ingestão, verifique se há arquivos no contêiner msexports.
  3. Se você encontrar arquivos CSV ou parquet no contêiner msexports , isso significa que o pipeline do Data Factory não está funcionando. Consulte novamente para Verificar pipelines do Data Factory.
  4. Se não houver arquivos no contêiner msexports e nenhum arquivo parquet dentro do contêiner de ingestão, isso significa que a exportação de Gerenciamento de Custos não está sendo executada corretamente. Consulte as exportações do Gerenciamento de Custos.

Validar sua configuração do Power BI

Use as seguintes etapas para validar sua configuração do Power BI:

Etapa 1: identificar sua URL de armazenamento

Antes de começar a validar sua configuração do Power BI, você precisa saber se está se conectando aos seus dados usando um dos seguintes mecanismos:

  • Conector de Gerenciamento de Custos para Power BI – Ideal para pequenas contas com necessidades limitadas. Não recomendado se estiver relatando mais de US$ 2 milhões em custos totais.
  • Exportações do Gerenciamento de Custos no armazenamento – Requer a exportação de dados do Gerenciamento de Custos para uma conta de armazenamento. Não requer outras implantações.
  • Hubs FinOps – Requer a implantação da solução de hub FinOps.

Se você precisar de ajuda para escolher a melhor abordagem para suas necessidades, consulte Escolhendo uma fonte de dados do Power BI.

Se estiver usando o conector de Gerenciamento de Custos, consulte Criar visuais e relatórios com o conector de Gerenciamento de Custos no Power BI Desktop.

Se estiver usando hubs FinOps, você poderá copiar a URL das saídas de implantação no portal do Azure:

  1. Navegue até o grupo de recursos em que os hubs FinOps foram implantados.
  2. Selecione Configurações>Implantações no menu.
  3. Selecione a implantação do hub .
  4. Selecione Saídas no menu.
  5. Copie o valor storageUrlForPowerBI .
  6. Cole essa URL na URL de armazenamento do Hub no Power BI.
  7. Se estiver usando exportações brutas para quaisquer dados, use também as etapas a seguir.
  8. Se não estiver usando exportações brutas para dados, cole a URL de armazenamento do hub na URL de armazenamento de exportação no Power BI.

    Observação

    O Power BI exige que ambos os parâmetros sejam definidos para que o serviço do Power BI atualize os conjuntos de dados.

Se estiver usando exportações brutas sem hubs FinOps para conjuntos de dados (mesmo se você estiver usando hubs para dados de custo), poderá obter o URI do Data Lake Storage de sua conta de armazenamento no portal do Azure:

  1. Navegue até a conta de armazenamento no portal do Azure.
  2. Selecione Configurações>Endpoints no menu.
  3. Copie a URL do Data Lake Storage>Data Lake Storage.
  4. Cole essa URL na URL de armazenamento de exportação no Power BI.
  5. Se estiver usando hubs FinOps para quaisquer dados, siga também as etapas anteriores.
  6. Se não estiver usando hubs FinOps para dados, cole a URL de armazenamento de exportação na URL de armazenamento do hub no Power BI.

    Observação

    O Power BI exige que ambos os parâmetros sejam definidos para que o serviço do Power BI atualize os conjuntos de dados.

Etapa 2: Conectar o Power BI ao armazenamento

Decida se deseja se conectar ao armazenamento usando uma conta de usuário ou entidade de serviço ou usando uma chave de conta de armazenamento (também chamada de token SAS).

  • Usando uma conta de usuário ou entidade de serviço
    1. Verifique se você tem a função Leitor de Dados do Blob de Armazenamento explicitamente para a conta a ser usada. Essa permissão não é herdada mesmo se você tiver permissões de "Proprietário" ou "Colaborador".
  • Usando um token SAS
    1. Certifique-se de definir as seguintes permissões para o token:
      • Serviços permitidos: Blob
      • Tipos de recursos permitidos: Contêiner e Objeto
      • Permissões permitidas: Ler e Listar
    2. Certifique-se de ter definido também uma data/hora válida de início e expiração.

Etapa 3: solucionar problemas de erros de conexão

  1. Se você tentar se conectar à sua conta de armazenamento e receber o Access to the resource is forbidden erro, é provável que esteja faltando algumas permissões. Para garantir que você tenha as permissões corretas, consulte Conectar o Power BI ao armazenamento.
  2. Se você vir um erro sobre o acesso ser proibido, verifique se a conta de faturamento à qual você está se conectando está correta. Os relatórios do Power BI são fornecidos com uma conta de cobrança de exemplo e, se você não alterar isso para sua própria ID, não poderá se conectar.

Etapa 4: solucionar problemas de meses de dados ausentes

  1. Se o relatório do Power BI não incluir meses inteiros de dados, confirme os parâmetros de data no relatório do Power BI marcando Transformar parâmetros de edição de dados>na faixa de opções. Consulte Configurar seu primeiro relatório para obter detalhes.
    • Número de meses define quantos meses fechados (antes do mês atual) são mostrados nos relatórios. Mesmo que os dados sejam exportados, os dados fora desse intervalo não serão mostrados. Se definido, esse parâmetro substitui outros.
    • RangeStart e RangeEnd definem um intervalo de dados de data explícito a ser mostrado nos relatórios. Qualquer coisa antes ou depois dessas datas não é mostrada.
    • Se RangeStart estiver vazio, todos os dados históricos antes de RangeEnd serão incluídos.
    • Se RangeEnd estiver vazio, todos os novos dados após RangeStart serão incluídos.
    • Se todos os parâmetros de data estiverem vazios, todos os dados disponíveis serão incluídos.

Depurar falhas em consultas do Power BI

Se o Power BI retornar um erro desconhecido, use as etapas a seguir para identificar o problema.

Identificar a consulta com falha

  1. Abra o relatório.
  2. Na faixa de opções, selecione Transformar dados>Transformar dados.
  3. Na janela do Editor do Power Query , localize a consulta que está falhando na lista de consultas à esquerda.
  4. Vá para a seção de solução de problemas com base na pasta.

Solucionar problemas de erros de consulta de armazenamento

  1. Na janela editor do Power Query , selecione a consulta que está falhando na lista de consultas à esquerda.
  2. Na seção Etapas Aplicadas à direita, selecione a etapa RawData .
  3. Se essa etapa apresentar erros, pule para solucionar problemas de erros ftk_Storage.
  4. Se essa etapa funcionar, selecione a próxima etapa abaixo dela, ignorando qualquer coisa que comece com um sublinhado ou minúscula.
  5. Repita a etapa 4 até encontrar a primeira etapa com erros.
  6. Compartilhe o nome da primeira etapa que está falhando em qualquer problema ou solicitação de suporte para ajudar a solucionar mais problemas.

Solucionar erros de ftk_Storage

  1. Na janela do Editor do Power Query , clique com o botão direito do mouse na função ftk_Storage à esquerda e selecione Duplicar.
  2. Clique com o botão direito do mouse ftk_Storage (2) e selecione Editor Avançado.
  3. Remova a primeira linha e substitua a data = if datasetType... linha por data = "focuscost",.
  4. Selecione Concluído na parte inferior direita da caixa de diálogo.
  5. Selecione ftk_Storage (2) à esquerda e clique em Atualizar Visualização na faixa de opções na parte superior.
  6. Nas Etapas Aplicadas à direita, selecione a última etapa.
  7. Se essa etapa ocorrer erros, selecione aquele antes dele (ignore qualquer coisa com um sublinhado ou um primeiro caractere minúsculo).
  8. Repita 7 até encontrar um que funcione.
  9. Compartilhe o nome da primeira etapa que está falhando em qualquer problema ou solicitação de suporte para ajudar a solucionar mais problemas.

Solucionar problemas de erros de consulta do Hub* e do Armazenamento*

  1. Na janela do Editor do Power Query , selecione a consulta com falha à esquerda e clique em Atualizar Visualização na faixa de opções na parte superior.
  2. Nas Etapas Aplicadas à direita, selecione a última etapa.
  3. Se essa etapa ocorrer erros, selecione aquele antes dele (ignore qualquer coisa com um sublinhado ou um primeiro caractere minúsculo).
  4. Repita 3 até encontrar um que funcione.
  5. Compartilhe o nome da primeira etapa que está falhando em qualquer problema ou solicitação de suporte para ajudar a solucionar mais 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

Soluções relacionadas:

  • Last updated on