Risoluzione dei problemi di Storage Intelligence

Questo documento descrive come risolvere i problemi comuni relativi a Storage Intelligence, ai report sull'inventario di Storage Insights, ai set di dati di Storage Insights, e alle operazioni batch di archiviazione.

Errori di configurazione di Storage Intelligence

Le sezioni seguenti descrivono gli errori che potresti riscontrare durante la configurazione o la gestione di Storage Intelligence per una risorsa.

400: Nome bucket non valido

Problema: la richiesta restituisce 400 Bad Request con il messaggio The specified bucket is not valid.

Soluzione: la richiesta non è valida. Assicurati che la richiesta soddisfi i seguenti requisiti:

  • Utilizza locations/global. Storage Intelligence non supporta altre località.
  • Assicurati che i nomi dei bucket o le espressioni regolari in bucket_id_regexes siano validi.

Di seguito è riportato un esempio di richiesta valida:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "edition_config": "STANDARD",
      "filter": {
        "included_cloud_storage_buckets": {
          "bucket_id_regexes": [
            "my-bucket-name",
            "prod-data-.*"
          ]
        }
      }
    }' \
    "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=edition_config,filter"

400: Argomento non valido - maschera di aggiornamento vuota

Problema: quando invii una richiesta di configurazione o aggiornamento, la richiesta restituisce 400 Bad Request con il messaggio Empty UPDATE_MASK in the request.

Soluzione: fornisci un UPDATE_MASK non vuoto nella richiesta. UPDATE_MASK specifica un elenco separato da virgole di FieldMask campi nella risorsa IntelligenceConfig da aggiornare (ad esempio updateMask=edition_config o updateMask=edition_config,filter).

400: Percorso della maschera di aggiornamento non valido

Problema: quando aggiorni una configurazione, la richiesta restituisce 400 Bad Request con il messaggio Invalid UPDATE_MASK paths.

Soluzione: verifica che ogni nome campo in UPDATE_MASK corrisponda a un campo valido nella risorsa IntelligenceConfig.

400: Il campo non può essere modificato

Problema: quando aggiorni una configurazione, la richiesta restituisce 400 Bad Request con il messaggio Invalid UPDATE_MASK: UPDATE_TIME field is not editable.

Soluzione: rimuovi i campi di sistema non modificabili (ad esempio UPDATE_TIME) da UPDATE_MASK. Specifica solo i campi modificabili definiti in IntelligenceConfig.

400: Valore non valido

Problema: la richiesta restituisce 400 Bad Request con il messaggio Invalid value at storage_intelligence.edition_config.

Soluzione: imposta edition_config su un valore supportato: INHERIT, STANDARD, o DISABLED.

400: Filtro non vuoto

Problema: la richiesta restituisce 400 Bad Request con il messaggio Non-empty filter cannot be specified for INHERIT or DISABLED edition configuration.

Soluzione: rimuovi i filtri dei bucket dalla richiesta. I filtri dei bucket non sono supportati quando edition_config è impostato su INHERIT o DISABLED.

400: Valori di località o bucket vuoti nel filtro

Problema: la richiesta restituisce 400 Bad Request con il messaggio Empty location or bucket values in filter.

Soluzione: assicurati che né location né bucket siano stringhe vuote in nel tuo filtro dei bucket.

Problemi comuni di Storage Insights

Questa sezione descrive come risolvere i problemi comuni relativi ai report sull'inventario e ai set di dati.

Generazione di più report sull'inventario al giorno

Problema: una configurazione di report sull'inventario genera più file di report al giorno.

Soluzione: Cloud Storage suddivide i report sull'inventario per i bucket con più di 1.000.000 di oggetti, generando una suddivisione per 1.000.000 di oggetti. Ad esempio, un bucket con 3.500.000 oggetti genera quattro suddivisioni di report e un file manifest che elenca ogni suddivisione.

I report sull'inventario non vengono visualizzati nel bucket di destinazione

Problema: i report sull'inventario non vengono visualizzati nel bucket di destinazione.

Soluzione: se i report non vengono inviati al bucket di destinazione, verifica quanto segue:

  • Assicurati che la data di inizio configurata sia trascorsa. Per saperne di più, consulta Creare una configurazione di report sull'inventario.

  • Visualizza la cronologia dei report sull'inventario per verificare la presenza di errori e le relative cause principali. Per visualizzare la cronologia dei report sull'inventario:

    1. Nella Google Cloud console, vai alla pagina Bucket di Cloud Storage.

      Vai a Bucket

    2. Nell'elenco dei bucket, fai clic sul nome del bucket di origine che contiene la configurazione del report sull'inventario.

    3. Nella pagina Dettagli bucket, fai clic sulla scheda Report sull'inventario.

    4. Nell'elenco delle configurazioni dei report sull'inventario, fai clic sull'UUID della configurazione del report sull'inventario che ha generato i report che vuoi controllare.

    5. Controlla la presenza di errori nella sezione Cronologia del report sull'inventario. Puoi tenere il puntatore sopra Guida () per visualizzare i dettagli sul motivo per cui si è verificato un errore.

  • Assicurati che al service agent a livello di progetto siano stati concessi i ruoli IAM necessari per la lettura e la scrittura dei report sull'inventario. Per saperne di più, consulta Concedere i ruoli richiesti al service agent.

Ritardi nei report sull'inventario

Problema: la generazione dei report sull'inventario è ritardata.

Soluzione: i tempi di generazione dei report variano. I ritardi fino a 24 ore sono normali.

I set di dati non vengono compilati

Problema: le tabelle dei set di dati di Storage Insights rimangono vuote.

Soluzione: nel set di dati BigQuery collegato, controlla error_attributes_view per i codici di errore. Per saperne di più, consulta Risolvere i problemi relativi ai set di dati.

Valori null nella colonna "ref" durante l'esecuzione di query sui set di dati

Problema: quando esegui query sui set di dati di Storage Insights in BigQuery, la ref colonna restituisce null.

Soluzione: per gli oggetti che terminano con /, la colonna ref nei set di dati è null.

Se la colonna ref restituisce valori null quando esegui query sui set di dati di Storage Insights in BigQuery, verifica di aver concesso le autorizzazioni e i ruoli di connessione richiesti, incluso l'accesso alle risorse Cloud Storage, come descritto in Analizzare i dati e i metadati degli oggetti utilizzando BigQuery.

Errori di convalida dei job di operazioni batch di archiviazione

Questa sezione descrive gli errori di convalida che si verificano quando invii una richiesta di job di operazioni batch a storagebatchoperations.googleapis.com.

400: ID job o nome risorsa non valido

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con il motivo JOB_ID_INVALID o RESOURCE_NAME_TOO_LONG.

Soluzione: verifica che l'ID job sia composto da 1-63 caratteri alfanumerici minuscoli o trattini ([a-z0-9]([-a-z0-9]*[a-z0-9])?) e che il percorso completo della risorsa job (projects/PROJECT_ID/locations/LOCATION/jobs/JOB_ID) non superi i 200 byte. Se il percorso supera i 200 byte, accorcia l'ID job. Per saperne di più, consulta Nome job.

400: La descrizione del job supera il limite

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con il motivo DESCRIPTION_TOO_LONG.

Soluzione: assicurati che la descrizione del job non superi i 1024 byte. Se supera questo limite, accorcia il testo. Per saperne di più, consulta Descrizione del job.

400: Configurazioni di origine del job mancanti o non valide

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con uno dei seguenti motivi:

  • SOURCE_NOT_SPECIFIED
  • BUCKET_LIST_EMPTY
  • TOO_MANY_BUCKETS
  • MULTI_BUCKET_NOT_SUPPORTED
  • BUCKET_NAME_REQUIRED
  • OBJECT_CONFIGURATION_REQUIRED

Soluzione: assicurati che il job specifichi una configurazione di origine valida (bucket_list o project_source) e che ogni bucket definisca un metodo di selezione degli oggetti. Per saperne di più, consulta Creare e gestire i job di operazioni batch.

400: Nome bucket o oggetto non valido

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con il motivo BUCKET_NAME_INVALID o OBJECT_NAME_INVALID.

Soluzione: assicurati che tutti i nomi di bucket e oggetti rispettino i requisiti di denominazione di Cloud Storage. Per saperne di più, consulta Linee guida per la denominazione dei bucket e Linee guida per la denominazione degli oggetti.

400: Errori di configurazione dell'origine del progetto

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con uno dei seguenti motivi:

  • PROJECT_SOURCE_PROJECT_INVALID
  • PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE
  • PROJECT_SOURCE_DRY_RUN_ID_INVALID

Soluzione: verifica che la configurazione dell'origine del progetto soddisfi i requisiti di formattazione e di esclusività dei campi. Se specifichi un ID job di simulazione, ometti tutti gli altri parametri project_source. Per saperne di più, consulta Creare un job utilizzando i filtri avanzati.

400: Parametri di trasformazione in conflitto o mancanti

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con uno dei seguenti motivi:

  • TRANSFORMATION_NOT_SPECIFIED
  • REWRITE_OBJECT_MISSING_PARAMETERS
  • PUT_OBJECT_HOLD_MISSING_PARAMETERS
  • PUT_METADATA_MISSING_PARAMETERS

Soluzione: specifica esattamente un tipo di trasformazione con tutti i parametri richiesti. Se configuri la conservazione degli oggetti, verifica che Object Lock sia abilitato sul bucket e che i timestamp utilizzino il formato RFC 3339 UTC. Per saperne di più sui requisiti dei parametri per trasformazione, consulta Tipo di prestazione.

400: Prefissi degli oggetti sovrapposti o duplicati

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con il motivo OBJECT_PREFIX_OVERLAP o DUPLICATE_OBJECT_PREFIX.

Soluzione: rimuovi i prefissi duplicati e assicurati che nessun prefisso in included_object_prefixes sia un prefisso di un'altra voce nell'elenco. Per saperne di più, consulta Prefissi degli oggetti.

400: Problemi di formattazione e accesso ai file manifest

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (INVALID_ARGUMENT) con il motivo MANIFEST_LOCATION_REQUIRED o MANIFEST_LOCATION_INVALID oppure il job non riesce a leggere il manifest.

Soluzione: verifica che l'URI del manifest sia un percorso CSV valido (gs://<bucket_name>/<path>/<object_name>.csv) e che il service agent di operazioni batch di archiviazione abbia il roles/storage.objectViewer ruolo nel bucket del manifest. Per saperne di più sui requisiti di formattazione e schema CSV, consulta Manifest.

400: Errori di rilevamento dei set di dati di Storage Insights

Problema: l'utilizzo di un set di dati di Storage Insights per il rilevamento degli oggetti restituisce una 400 Bad Request (INVALID_ARGUMENT o FAILED_PRECONDITION) risposta con uno dei seguenti motivi:

  • BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD
  • TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME
  • BUCKET_DISCOVERY_TOO_MANY_BUCKETS

Soluzione: verifica che snapshot_time sia nelle ultime 48 ore, specifica target_locations per i bucket e assicurati che la query di rilevamento corrisponda a non più di 1000 bucket. Per saperne di più, consulta Creare un manifest utilizzando i set di dati di Storage Insights.

400: La trasformazione della classe di archiviazione non riesce sui bucket con Autoclass abilitato

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (FAILED_PRECONDITION) con il motivo AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED.

Soluzione: non puoi eseguire trasformazioni della classe di archiviazione sui bucket con Autoclass abilitato. Seleziona un bucket senza Autoclass o rimuovi la trasformazione della classe di archiviazione. Per saperne di più, consulta Limitazioni di Autoclass.

400: Gli aggiornamenti degli ACL degli oggetti non riescono sui bucket con accesso uniforme a livello di bucket

Problema: la richiesta di creazione del job restituisce una risposta 400 Bad Request (FAILED_PRECONDITION) con il motivo UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED.

Soluzione: non puoi aggiornare gli ACL degli oggetti sui bucket con accesso uniforme a livello di bucket abilitato. Gestisci l'accesso utilizzando i ruoli IAM a livello di bucket o progetto. Per saperne di più, consulta Accesso uniforme a livello di bucket.

Problemi di runtime ed esecuzione delle operazioni batch di archiviazione

Questa sezione descrive i problemi che si verificano durante l'esecuzione asincrona di un job di operazioni batch.

403: Errori di autorizzazione durante l'esecuzione

Problema: un job batch non riesce durante l'esecuzione con 403 Forbidden (PERMISSION_DENIED).

Soluzione: concedi al service agent di operazioni batch di archiviazione (service-PROJECT_NUMBER@gcp-sa-storagebatchoperations.iam.gserviceaccount.com) i ruoli IAM richiesti per il tipo di trasformazione. Per saperne di più, consulta Concedere le autorizzazioni al service agent.

Errori di crittografia CMEK durante la riscrittura degli oggetti

Problema: le riscritture degli oggetti non riescono con 400 Bad Request o 403 Forbidden a causa dello stato della chiave Cloud KMS o di errori di autorizzazione.

Soluzione: verifica che la chiave Cloud KMS sia Enabled e si trovi nella stessa regione del bucket di destinazione e che il service agent abbia il ruolo roles/cloudkms.cryptoKeyEncrypterDecrypter. Per saperne di più, consulta Tipo di prestazione: riscrivi oggetto.

Numero elevato di errori in error_summaries

Problema: un job batch viene completato con un valore diverso da zero di counters.failed_object_count e codici di errore in error_summaries (ad esempio 404 NOT_FOUND, 412 FAILED_PRECONDITION, o 403 PERMISSION_DENIED).

Soluzione: esegui gcloud storage batch-operations jobs describe con il --location flag (ad esempio, gcloud storage batch-operations jobs describe JOB_ID --location=LOCATION) per visualizzare la suddivisione degli errori aggregati e controlla Cloud Logging per i log degli errori per oggetto. Per saperne di più, consulta Visualizzare i dettagli del job.

Il job di operazioni batch di archiviazione non riesce a causa di uno snapshot risalente a più di due giorni fa

Problema: quando crei un job di operazioni batch di archiviazione basato su filtri CEL, la creazione del job non riesce. Il messaggio di errore indica che il timestamp dello snapshot risale a più di due giorni fa.

Soluzione: per evitare azioni sugli stati degli oggetti obsoleti, le operazioni batch di archiviazione non riescono automaticamente a creare il job. Questo errore si verifica se lo snapshot selezionato risale a più di due giorni fa. Seleziona uno dei seguenti metodi per risolvere il problema:

  • Utilizza un file manifest: esegui manualmente una query sul set di dati in BigQuery. Esporta i risultati in un file manifest CSV e carica il file in un bucket Cloud Storage. Puoi quindi creare il job di operazioni batch utilizzando il metodo manifest per evitare il limite di due giorni.
  • Controlla le configurazioni dei set di dati: verifica che le tue configurazioni dei set di dati siano attive e non in pausa. Verifica che gli snapshot dei set di dati vengano eseguiti correttamente. Per informazioni su come verificare le configurazioni, consulta Visualizzare la configurazione di un set di dati.
  • Utilizza le sostituzioni di località di destinazione e timestamp dello snapshot: specifica il flag --target-snapshot-time per ignorare l'errore di obsolescenza di due giorni selezionando esplicitamente uno snapshot in formato RFC 3339. Specifica il flag --target-locations per limitare l'operazione alle località in cui esiste lo snapshot. Puoi utilizzare queste sostituzioni per risolvere i ritardi di sincronizzazione che impediscono l'aggiornamento dello snapshot globale automatico. Di conseguenza, puoi selezionare manualmente uno snapshot regionale più recente. Per la sintassi dei comandi, consulta Creare un job utilizzando i filtri avanzati.

Il job di operazioni batch di archiviazione basato su filtri CEL non riesce sui progetti appena abbonati

Problema: l'esecuzione di un job di operazioni batch di archiviazione basato su filtri CEL su un progetto appena abbonato non riesce perché il sistema non riesce a trovare uno snapshot valido.

Soluzione: dopo aver abilitato l'abbonamento a Storage Intelligence, devi attendere 24 ore prima di eseguire i job di operazioni batch di archiviazione basati su filtri CEL. Questo ritardo consente al sistema di eseguire lo snapshot iniziale dei metadati e di stabilire il timestamp iniziale dello snapshot.

Il job di operazioni batch di archiviazione basato su filtri CEL non riesce a causa di errori di autorizzazione o genera errori di runtime

Problema: un job di operazioni batch di archiviazione basato su filtri CEL non riesce durante l'esecuzione o restituisce errori di autorizzazione di runtime.

Soluzione: le operazioni batch di archiviazione utilizzano le tue credenziali utente per elaborare gli oggetti. Il job non riesce se non disponi delle autorizzazioni di lettura o scrittura IAM necessarie per i bucket e gli oggetti di destinazione. Questo problema si verifica quando i filtri CEL selezionano risorse a cui non hai accesso. Verifica che il tuo account disponga dei ruoli Amministratore archiviazione (roles/storage.admin), Amministratore oggetti Storage (roles/storage.objectAdmin) o ruoli equivalenti per tutti i bucket e gli oggetti nell'ambito del job. Per istruzioni sulla concessione dei ruoli, consulta Utilizzare le autorizzazioni IAM.

Monitoraggio e analisi dei log

Per saperne di più sull'ispezione degli errori di esecuzione per oggetto e dei payload di errore in Cloud Logging, consulta Visualizzare i log delle operazioni batch di archiviazione.

Problemi relativi al consulente di Storage Intelligence

Questa sezione fornisce indicazioni su come risolvere i problemi più comuni riscontrati durante l'utilizzo del consulente di Storage Intelligence.

Errori di autorizzazione negata del consulente di Storage Intelligence

Problema: quando accedi al consulente di Storage Intelligence, viene visualizzato un errore Permission denied e i grafici e le metriche sono vuoti o mostrano errori di autorizzazione.

Soluzione: questo problema si verifica se non disponi di un ruolo IAM con le autorizzazioni richieste per visualizzare il consulente di Storage Intelligence. Chiedi all'amministratore di concederti il ruolo Amministratore archiviazione (roles/storage.admin) nel progetto, nella cartella o nell'organizzazione che vuoi visualizzare. Per un elenco delle autorizzazioni richieste, consulta Ruoli richiesti.

Autorizzazioni insufficienti per visualizzare un progetto interessato

Problema: quando visualizzi i risultati a livello di organizzazione o cartella, il riquadro Progetti con risultati rilevati mostra un indicatore di avviso con il messaggio You've insufficient permission to access this project accanto a un progetto.

Soluzione: questo problema si verifica se disponi delle autorizzazioni per visualizzare il consulente di Storage Intelligence a livello di organizzazione o cartella, ma non disponi delle autorizzazioni IAM richieste per quel progetto specifico. Chiedi all'amministratore del progetto di concederti il ruolo Amministratore archiviazione (roles/storage.admin) nel progetto interessato.

Il consulente di Storage Intelligence è vuoto o mancano i dati

Problema: la pagina del consulente di Storage Intelligence viene caricata e i grafici, le metriche nella sezione Panoramica (con l'etichetta Panoramica del progetto, Panoramica della cartella o Panoramica dell'organizzazione a seconda della risorsa selezionata) o la sezione Risultati principali sono vuoti o i dati sono obsoleti.

Soluzione: questo problema può verificarsi per i seguenti motivi:

  • Latenza di elaborazione dei dati: le metriche e i risultati di Storage Intelligence si basano su snapshot giornalieri e sull'analisi dell'utilizzo dello spazio di archiviazione. La visualizzazione dei dati nel consulente di Storage Intelligence può richiedere dalle 24 alle 48 ore. Questi ritardi si verificano in genere dopo la creazione di nuovi bucket o quando visualizzi il consulente di Storage Intelligence per la prima volta. Se prevedi di visualizzare i dati delle attività recenti, attendi 48 ore e poi controlla di nuovo.
  • Nessuna risorsa di archiviazione: se il progetto, la cartella o l'organizzazione selezionata non contiene bucket o oggetti per il periodo di tempo selezionato, il consulente di Storage Intelligence è vuoto. Scegli un progetto, una cartella o un'organizzazione diversa che contenga risorse di archiviazione.
  • Filtro temporale errato: il filtro temporale è impostato su un intervallo in cui non si è verificata alcuna attività di archiviazione. Modifica il filtro temporale in modo che includa l'attività di archiviazione.

I risultati non vengono visualizzati nel consulente di Storage Intelligence

Problema: prevedi di visualizzare i risultati nella sezione Risultati principali in base all'attività di archiviazione recente, ma la sezione è vuota.

Soluzione: questo problema si verifica se il consulente di Storage Intelligence non genera risultati per il periodo di tempo selezionato. La mancanza di risultati può verificarsi per i seguenti motivi:

  • Nessun pattern corrispondente: l'ultimo ciclo di analisi non ha rilevato alcun comportamento di archiviazione che corrisponda a un pattern di risultati.
  • Ritardi nell'elaborazione dei dati: i risultati si basano sulle metriche di archiviazione, la cui elaborazione richiede dalle 24 alle 48 ore. I risultati per gli eventi verificatisi nelle ultime 24 ore vengono visualizzati al termine del ciclo di elaborazione successivo.

Problemi durante l'utilizzo dei Controlli di servizio VPC

Problema: quando tenti di accedere al consulente di Storage Intelligence da un progetto all'interno di un perimetro di servizio dei Controlli di servizio VPC, vengono visualizzati errori di accesso negato o di autorizzazione.

Soluzione: questo problema si verifica se i Controlli di servizio VPC non sono configurati correttamente per consentire la comunicazione tra il progetto, la Google Cloud console e le risorse di Storage Intelligence. Per risolvere il problema, esamina i seguenti requisiti:

  • Servizi limitati: verifica se il perimetro di servizio limita l'API Cloud Storage (storage.googleapis.com) e l'API Storage Insights (storageinsights.googleapis.com). Per maggiori dettagli, consulta Elencare e descrivere i parametri di servizio.
  • Configurazione del perimetro: verifica che il progetto che utilizzi per visualizzare il consulente di Storage Intelligence si trovi nello stesso perimetro di servizio dei progetti che monitori. Se si trovano in perimetri diversi, devi configurare le regole di entrata e uscita o utilizzare i ponti perimetrali.
  • Accesso dall'esterno del perimetro: se accedi alla Google Cloud console da una rete esterna al perimetro, devi creare una regola di entrata o un livello di accesso che includa il tuo account utente e l'intervallo di indirizzi IP pubblici che stai utilizzando.
  • VPC condiviso: se utilizzi il VPC condiviso, verifica che il progetto si trovi nello stesso perimetro di servizio dei progetti di servizio. Per maggiori dettagli, consulta VPC condiviso.
  • Audit log: utilizza lo strumento di analisi delle violazioni per verificare la presenza di violazioni dei Controlli di servizio VPC negli audit log. Lo strumento di analisi delle violazioni ti aiuta a diagnosticare la violazione e a identificare le cause, ad esempio un errore RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER.

Passaggi successivi