Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi relativi ai file S3

Questa pagina consente di diagnosticare e risolvere i problemi più comuni relativi ai file S3.

Il comando Mount non riesce

Il mount -t s3files comando ha esito negativo e restituisce un errore.

Cause e azioni comuni:

Autorizzazione negata sulle operazioni sui file

È possibile montare il file system ma vengono visualizzati gli errori «Autorizzazione negata» o «Operazione non consentita» durante la lettura, la scrittura o l'accesso ai file.

Cause e azioni comuni:

Il routing di lettura intelligente non funziona

S3 Files esegue un routing di lettura intelligente in quanto indirizza automaticamente le richieste di lettura al livello di archiviazione più adatto a loro, mantenendo al contempo la semantica completa del file system, tra cui coerenza, blocco e autorizzazioni POSIX. Le letture casuali di piccole dimensioni dei file utilizzati attivamente vengono eseguite dallo storage ad alte prestazioni per una bassa latenza. Le letture sequenziali di grandi dimensioni e le letture di dati non presenti nel file system vengono eseguite direttamente dal bucket S3 per un throughput elevato, senza costi per i dati del file system.

Il routing di lettura intelligente potrebbe non funzionare se una delle metriche di connettività del client (NFSConnectionAccessible,S3BucketAccessible, andS3BucketReachable) mostra 0 o se non viene visualizzato il throughput di lettura previsto.

Cause e azioni comuni:

Il file system restituisce costantemente l'errore del server NFS

Un file system crittografato restituisce regolarmente errori del server NFS. Questi errori possono verificarsi quando S3 Files non è in grado di recuperare la chiave KMS da AWS KMS per uno dei seguenti motivi:

Operazione da eseguire

Innanzitutto, verifica che la chiave AWS KMS sia abilitata. Puoi visualizzare le tue chiavi nella console AWS KMS. Per ulteriori informazioni, consulta Visualizzazione di chiavi nella Guida per gli sviluppatori del Servizio AWS di gestione delle chiavi.

Se la chiave non è abilitato, abilitarla. Per ulteriori informazioni, consulta Abilitazione e disabilitazione delle chiavi nella Guida per gli sviluppatori del Servizio AWS di gestione delle chiavi.

Se la chiave è in attesa di cancellazione, annulla l'eliminazione e riattiva la chiave. Per ulteriori informazioni, consulta Pianificazione e annullamento dell'eliminazione delle chiavi nella Key Management Service DeveloperAWS Guide.

Se la chiave è abilitata e i problemi persistono, contatta l' AWS assistenza.

Oggetto mancante nel bucket S3 dopo la scrittura del file system

Hai scritto un file tramite il file system e ti aspettavi che apparisse come oggetto nel bucket S3, ma l'oggetto non c'è. S3 Files memorizza le modifiche in batch per circa 60 secondi prima di copiarle su S3. Se l'oggetto continua a non essere visualizzato, l'esportazione potrebbe non essere riuscita. In tal caso, si vedrà l'aumento della FailedExports CloudWatch metrica.

Operazione da eseguire

Controlla lo stato di esportazione del file utilizzando gli attributi estesi:

getfattr -n "user.s3files.status;$(date -u +%s)" missing-file.txt --only-values

Il timestamp nel nome dell'attributo ti assicura di ottenere lo stato più recente. Output di esempio:

S3Key: s3://bucket/prefix/missing-file.txt
ExportError: PathTooLong

ExportErrornon viene visualizzato se non si verifica un errore di esportazione. S3Keyè vuoto se un oggetto S3 non è mai stato collegato al file.

La tabella seguente elenca tutti i ExportError valori possibili:

S3 Files riprova automaticamente le esportazioni non riuscite. ExportErrorviene visualizzato solo per gli errori non riutilizzabili.

File che compaiono nella directory degli oggetti smarriti

I file sono comparsi nella .s3files-lost+found-file-system-id directory della directory principale del file system. In questo caso, si vede l'aumento della LostAndFoundFiles CloudWatch metrica. Ciò si verifica quando si verifica un conflitto di sincronizzazione. Si verifica un conflitto quando lo stesso file viene modificato tramite il file system e l'oggetto S3 corrispondente cambia prima che S3 Files sincronizzi le modifiche del file system con S3. S3 Files considera il bucket S3 come fonte di verità, sposta il file in conflitto nella directory degli oggetti perduti e importa l'ultima versione dal bucket S3 nel file system.

Identificazione dei file nella directory smarrita

Quando S3 Files sposta un file nella directory degli oggetti smarriti, aggiunge al nome del file un identificatore esadecimale per distinguere più versioni dello stesso file che potrebbero essere spostate nel tempo. I nomi di file più lunghi di 100 caratteri vengono troncati per fare spazio a questo identificatore. Il percorso della directory originale del file non viene conservato nella directory degli oggetti smarriti.

Operazione da eseguire

Ottieni il percorso originale del file e la chiave dell'oggetto S3 corrispondente:

getfattr -n "user.s3files.status;$(date -u +%s)" .s3files-lost+found-fs-12345678/abcdef1234_report.csv --only-values

Output di esempio:

S3Key: s3://bucket/prefix/report.csv
FilePath: /data/report.csv

Puoi quindi conservare la versione più recente dal tuo bucket S3 ed eliminare il file dalla directory degli oggetti smarriti o copiare il file dalla directory degli oggetti smarriti nel percorso originale per sovrascrivere la versione S3.

La sincronizzazione è in ritardo

La PendingExports CloudWatch metrica è in crescita, il che indica che il carico di lavoro genera modifiche più velocemente di quanto S3 Files sia in grado di sincronizzarle con S3.

Ciò significa che il carico di lavoro potrebbe superare la velocità di sincronizzazione. S3 Files esporta fino a 800 file al secondo per file system. Prendi in considerazione la possibilità di ridurre la velocità di modifica dei file o di distribuire il lavoro su più file system. Monitora la PendingExports metrica nel tempo. Se si stabilizza o diminuisce, S3 Files sta recuperando terreno. Se continua a crescere, contatta l' AWS assistenza.

Attivazione dei log di debug del client

Se stai risolvendo i problemi di montaggio, connettività o bypass di lettura, puoi abilitare la registrazione a livello di debug sul client S3 Files per acquisire maggiori dettagli.

Mount helper e watchdog logs

Modifica /etc/amazon/efs/s3files-utils.conf e cambia il livello di registrazione da INFO a DEBUG:

[DEFAULT]
logging_level = DEBUG

Smonta e rimontala il file system per rendere effettiva la modifica:

sudo umount /mnt/s3files
sudo mount -t s3files file-system-id:/ /mnt/s3files

I log vengono scritti in. /var/log/amazon/efs/ Il log mount helper è. mount.log

Registri del proxy (efs-proxy)

Il proxy gestisce il traffico NFS e il bypass di lettura S3. Per abilitare la registrazione di debug per il proxy, modifica: /etc/amazon/efs/s3files-utils.conf

[proxy]
proxy_logging_level = DEBUG

Smonta e rimontala per rendere effettiva la modifica. I log del proxy vengono scritti su. /var/log/amazon/efs/

Registri del tunnel TLS (stunnel)

I log del tunnel TLS sono disabilitati per impostazione predefinita. Per abilitarli, modifica /etc/amazon/efs/s3files-utils.conf e imposta quanto segue:

[mount]
stunnel_debug_enabled = true

Per salvare tutti i log degli stunnel di un file system in un unico file, decommenta anche la riga: stunnel_logs_file

stunnel_logs_file = /var/log/amazon/efs/{fs_id}.stunnel.log

Limiti di dimensione dei log

I file di registro vengono ruotati automaticamente. È possibile configurare la dimensione e il numero massimi di file ruotati in: s3files-utils.conf

[DEFAULT]
logging_max_bytes = 1048576
logging_file_count = 10

L'impostazione predefinita è 1 MB per file di registro con 10 file ruotati, per un massimo di 10 MB per tipo di registro.

Condivisione dei log con Support AWS

Quando contatti AWS Support, raccogli i log e la configurazione del client in un unico archivio:

sudo tar -czf /tmp/s3files-support-logs.tar.gz \
  /var/log/amazon/efs/ \
  /etc/amazon/efs/s3files-utils.conf

/tmp/s3files-support-logs.tar.gzIncludi nella tua richiesta di supporto.