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à.
Parametri per la registrazione in Aurora PostgreSQL RDS per
È possibile personalizzare il comportamento di registrazione per il cluster database Aurora PostgreSQL modificando vari parametri. Nella tabella seguente sono riportati, tra le altre impostazioni, i parametri che stabiliscono la durata di archiviazione dei log, quando ruotarli e se l'output del log è in formato CSV (valori separati da virgole). Puoi anche trovare l'output di testo inviato a STDERR, tra le altre impostazioni. Per modificare le impostazioni per i parametri modificabili, utilizza un gruppo di parametri del·cluster database personalizzato per il cluster database Aurora PostgreSQL. Per ulteriori informazioni, consulta .
| Parametro | Predefinito | Descrizione |
|---|---|---|
log_destination |
stderr |
Imposta il formato di output per il registro. L'impostazione predefinita è |
log_filename |
postgresql.log.%Y-%m-%d-%H%M |
Specifica il modello per il nome del file di log. Oltre al valore predefinito, questo parametro supporta |
log_line_prefix |
%t:%r:%u@%d:[%p]: |
Definisce il prefisso per ogni riga di log che viene scritta in |
log_rotation_age |
60 |
I minuti dopo i quali il file di log viene ruotato automaticamente. È possibile modificare questo valore nell'intervallo compreso tra 1 e 1440 minuti. Per ulteriori informazioni, consulta Impostazione della rotazione dei file di log. |
log_rotation_size |
– |
La dimensione (KB) che stabilisce la rotazione automatica del log. È possibile modificare questo valore nell'intervallo compreso tra 50.000 e 1.000.000 di kilobyte. Per ulteriori informazioni, consulta Impostazione della rotazione dei file di log. |
rds.log_retention_period |
4320 |
I registri PostgreSQL più vecchi del numero di minuti specificato vengono eliminati. Il valore di default di 4.320 minuti elimina i file di log dopo 3 giorni. Per ulteriori informazioni, consulta Impostazione del periodo di retention dei log. |
Per identificare i problemi dell'applicazione, puoi cercare fallimenti di query, errori di accesso, deadlock ed errori irreversibili del server nel registro. Ad esempio, supponi di convertire un'applicazione legacy da Oracle ad Aurora PostgreSQL, ma non tutte le query sono state convertite correttamente. Queste query formattate in modo errato generano messaggi di errore nei registri che puoi utilizzare per identificare i problemi. Per ulteriori informazioni sulla registrazione delle query, consulta Attivazione della registrazione delle query per il cluster database Aurora PostgreSQL.
Negli argomenti seguenti sono disponibili informazioni su come impostare vari parametri che controllano i dettagli di base dei log PostgreSQL.
Argomenti
Impostazione del periodo di retention dei log
Il parametro rds.log_retention_period specifica per quanto tempo il cluster database Aurora PostgreSQL conserva i file di log. L'impostazione predefinita è 3 giorni (4.320 minuti), ma è possibile impostare qualsiasi valore compreso tra 1 giorno (1.440 minuti) e 7 giorni (10.080 minuti). Assicurati che il cluster database Aurora PostgreSQL abbia spazio di archiviazione sufficiente per contenere i file di log per il periodo di tempo specificato.
Ti consigliamo di pubblicare regolarmente i log su Amazon CloudWatch Logs in modo da poter visualizzare e analizzare i dati di sistema molto tempo dopo che i log sono stati rimossi dal cluster Aurora PostgreSQL DB. Per ulteriori informazioni, consulta Pubblicazione dei log di Aurora PostgreSQL su Amazon Logs CloudWatch . Dopo aver impostato la CloudWatch pubblicazione, Aurora elimina un registro solo dopo la pubblicazione su Logs. CloudWatch
Amazon Aurora comprime i log PostgreSQL meno recenti quando lo spazio di archiviazione per l'istanza database raggiunge una determinata soglia. Aurora comprime i file utilizzando l'utilità di compressione gzip. Per ulteriori informazioni, consulta il sito web di gzip
Quando lo spazio di archiviazione per l'istanza database si riduce e tutti i log disponibili sono compressi, si riceve un avviso del tipo seguente:
Warning: local storage for PostgreSQL log files is critically low for
this Aurora PostgreSQL instance, and could lead to a database outage.Se lo spazio di archiviazione non è sufficiente, Aurora potrebbe eliminare i log PostgreSQL compressi prima della fine del periodo di conservazione specificato. Se ciò accade, viene visualizzato un messaggio simile al seguente:
The oldest PostgreSQL log files were deleted due to local storage constraints.
Impostazione della rotazione dei file di log
Per impostazione predefinita, nuovi file di log vengono creati da Aurora ogni ora. La tempistica è controllata dal parametro log_rotation_age. Questo parametro ha un valore predefinito di 60 (minuti), ma è possibile impostarlo su qualsiasi valore tra 1 minuto e 24 ore (1.440 minuti). Al momento della rotazione, viene creato un nuovo file di log distinto. Il file è denominato in base al modello specificato dal parametro log_filename.
I file di log possono anche essere ruotati in base alle loro dimensioni, come specificato dal parametro log_rotation_size. Questo parametro specifica che il log deve essere ruotato quando raggiunge la dimensione specificata (in kilobyte). Il valore di timeout predefinito per log_rotation_size è di 100.000 kB (kilobyte) per un cluster di database Aurora PostgreSQL, ma puoi impostare questo parametro a qualsiasi valore compreso tra 50.000 e 1.000.000 kilobyte.
I nomi dei file di registro si basano sul modello di nome di file specificato nel parametro log_filename. Le impostazioni disponibili per questo parametro sono le seguenti:
-
postgresql.log.%Y-%m-%d: formato predefinito per il nome del file di registro. Include l'anno, il mese e la data nel nome del file di log. -
postgresql.log.%Y-%m-%d-%H: include l'ora nel formato del nome del file di registro. -
postgresql.log.%Y-%m-%d-%H%M: include ora:minuto nel formato del nome del file di log.
Se imposti il parametro log_rotation_age su un valore inferiore a 60 minuti, imposta il parametro log_filename sul formato minuti.
Per ulteriori informazioni, consulta log_rotation_agelog_rotation_size
Impostazione della destinazione del registro (stderr, csvlog)
Per impostazione predefinita, Aurora PostgreSQL genera i log in formato errore standard (stderr). Questo formato è l'impostazione predefinita per il parametro log_destination. Ogni messaggio ha un prefisso che utilizza il modello specificato nel parametro log_line_prefix. Per ulteriori informazioni, consulta Informazioni sul parametro log_line_prefix.
Aurora PostgreSQL può anche generare log in formato csvlog. Il formato csvlog è utile per analizzare i dati dei registri in formato CSV. Ad esempio, supponi di utilizzare l'estensione log_fdw per lavorare con i log come tabelle esterne. La tabella esterna creata sui file di log di stderr contiene una singola colonna con i dati degli eventi di log. Aggiungendo csvlog al parametro log_destination, ottieni il file di log in formato CSV con le demarcazioni per le diverse colonne della tabella esterna. In tal modo puoi ordinare e analizzare i log più facilmente.
Se specifichi csvlog per questo parametro, tieni presente che vengono generati entrambi i file stderr e csvlog. Ti consigliamo di monitorare lo spazio di archiviazione consumato dai registri tenendo conto di rds.log_retention_period e delle altre impostazioni che influiscono sull'archiviazione e sulla rotazione dei registri. Utilizzando stderr e csvlog lo spazio di archiviazione consumato dai registri aumenta più del doppio.
Se aggiungi csvlog a log_destination e vuoi ripristinare solo stderr, devi reimpostare il parametro. Per farlo, nella console Amazon RDS apri il gruppo di parametri del·cluster database personalizzato per la tua istanza. Scegli il parametro log_destination, seleziona Edit parameter (Modifica parametro), quindi Reset (Reimposta).
Per ulteriori informazioni sulla configurazione dei registri, consulta Utilizzo dei log Amazon RDS e Aurora PostgreSQL: Parte 1
Informazioni sul parametro log_line_prefix
Il formato di stderr registro prefissa ogni messaggio di registro con i dettagli specificati dal parametro. log_line_prefix Il valore predefinito è:
%t:%r:%u@%d:[%p]:tA partire dalla versione 16 di Aurora PostgreSQL, puoi anche scegliere:
%m:%r:%u@%d:[%p]:%l:%e:%s:%v:%x:%c:%q%aOgni voce di registro inviata a stderr include le seguenti informazioni in base al valore selezionato:
-
%t— Ora di immissione del registro senza millisecondi -
%m— Ora di immissione del registro in millisecondi -
%r- Indirizzo dell'host remoto -
%u@%d- Nome utente @ nome del database -
[%p]- ID del processo, se disponibile -
%l— Numero di riga di registro per sessione -
%e— Codice di errore SQL -
%s— Timestamp di inizio del processo -
%v— ID della transazione virtuale -
%x— ID della transazione -
%c— ID della sessione -
%q— Terminatore non di sessione -
%a— Nome dell'applicazione
