Condividi tramite

Risolvere gli errori comuni del toolkit FinOps

Questo articolo descrive gli errori comuni del toolkit FinOps e fornisce informazioni sulle soluzioni. Se visualizzi un errore utilizzando le soluzioni di FinOps Toolkit che non comprendi o non riesci a risolvere, trova il seguente codice di errore corrispondente con i passi di mitigazione per risolvere il problema.

Ecco un elenco di codici errore comuni con informazioni sulla mitigazione.

Se le informazioni fornite non risolvono il problema, provare la guida alla risoluzione dei problemi.


L'accesso alla risorsa non è consentito

Gravità: Critica

Questo errore indica in genere che l'account a cui si è connessi non ha accesso alla risorsa che si sta tentando di usare.

Mitigazione: conferma di utilizzare l'ID Entra di Microsoft con l'account e il tenant corretti.


La proprietà dell'account non può essere aggiornata

Gravità: Critica

Questo errore si verifica in genere durante l'aggiornamento di una distribuzione dell'hub FinOps con una configurazione dell'account di archiviazione diversa rispetto a quella usata in origine durante la creazione. Anche se la maggior parte delle proprietà può essere modificata, esistono alcune proprietà che possono essere impostate una sola volta quando viene creato l'account di archiviazione e non possono cambiare. Un caso noto di questo per gli hub FinOps è la proprietà "requireInfrastructureEncryption". Se questa proprietà è stata abilitata o disabilitata durante la prima distribuzione dell'hub FinOps, non può essere modificata. Quando si verifica questo errore, verrà visualizzato l'errore seguente:

La proprietà 'requireInfrastructureEncryption' è stata specificata nell'input, ma non può essere aggiornata perché è di sola lettura.

Mitigazione: se non si intende modificare questa impostazione, verificare se l'account di archiviazione è configurato per usare la crittografia dell'infrastruttura e distribuire nuovamente il modello dell'hub FinOps con lo stesso valore (attivato o disattivato). Se si vuole modificare l'impostazione, è consigliabile distribuire una nuova istanza dell'hub FinOps, in quanto ciò richiederà il ripristino di tutti i dati.

È possibile provare a eliminare l'account di archiviazione esistente e ridistribuire il modello con la crittografia dell'infrastruttura modificata; tuttavia, questo non è stato testato accuratamente. Anche se non prevediamo problemi, non possiamo confermare se causerà problemi.


BadHubVersion

Gravità: Critica

Gli hub FinOps 0.2 non sono operativi. Eseguire l'aggiornamento alla versione 0.3 o successiva.

Mitigazione: eseguire l'aggiornamento alla versione più recente degli hub FinOps.


La colonna 'id' nella tabella 'Resources' contiene un valore duplicato

Gravità: Critica

Se si verifica l'errore seguente, significa che Azure Resource Graph restituisce righe con lo stesso valore logico per la colonna ID . Ciò può verificarsi quando i valori ID risorsa hanno incoerenza nell'uso delle maiuscole e minuscole o quando un'altra colonna viene espansa tra righe.

La colonna 'id' nella tabella 'Resources' contiene un valore duplicato '{resource-id}' e non è consentito per le colonne su un lato di una relazione molti-a-uno o per le colonne utilizzate come chiave primaria di una tabella.

Mitigazione: assicurarsi di essere sulla versione più recente del report. Identificare la causa dei valori duplicati e aggiornare la query per aggirare i valori duplicati. Segnalare anche questo problema in GitHub in modo che possa essere risolto in una versione futura. Ciò potrebbe richiedere dettagli aggiuntivi o una riunione per risolvere la causa dell'errore.


Errore di Conflitto

Gravità: Critica

Potrebbero essere presenti più istanze di questo errore. L'istanza nota è quando Key Vault restituisce l'errore seguente:

Una cassaforte con lo stesso nome esiste già in stato eliminato. È necessario ripristinare o eliminare il key vault esistente. Per ulteriori informazioni sull'eliminazione leggera, segui questo collegamento https://go.microsoft.com/fwlink/?linkid=2149745.

Ciò significa generalmente che stai distribuendo sopra una vecchia distribuzione eliminata, ma Key Vault ha mantenuto la vecchia istanza dell'insieme di credenziali in uno stato di eliminazione recuperabile.

Mitigazione: per risolvere questo problema, rimuovere definitivamente il Key Vault eliminato nel portale di Azure.

  1. Aprire l'elenco delle istanze di Key Vault nel portale di Azure.
  2. Selezionare il comando Gestisci casseforti eliminate nella parte superiore della pagina.
  3. Selezionare la sottoscrizione nell'elenco a discesa.
  4. Controllare le casseforti da rimuovere.
  5. Selezionare Ripulisci nella parte inferiore del menu a tendina.
  6. Selezionare Elimina nella finestra di dialogo di conferma.

È ora possibile ritentare la distribuzione.


CostoContrattualeMinoreDiCostoEffettivo

Gravità: Avviso

ContractedCost (in base agli sconti negoziati) è minore di EffectiveCost (dopo gli sconti di impegno) nei dati di Gestione costi. Questo non dovrebbe mai accadere a meno che lo sconto dell'impegno non fornisca uno sconto inferiore rispetto agli sconti negoziati esistenti. In questo modo i calcoli di risparmio non verranno sommati esattamente.

Mitigazione: verificare che ContractedUnitPrice nei dati sui costi corrisponda a ciò che si trova nei dati sui prezzi. Se il prezzo contratto è corretto, inviare una richiesta di supporto con il team di Gestione costi per confermare x_EffectiveUnitPrice e EffectiveCost sono corretti. Se sono corretti, valutare la possibilità di restituire lo sconto sull'impegno.


Le regole di accesso tra tenant non consentono a questo utente

Gravità: principale

Se si verifica l'errore seguente, significa che Microsoft Entra ID è configurato per non consentire agli utenti di altri tenant di accedere al tenant corrente.

Messaggio: AADSTS500213: i criteri di accesso tra tenant delle risorse non consentono all'utente di accedere a questo tenant.

Questo messaggio di errore non è correlato al toolkit FinOps.

Mitigazione: Verificare di essere connessi all'account corretto e di aver effettuato l'accesso tramite la directory di destinazione. Se è necessaria ulteriore assistenza, contattare l'amministratore della directory.


Errore nell'ingestione dei dati in Data Explorer

Gravità: Critica

L'ingestione dei dati in Esplora è fallita. I nuovi dati non saranno disponibili per la creazione di report.

Mitigazione: esaminare il messaggio di errore di Esplora dati e risolvere il problema. Eseguire di nuovo l'inserimento dati per la cartella specificata usando la pipeline di ingestion_ExecuteETL in Azure Data Factory. Segnalare problemi non risolti in https://aka.ms/ftk/ideas.


Data Explorer: Mapping di Ingestione Fallito

Gravità: Critica

Impossibile creare il mapping di inserimento per la tabella specificata in Data Explorer.

Mitigazione: correggere l'errore ed eseguire di nuovo l'inserimento per il percorso della cartella specificato. Se si continua a visualizzare questo errore, segnalare un problema all'indirizzo https://aka.ms/ftk/ideas.


DataExplorerIngestionTimeout

Gravità: Critica

Timeout dell'ingestione di Data Explorer dopo 2 ore in attesa di capacità disponibile.

Mitigazione: eseguire di nuovo questa pipeline per tentare nuovamente l'inserimento. Se si continua a visualizzare questo errore, segnalare un problema all'indirizzo https://aka.ms/ftk/ideas.


Errore eliminazione post-ingestione in Data Explorer

Gravità: Critica

Pulizia post-inserimento di Data Explorer (eliminazione sezioni dalla tabella finale) non riuscita. I dati di un inserimento precedente possono essere presenti nei report, che potrebbero comportare costi duplicati e imprecisi.

Mitigazione: esaminare il messaggio di errore di Esplora dati e risolvere il problema. Eseguire di nuovo l'inserimento dei dati per la cartella specificata usando la ingestion_ExecuteETL pipeline in Azure Data Factory. Segnalare problemi non risolti in https://aka.ms/ftk/ideas.


DataExplorerPreIngestionDropFailed

Gravità: Critica

Pulizia pre-inserimento di Esplora dati (eliminazione extent dalla tabella non elaborata) non riuscita. L'inserimento non è stato completato.

Mitigazione: esaminare il messaggio di errore di Esplora dati e risolvere il problema. Eseguire di nuovo l'inserimento dei dati per la cartella specificata usando la ingestion_ExecuteETL pipeline in Azure Data Factory. Segnalare problemi non risolti in https://aka.ms/ftk/ideas.


ValutazioneOutputDistribuzioneFallita

Gravità: principale

Gli hub FinOps 0.8 impostano l'impostazione di sicurezza "trustedExternaltenants" di Esplora dati di Azure per bloccare il cluster in modo che possa essere accessibile solo da tenant specifici e attendibili. Questa impostazione può essere impostata per la prima distribuzione, ma non può essere impostata di nuovo in una seconda distribuzione. Se si tenta di ridistribuire hub FinOps 0.8 sopra una distribuzione esistente 0.8, è possibile che venga visualizzato l'errore seguente:

L'output del modello 'clusterUri' non è valido: la proprietà 'uri' nel linguaggio non esiste, le proprietà disponibili sono 'trustedExternalTenants, enableStreamingIngest, publicNetworkAccess, enableAutoStop, provisioningState'.

Stiamo seguendo con il team di Esplora dati di Azure per determinare la risoluzione corretta.

Mitigazione: Distribuire gli hub FinOps 0.9. Questa impostazione è stata rimossa dal modello.


DatiEsportazioneNonTrovati

Gravità: Critica

Le esportazioni non sono state trovate nel percorso di archiviazione specificato.

Mitigazione: verificare che un'esportazione di Gestione costi sia stata creata e configurata con l'account di archiviazione, il contenitore e il percorso di archiviazione corretti. Dopo la creazione, selezionare "Esegui adesso" per avviare il processo di esportazione. Il completamento delle esportazioni può richiedere 15-30 minuti a seconda delle dimensioni dell'account. Se intendi usare gli hub FinOps, correggi l'URL di archiviazione in modo che punti al contenitore "acquisizione". Fare riferimento all'output storageUrlForPowerBI della distribuzione dell'hub FinOps per l'URL completo.


TipoDiEsportazioneNonDefinito

Gravità: Critica

Questo tipo di ambito di fatturazione non è supportato dalle esportazioni gestite.

Mitigazione: rimuovere l'ambito di fatturazione non supportato da settings.json, verificare che l'ambito di fatturazione sia supportato dagli hub FinOps e creare manualmente nuove esportazioni di Gestione costi per l'ambito di fatturazione.


TipoDiEsportazioneNonSupportato

Gravità: Critica

I contratti del cliente Microsoft non sono supportati per le esportazioni gestite.

Mitigazione: Rimuovere l'ambito di fatturazione del Contratto del Cliente Microsoft da settings.json e creare manualmente nuove esportazioni di Gestione Costi per ogni profilo di fatturazione MCA per il costo FOCUS, la scheda prezzi, i dettagli della prenotazione, le transazioni di prenotazione e le raccomandazioni per le prenotazioni.


HubDataNotFound

Gravità: Critica

I dati dell'hub FinOps non sono stati trovati nell'account di archiviazione specificato.

Mitigazione: questo errore presuppone che ci si connetta a una distribuzione dell'hub FinOps. Se si usano esportazioni non elaborate, correggere il percorso di archiviazione per non fare riferimento al ingestion contenitore. Verificare quanto segue:

  1. L'URL di archiviazione deve corrispondere all'output StorageUrlForPowerBI nella distribuzione dell'hub FinOps.
  2. Le esportazioni di Gestione costi devono essere configurate per puntare allo stesso account di archiviazione usando il contenitore msexports.
  3. Le esportazioni di Gestione dei costi devono mostrare un'esportazione riuscita nella cronologia di esecuzione.
  4. I trigger della data factory dell'hub FinOps devono essere tutti avviati.
  5. Le pipeline della data factory dell'hub FinOps dovrebbero avere esito positivo.

Per altri dettagli e passaggi di debug, vedere Convalidare la distribuzione dell'hub FinOps.


FileDiIngestioneNonTrovati

Gravità: Critica

Impossibile individuare i file parquet da inserire dal percorso della cartella specificato.

Mitigazione: verificare che il percorso della cartella sia il percorso completo, incluso il contenitore di inserimento e non iniziare con o terminare con una barra (/). Copiare il percorso dall'ultima esecuzione riuscita della pipeline ingestion_ExecuteETL.


ErroreDiServizioInterno

Microsoft Fabric Real-Time Intelligence può restituire un codice di errore "InternalServiceError (520-UnknownError)" durante l'inserimento di dati. Il messaggio di errore dettagliato può indicare:

Il client Kusto non è riuscito a inviare una richiesta al servizio: "Impossibile leggere i dati dalla connessione di trasporto: una connessione esistente è stata chiusa forzatamente dall'host remoto". `

Il motivo esatto per questo errore è sconosciuto. In caso affermativo, inviare una richiesta di supporto con Microsoft Fabric per ulteriori indagini.

Mitigazione: come soluzione alternativa, modificare il consumo minimo per la eventhouse di Fabric impostando Intermedio (18 CU), attendere 30 minuti ed eseguire nuovamente la pipeline ingestion_ExecuteETL per il set di dati e il mese. Per altre informazioni sul consumo minimo, vedere Consumo minimo nell'overview della sede eventi.


CostoEffettivoNonValido

Gravità: principale

A partire da novembre 2024, Gestione costi ha un bug noto in cui gli acquisti del piano di risparmio vengono monitorati internamente come costi effettivi e ammortizzati. Per questo motivo, FOCUS include acquisti di piani di risparmio nel calcolo per EffectiveCost, che porta a numeri imprecisi nei report di FinOps Toolkit.

Mitigazione: inviare una richiesta di supporto al team di Gestione costi Microsoft con informazioni dettagliate sul problema per risolvere i dati sottostanti. A partire da novembre 2024, il team è a conoscenza del problema, ma la correzione non è ancora stata prioritaria. Nel frattempo, eseguire l'aggiornamento a FinOps Toolkit 0.7, che include una soluzione alternativa per gli hub FinOps e i report di Power BI basati sull'archiviazione.


ContenitoreEsportazioneNonValido

Gravità: Critica

Questo file potrebbe essere esportato da Gestione costi, ma non è nel contenitore corretto.

Mitigazione: aggiornare l'esportazione di Gestione costi in modo che punti al contenitore di archiviazione "msexports". Il contenitore "inserimento" viene usato solo per l'esecuzione di query sui dati dei costi inseriti.


VersioneDiEsportazioneNonValida

Gravità: Critica

Gli hub FinOps richiedono esportazioni dei costi tramite FOCUS, ma questo file sembra un'esportazione legacy di gestione dei costi.

Mitigazione: Creare una nuova esportazione di Gestione costi per il costo FOCUS e interrompere l'esportazione attuale o modificarla per esportare in un contenitore di archiviazione diverso.


VersioneHubNonValida

Gravità: Critica

Gli hub FinOps 0.1.1 e versioni precedenti non funzionano con il report Di inserimento dati di Power BI.

Mitigazione: eseguire l'aggiornamento alla versione più recente degli hub FinOps o scaricare i report di Power BI dalla versione 0.1.1.


InvalidScopeId

Gravità: informativa

Il percorso di esportazione non è un ID di ambito valido. Gli hub FinOps prevedono che il percorso di esportazione sia un ID risorsa di Azure per l'ambito per cui l'esportazione è stata creata, per semplificare la gestione. Non dovrebbe causare errori, ma potrebbe causare confusione nei risultati per i report correlati all'ambito.

Mitigazione: aggiornare il percorso di archiviazione per l'esportazione di Cost Management utilizzando l'ID completo della risorsa Azure per lo scope.


LegacyFocusVersion

Gravità: informativa

Questo codice di errore viene visualizzato quando i dati inseriti usano una versione precedente di FOCUS. Quando viene trovato nella x_SourceChanges colonna, il codice è solo informativo. Quando viene visualizzato nei report di archiviazione di Power BI che la query Costi non viene caricata, significa che il parametro Deprecato: Esegui ottimizzazioni aggiuntive della query è disabilitato.

Gli hub FinOps converte i dati nella versione più recente di FOCUS, quindi questo non dovrebbe causare un problema; Tuttavia, la trasformazione di modernizzazione non può tenere conto di tutti gli scenari e può causare risultati imprevisti in alcuni casi. Per informazioni sui problemi noti, vedere la documentazione.

Mitigazione: esistono diversi modi per attenuare questo messaggio, a seconda dello strumento in uso.

Se si usano hub FinOps con Esplora dati e questo viene visualizzato nella colonna x_SourceChanges della tabella Costi o delle funzioni correlate, aggiornare le esportazioni dei costi di Gestione costi per usare la versione più recente di FOCUS. Non è necessario apportare modifiche aggiuntive; tutti i dati saranno uniti durante l'ingestione in Esplora dati.

Se si utilizzano i report di archiviazione e questo venga visualizzato nella colonna della query Costi x_SourceChanges, questo messaggio è un avviso che questa versione di FOCUS verrà rimossa in un aggiornamento futuro. Anche se è possibile ignorare questo messaggio in modo sicuro, sarà necessario un aggiornamento in una versione futura. Per evitare il messaggio, aggiornare le esportazioni di Gestione costi nella versione più recente di FOCUS, eliminare o spostare i dati meno recenti usando una versione precedente di FOCUS ed esportare nuovamente i dati cronologici. Se si usano hub FinOps, eliminare o spostare dati all'esterno del contenitore di inserimento . Se si ospitano esportazioni personalizzate nell'archiviazione, modificare il parametro URL di archiviazione in un percorso di cartella diverso che non include le versioni precedenti di FOCUS.

A partire da FinOps Toolkit 0.7, il supporto per le versioni precedenti di FOCUS è stato deprecato per migliorare le prestazioni e la scalabilità. È consigliabile eseguire l'aggiornamento alla versione più recente di FOCUS ed esportare i dati per migliorare l'esperienza. Imposta il parametro Deprecato: eseguire ottimizzazioni aggiuntive delle query su TRUE per garantire il supporto delle versioni precedenti di FOCUS e impostalo su FALSE per accelerare le prestazioni e supportare set di dati più grandi che coprono più costi o tempi. A partire dalla versione 0.7, questo parametro è abilitato per impostazione predefinita per la compatibilità con le versioni precedenti. In FinOps toolkit 0.8 verrà disabilitato per impostazione predefinita, ma sarà comunque disponibile per la compatibilità con le versioni precedenti fino a giugno 2025. Se non è possibile disattivare le versioni precedenti di FOCUS o per ottenere prestazioni ottimali e supporto per account più grandi o periodi di tempo più lunghi, è consigliabile usare hub FinOps con Esplora dati.


Costo di Listino Inferiore al Costo Contrattuale

Gravità: Avviso

ListCost (in base ai prezzi pubblici al dettaglio) è minore di ContractedCost (in base agli sconti negoziati) nei dati di Gestione costi. Questo non dovrebbe mai accadere. In questo modo i calcoli di risparmio non verranno sommati esattamente.

Mitigazione: verificare che ListUnitPrice nei dati sui costi corrisponda a ciò che si trova nei dati sui prezzi. Se il prezzo di listino è corretto, inviare una richiesta di supporto al team di Gestione costi per confermare sia ListUnitPrice che ContractedUnitPrice siano corretti e spiegare perché il prezzo dopo gli sconti negoziati sarebbe superiore alle tariffe pubbliche e al dettaglio.


ManifestReadFailed

Gravità: Critica

L'hub FinOps msexports_ExecuteETL pipeline non è riuscita a leggere il file manifesto di Gestione costi.

Prevenzione:

  1. Se l'errore si è verificato in un'istanza dell'hub di lavoro quando non sono state apportate modifiche all'hub o all'esportazione, Gestione costi potrebbe modificare lo schema del manifesto per una versione API esistente.
  2. Se l'errore si è verificato dopo aver creato un'esportazione nuova o modificata esistente, la versione dell'API di esportazione potrebbe usare un nuovo schema manifesto non supportato.
  3. Se l'errore si è verificato dopo una distribuzione dell'hub (installazione iniziale o aggiornamento), la distribuzione potrebbe non riuscire o potrebbe verificarsi un bug nella pipeline.

Per confermare lo schema del manifesto (#1) o la versione dell'API (#2):

  1. Aprire l'account di archiviazione hub nel portale di Azure o in Storage Explorer.
  2. Se ti trovi nel portale di Azure, vai a Storage Browser nel menu.
  3. Selezionare il contenitore msexports .
  4. Scorri verso il basso nella gerarchia dei file per l'esportazione con il problema (vedi la posizione del manifesto nel messaggio di errore).
  5. Trovare il file manifest.json e selezionare il menu (⋯), quindi selezionare Visualizza/modifica.
  6. Identificare le proprietà seguenti: 
    {
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}
  7. Verificare che siano impostati sui valori supportati seguenti:
    • resourceId può essere qualsiasi ID ambito e qualsiasi nome di esportazione, ma deve esistere con il tipo di risorsa "Microsoft.CostManagement/export". Nessuna distinzione tra maiuscole e minuscole.
    • il tipo deve esistere, ma non dovrebbe generare questo errore per qualsiasi valore non null.
    • dataVersion deve esistere, ma non dovrebbe causare un errore di questo tipo per qualsiasi valore non nullo.
    • apiVersion non viene usato in modo esplicito, ma può indicare le modifiche allo schema del manifesto. Per informazioni dettagliate, vedere Versioni API supportate.
  8. Se si usa una versione più recente dell'API:
    1. Per tenere traccia dell'aggiunta del supporto per la nuova versione dell'API, creare un problema di richiesta di modifica in GitHub.
    2. Eliminare l'esportazione in Gestione costi.
    3. Creare un'esportazione usando il comando PowerShell New-FinOpsCostExport usando una versione api supportata.

      Suggerimento

      Se si considera un utente di power user, è possibile provare ad aggiornare manualmente la pipeline per la risoluzione più rapida. A tale scopo, aprire Data Factory, passare a Author > Pipelines > msexports_ExecuteETL e selezionare le attività "Set" applicabili e aggiornare la proprietà Settings>Value in base alle esigenze. In questo caso, non è necessario ricreare l'esportazione con una versione precedente. Segnalare comunque il problema e prendere in considerazione la condivisione del nuovo codice JSON dall'icona {} in alto a destra della pipeline designer._

  9. Se si nota che le proprietà sono state modificate per una versione dell'API supportata:
    1. Per tenere traccia della modifica che causa un'interruzione, creare un problema di richiesta di modifica in GitHub. Includere il tipo, dataVersion e apiVersion dal file manifest.json.
    2. Inviare una richiesta di supporto con Gestione costi per richiedere il ripristino della modifica perché interrompe tutti gli utenti che usano hub FinOps o altre soluzioni personalizzate. Includere i dettagli seguenti per aiutare il team di supporto di Gestione costi a identificare il problema all'interno del sistema. Gestione costi non ha un contesto sugli hub FinOps, quindi è consigliabile mantenere i dettagli incentrati sulla funzionalità Gestione costi. Di seguito è riportato un esempio:

      Sto usando le esportazioni di Gestione costi per trasferire i dati dei costi in ADLS. Ho una pipeline di ADF che elabora i dati quando vengono scritti i file manifesti. La mia pipeline è stata costruita sulla versione <your-supported-api-version> dell'API che prevede le proprietà exportConfig.resourceId, exportConfig.type, e exportConfig.dataVersion vengano distribuite in modo coerente. Si è notato che questi file non sono inclusi nel file manifesto per questa versione dell'API per l'esportazione eseguita in <your-export-date>. L'aspettativa è che il file manifesto non debba mai cambiare per una versione API esistente. È possibile ripristinare queste modifiche?

      Per risolvere i problemi, ecco il file manifesto: {your-manifest-json}

Se le proprietà del manifesto sono valide e si tratta di un'istanza dell'hub FinOps nuova o aggiornata, verificare la distribuzione:

  1. Aprire il gruppo di risorse hub nel portale di Azure.
  2. Selezionare Impostazioni>Distribuzioni nel menu a sinistra.
  3. Verificare che tutte le distribuzioni siano riuscite. In particolare, cercare i nomi di distribuzione seguenti:
    • principale
    • nodo
    • Risorse della Fabbrica Dati
    • immagazzinamento
    • KeyVault
  4. Se le distribuzioni non sono riuscite, esaminare il messaggio di errore per determinare se si tratta di un elemento che è possibile risolvere manualmente(ad esempio, conflitto di nomi, violazione dei criteri risolvibile).
  5. Se l'errore sembra temporaneo, riprova a distribuire.
  6. Se l'errore persiste, creare una discussione per verificare se un altro utente riscontra un problema o conosce una possibile soluzione alternativa (in particolare per i problemi relativi ai criteri).
  7. Se l'errore è chiaramente un bug o un gap di funzionalità, creare un problema di bug o richiesta di funzionalità in GitHub.

Cerchiamo di rispondere a problemi e discussioni entro due giorni lavorativi.


CostoContrattualeMancante

Gravità: informativa

Questo codice di errore viene visualizzato nella x_SourceChanges colonna quando ContractedCost è null o 0 ed EffectiveCost è maggiore di 0. L'errore indica che Gestione costi Microsoft non include ContractedCost per le righe specificate, il che significa che non è possibile calcolare i risparmi.

Mitigazione: come soluzione alternativa ai dati mancanti, Il toolkit FinOps copia nella EffectiveCostContractedCost colonna per le righe contrassegnate con questo codice di errore. I risparmi non sono disponibili per queste registrazioni.

Per calcolare il risparmio completo, è possibile unire i dati sui costi e sull'utilizzo con i prezzi. Per altre informazioni, vedere il problema 873.


PrezzoUnitarioContrattualeMancante

Gravità: informativa

Questo codice di errore viene visualizzato nella x_SourceChanges colonna quando ContractedUnitPrice è null o 0 ed EffectiveUnitPrice è maggiore di 0. L'errore indica che Gestione costi Microsoft non include ContractedUnitPrice per le righe specificate, il che significa che non è possibile calcolare i risparmi.

Mitigazione: come soluzione alternativa ai dati mancanti, Il toolkit FinOps copia nella EffectiveUnitPriceContractedUnitPrice colonna per le righe contrassegnate con questo codice di errore. I risparmi non sono disponibili per queste registrazioni.

Per calcolare il risparmio completo, è possibile unire i dati sui costi e sull'utilizzo con i prezzi. Per altre informazioni, vedere il problema 873.


MissingListCost

Gravità: informativa

Questo codice di errore viene visualizzato nella x_SourceChanges colonna quando ListCost è null o 0 ed ContractedCost è maggiore di 0. L'errore indica che Gestione costi Microsoft non include ListCost per le righe specificate, il che significa che non è possibile calcolare i risparmi.

Mitigazione: come soluzione alternativa ai dati mancanti, Il toolkit FinOps copia nella ContractedCostListCost colonna per le righe contrassegnate con questo codice di errore. I risparmi non sono disponibili per queste registrazioni.

Per calcolare il risparmio completo, è possibile unire i dati sui costi e sull'utilizzo con i prezzi. Per altre informazioni, vedere il problema 873.


PrezzoUnitarioElencoMancante

Gravità: informativa

Questo codice di errore viene visualizzato nella x_SourceChanges colonna quando ListUnitPrice è null o 0 ed ContractedUnitPrice è maggiore di 0. L'errore indica che Gestione costi Microsoft non include ListUnitPrice per le righe specificate, il che significa che non è possibile calcolare i risparmi.

Mitigazione: come soluzione alternativa ai dati mancanti, Il toolkit FinOps copia nella ContractedUnitPriceListUnitPrice colonna per le righe contrassegnate con questo codice di errore. I risparmi non sono disponibili per queste registrazioni.

Per calcolare il risparmio completo, è possibile unire i dati sui costi e sull'utilizzo con i prezzi. Per altre informazioni, vedere il problema 873.


NomeDelFornitoreMancante

Gravità: informativa

Questo codice di errore viene visualizzato nella x_SourceChanges colonna quando ProviderName è Null. L'errore indica che il provider del set di dati (ad esempio, Gestione costi Microsoft) non include un ProviderName valore per le righe specificate.

Mitigazione: come soluzione alternativa ai dati mancanti, FinOps Toolkit segnala il tentativo di identificare il provider in base alle colonne disponibili.


Query '...' fa riferimento ad altre query o passaggi

Gravità: minore

L'origine di questo errore è sconosciuta. Questo errore può essere visualizzato in modo casuale durante l'aggiornamento dei dati di Power BI.

Mitigazione: se viene visualizzato questo errore, selezionare di nuovo Applica modifica .

Questo errore è stato segnalato solo nei report di archiviazione. Se si verificano tempi di aggiornamento dati lunghi o si verifica spesso questo errore, provare a passare agli hub FinOps con Esplora dati. Data Explorer utilizza rapporti KQL che non richiedono pianificazione o aggiornamenti incrementali. I dati vengono estratti all'apertura del report, quindi i report mostrano sempre i dati più recenti.


EccezioneAccessoRisorsaProibito

Gravità: principale

Power BI: è stata generata un'eccezione del tipo "Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException"

Indica che l'account che carica i dati in Power BI non ha il ruolo Lettore dati BLOB di archiviazione. Concedere questo ruolo all'account che carica i dati in Power BI.


Le dimensioni del payload della risposta sono... e hanno superato il limite

Gravità: principale

Le query di Azure Resource Graph nei report di Power BI governance e ottimizzazione del carico di lavoro possono restituire un errore simile al seguente:

Errore OLE DB o ODBC: [Expression.Error] Specificare le informazioni seguenti quando si richiede supporto: timestamp = {timestamp}, correlationId = {guid}. Dettagli: le dimensioni del payload della risposta sono {number}e hanno superato il limite di 16777216. Prendere in considerazione di interrogare meno dati alla volta e di effettuare una richiesta paginata, se necessario.

Questo errore indica che sono supportate più risorse rispetto a quelle supportate in una query Resource Graph non filtrata. Ciò si verifica perché i report di FinOps Toolkit sono progettati per visualizzare i dettagli a livello di risorsa e non sono aggregati. Sono progettati per ambienti di piccole e medie dimensioni e non progettati per supportare le organizzazioni con milioni di risorse.

Mitigazione: se si verifica questo errore, sono disponibili diverse opzioni:

  • Rimuovere le colonne non necessarie per le proprie esigenze.
  • Filtrare la query per restituire meno risorse in base a ciò che è più importante per l'utente (ad esempio, sottoscrizioni, tag).
  • Disabilitare la query in modo che non blocchi l'esecuzione di altre query.

AggiornamentoRuoloNonConsentito

Gravità: minore

Se sono stati eliminati hub FinOps e si sta tentando di ridistribuirlo con gli stessi valori, incluso il nome dell'identità gestita, è possibile che si verifichi il problema noto seguente:

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

Mitigazione: Per risolvere il problema, è necessario rimuovere l'identità obsoleta.

  • Passare all'account di archiviazione e selezionare Controllo di accesso (IAM) nel menu.
  • Selezionare la scheda Assegnazioni di ruolo.
  • Trovare eventuali assegnazioni di ruolo con un'identità "sconosciuta" ed eliminarle.

AssegnazioneRuoloEsistente

Gravità: minore

Quando si aggiornano hub FinOps da una versione a un'altra, è possibile che si verifichi l'errore seguente se le assegnazioni di ruolo create in una distribuzione precedente esistono ancora:

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

Ciò è probabile perché un'identità gestita è stata eliminata in modo esplicito senza prima rimuovere tutte le assegnazioni di ruolo.

Mitigazione: Per risolvere il problema, eliminate le assegnazioni di ruolo orfane nel portale di Azure.

  • Passare al gruppo di risorse o alla risorsa interessata, come il cluster dell'esploratore di dati.
  • Selezionare Controllo di accesso (IAM) nel menu.
  • Selezionare la scheda Assegnazioni di ruolo.
  • Trovare eventuali assegnazioni di ruolo con un'identità sconosciuta ed eliminarle.

SchemaLoadFailed

Gravità: Critica

L'hub FinOps msexports_ETL_ingestion pipeline non è riuscita a caricare il file di schema.

Mitigazione: esaminare il messaggio di errore per prendere nota del tipo e della versione del set di dati, formattati con un carattere di sottolineatura (ad esempio, <type>_<version> o FocusCost_1.0). Verificare che il set di dati e il tipo siano entrambi supportati dalla versione distribuita degli hub FinOps. Per informazioni dettagliate, vedere Set di dati supportati.


SchemaNotFound

Gravità: Critica

L'hub FinOps msexports_ExecuteETL pipeline non è riuscita a trovare il file di mapping dello schema per il set di dati esportato.

Mitigazione: verificare che il tipo e la versione del set di dati siano supportati. Per informazioni dettagliate, vedere Set di dati supportati. Se il set di dati è supportato, verificare la versione dell'hub con il report inserimento dati.

Per aggiungere il supporto per un altro set di dati, creare un file di mapping personalizzato e salvarlo in config/schemas/<dataset-type>_<dataset-version>.json. I <dataset-type><dataset-version> valori corrispondono molto a ciò che viene usato da Gestione costi. Per identificare il tipo di dati per ogni colonna, usare un file di schema esistente come modello. Alcuni set di dati hanno schemi diversi per EA e Contratto del cliente Microsoft (MCA). Non possono essere identificati tramite questi attributi e potrebbero causare un problema se si hanno entrambi i tipi di account. Stiamo lavorando per aggiungere set di dati e tenere conto delle differenze EA e MCA allineandole a FOCUS.


L'URL di archiviazione di importazione non corrisponde a nessuna esportazione

Gravità: principale

Se si verifica questo problema in FinOps Toolkit 0.8, l'errore è dovuto a un riferimento a un parametro che non esiste.

Mitigazione: questo problema è stato risolto in FinOps Toolkit 0.9. Eseguire l'aggiornamento alla versione più recente per applicare la correzione. Se è necessario applicare la correzione direttamente ai report 0.8, modificare la funzione ftk_DemoFilter nell'editor avanzato e modificare il contenuto in : () => "". Salvare, quindi chiudere e applicare tutte le modifiche.


FileEsportazioneSconosciuto

Gravità: informativa

Il file nell'archiviazione hub non sembra che sia stato esportato da Gestione Costi. Il file viene ignorato.

Mitigazione: Il contenitore msexports è destinato solo alle esportazioni di Gestione dei costi. Spostare altri file in un altro contenitore di archiviazione.


UnknownFocusVersion

Gravità: informativa

Questo codice di errore viene visualizzato nella x_SourceChanges colonna quando non è stato possibile identificare una versione focus.

Mitigazione: verificare che il set di dati FOCUS usi una versione focus supportata. Segnalare questo problema con un campione anonimo dei dati in https://aka.ms/ftk/ideas per approfondire l'analisi.


UnknownHubVersion

Gravità: Critica

Impossibile identificare la versione degli hub FinOps dal file di impostazioni. Verificare che le impostazioni siano corrette. Gli hub FinOps 0.1.1 e versioni precedenti non funzionano con questo report di Power BI.

Mitigazione: eseguire l'aggiornamento alla versione più recente degli hub FinOps o scaricare i report di Power BI dalla versione 0.1.1 del toolkit FinOps.


Tipo di file di esportazione non supportato

Gravità: Critica

Impossibile inserire il file di esportazione specificato perché il tipo di file non è supportato.

Mitigazione: convertire il file in un formato di file supportato prima di aggiungere al contenitore msexports o aggiungere il supporto per la conversione del nuovo tipo di file nella pipeline di msexports_ETL_ingestion .


TipoDiEsportazioneNonSupportato

Gravità: Avviso

Il manifesto di esportazione nell'archiviazione hub indica che l'esportazione è stata per un set di dati non supportato. I dati esportati vengono segnalati come errori di inserimento.

Mitigazione: Creare una nuova esportazione di Gestione costi per il costo FOCUS e interrompere l'esportazione attuale o modificarla per esportare in un contenitore di archiviazione diverso.


Il provider di risorse {name} non è registrato nella sottoscrizione {guid}

Gravità: minore

Aprire la sottoscrizione nel portale di Azure, quindi selezionare Impostazioni>Provider di risorse, selezionare la riga del provider di risorse ,ad esempio Microsoft.EventGrid, quindi selezionare il comando Registra nella parte superiore della pagina. La registrazione potrebbe richiedere alcuni minuti.


x_PricingSubcategory mostra l'ID dello sconto per impegno

Le esportazioni di Gestione Costi prima del 28 febbraio 2024 presentavano un bug per cui x_PricingSubcategory veniva impostato erroneamente per l'uso impegnato. Dovrebbero essere visualizzati valori come Committed Spend e Committed Usage. Al contrario, potrebbero essere visualizzati valori come:

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

Se vengono visualizzati questi valori, esportare nuovamente i dati sui costi per quel mese. Se è necessario esportare i dati per un mese precedente che non è disponibile, contattare il supporto tecnico per richiedere l'esportazione dei dati per risolvere il problema relativo alla qualità dei dati delle esecuzioni di esportazione precedenti.


Power BI: I report mancano dati per date specifiche

Se nel report mancano tutti i dati per uno o più mesi, controllare i parametri Number of Months, RangeStart e RangeEnd per assicurarsi che i dati non vengano filtrati.

Per controllare i parametri, selezionare Trasforma dati>Modifica parametri nella barra multifunzione o selezionare i singoli parametri nella 🛠️ cartella Imposta nella finestra dell'editor di query.

  • Se si desidera visualizzare sempre un numero specifico di mesi recenti, impostare Numero di mesi sul numero di mesi chiusi (completati). Il mese corrente è un mese aggiuntivo oltre al numero chiuso di mesi.
  • Se si vuole un intervallo di date fisso che non cambia nel tempo (ad esempio, report anno fiscale), impostare RangeStart e RangeEnd.
  • Se si desidera creare report su tutti i dati disponibili, verificare che tutti e tre i parametri di data siano vuoti.

Per altre informazioni, vedere Configurare il primo report.


Power BI: i report sono vuoti (nessun dato)

Se non vengono visualizzati dati in Power BI o in altri report o strumenti, provare a eseguire le operazioni seguenti in base all'origine dati:

  1. Se si usa il connettore Gestione costi in Power BI, controllare i Billing Account ID parametri e Number of Months per assicurarsi che siano impostati correttamente. Tenere presente che gli account di fatturazione precedenti potrebbero non avere dati negli ultimi mesi.
  2. Se si usano hub FinOps, controllare l'account dello storage per assicurarsi che i dati vengano riportati nel contenitore di inserimento. Dovresti vedere una cartella provider o sottoscrizioni. Usare le sezioni seguenti per risolvere altri problemi.

Hub FinOps: il contenitore di inserimento è vuoto

Se il contenitore di inserimento è vuoto, aprire l'istanza di Data Factory in Data Factory Studio e selezionare trigger>e verificare che il > sia avviato. In caso contrario, avvialo.

Se il trigger non viene avviato con l'errore "provider di risorse non è registrato", aprire la sottoscrizione nel portale di Azure, quindi selezionare Impostazioni>Provider di risorse, selezionare la riga Microsoft.EventGrid e poi selezionare il comando Registra in alto nella pagina. La registrazione potrebbe richiedere alcuni minuti.

Al termine della registrazione, avviare di nuovo il trigger msexports_FileAdded .

Dopo l'avvio del trigger, eseguire di nuovo tutte le esportazioni di Gestione costi connesse. I dati devono essere inseriti completamente entro 10-20 minuti, a seconda delle dimensioni dell'account.

Se il problema persiste, verificare se le esportazioni di Gestione costi sono configurate con il partizionamento dei file abilitato. Se viene disabilitato, attivarlo ed eseguire di nuovo le esportazioni.

Verificare che il contenitore di inserimento sia popolato e aggiornare i report o altri strumenti connessi.

Hub FinOps: file disponibili nel contenitore di inserimento

Se il contenitore di inserimento non è vuoto, verificare se sono presenti file parquet o csv.gz approfondendo le cartelle.

Una volta che sai, verifica che il parametro FileType sia impostato su .parquet o .gz nel report di Power BI. Per informazioni dettagliate, vedere Connettersi ai dati .

Se si usa un altro strumento, assicurarsi che supporti il tipo di file in uso.


Power BI: Impossibile risolvere il nome remoto: '<storage-account.dfs.core.windows.net>'

Indica che il nome dell'account di archiviazione non è corretto. Se si usano hub FinOps, verificare il parametro StorageUrl dall'implementazione. Per informazioni dettagliate, vedere Connettersi ai dati .


Power BI: Non è possibile convertire il valore null nel tipo Logical

Indica che il parametro ID account di fatturazione è vuoto. Se si usano hub FinOps, impostare il valore sull'ID dell'account di fatturazione desiderato. Se non si ha accesso all'account di fatturazione o non si vogliono includere acquisti di impegno e rimborsi, impostare il valore su 0, aprire la query CostDetails nell'editor avanzato e cambiare il 2 in un 1. Informa il report di non caricare i dati sui costi effettivi/fatturati dal connettore Gestione costi. Per informazioni dettagliate, vedere Connettersi ai dati .

Versioni applicabili: 0.1 - 0.1.1 (correzione nella versione 0.2)


Hub FinOps: non è possibile convertire il valore null in tipo Table

Questo errore indica in genere che i dati non sono stati inseriti nel contenitore di inserimento .

Se è stato appena eseguito l'aggiornamento agli hub FinOps 0.2, il problema potrebbe derivare dal report di Power BI obsoleto (dalla versione 0.1.x) o perché non si usano le esportazioni FOCUS. Per informazioni dettagliate, vedere la Guida all'aggiornamento.

Per altre procedure di risoluzione dei problemi, vedere Report vuoti (nessun dato ).


Inviare commenti e suggerimenti

Facci sapere come ci trovi con una breve recensione. Queste revisioni vengono usate per migliorare ed espandere strumenti e risorse FinOps.

Inviare commenti e suggerimenti

Se si sta cercando qualcosa di specifico, votare per un'idea esistente o crearne una nuova. Condividere idee con altri utenti per ottenere più voti. Ci concentriamo sulle idee con il maggior numero di voti.

Votare o suggerire idee


Contenuto correlato

Se non viene visualizzato l'errore riscontrato, vedere la guida alla risoluzione dei problemi. In caso di domande, avviare una discussione o creare un problema in GitHub.