Paramètres de connexion à SQL - Amazon Relational Database Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Paramètres de connexion à SQL

Vous pouvez personnaliser le comportement de journalisation de votre pour une SQL instance de base de données Postgre en modifiant divers paramètres. Dans le tableau suivant, vous trouverez les paramètres qui affectent la durée de conservation des journaux, le moment auquel les journaux doivent être pivotés et l'opportunité de les afficher sous forme de format CSV (valeurs séparées par des virgules). Vous pouvez également trouver le texte de sortie envoyé àSTDERR, entre autres paramètres. Pour modifier les paramètres modifiables, utilisez un groupe de paramètres de base de de base de . RDSpour une SQL instance Postgre. Pour plus d'informations, consultez Groupes de paramètres de base de données pour les instances de base de données RDSAmazon. Comme indiqué dans le tableau, log_line_prefix ne peut pas être modifié.

Paramètre Par défaut Description

log_destination

stderr

Définit le format de sortie pour le journal. La valeur par défaut eststderr, mais vous pouvez également spécifier une valeur séparée par des virgules (CSV) en ajoutant csvlog au paramètre. Pour plus d’informations, consultez Définition de la destination du journal (stderr, csvlog).

log_filename

postgresql.log.%Y-%m-%d-%H

Spécifie le modèle du nom de fichier journal. Outre la valeur par défaut, ce paramètre prend en chargepostgresql.log.%Y-%m-%d pour le modèle de nom de fichier.

log_line_prefix

%t:%r:%u@%d:[%p]:

Définit le préfixe pour chaque ligne de journal qui est écrite sur stderr, afin de noter l'heure (%t), l'hôte distant (%r), l'utilisateur (%u), la base de données (%d) et l'ID du processus (%p). Vous ne pouvez pas modifier ce paramètre.

log_rotation_age

60

Minutes après lesquelles la rotation automatique du fichier journal est effectuée. Vous pouvez modifier cette valeur entre 1 et 1 440 minutes. Pour de plus amples informations, veuillez consulter Définition de la rotation des fichiers journaux.

log_rotation_size

Taille (en Ko) à laquelle la rotation automatique du fichier journal est effectuée. Par défaut, ce paramètre n'est pas utilisé car les journaux sont pivotés en fonction du log_rotation_age paramètre. Pour en savoir plus, consultez Définition de la rotation des fichiers journaux.

rds.log_retention_period

4320

Les SQL journaux Postgre antérieurs au nombre de minutes spécifié sont supprimés. La valeur par défaut de 4 320 minutes supprime les fichiers journaux après trois jours. Pour de plus amples informations, veuillez consulter Définition de la période de conservation des journaux.

Pour identifier les problèmes d'application, vous pouvez rechercher dans le journal les échecs de requête, les échecs de connexion, les interblocages et les erreurs fatales du serveur. Supposons, par exemple, que vous ayez converti une ancienne application d'Oracle vers Amazon RDS PostgreSQL, mais que toutes les requêtes ne soient pas converties correctement. Ces requêtes mal formatées génèrent des messages d'erreur que vous pouvez trouver dans les journaux pour aider à identifier les problèmes. Pour plus d'informations sur la journalisation des requêtes, consultez Activation de la journalisation des requêtes pour votre pour une instance de base de données Postgre SQL.

Dans les rubriques suivantes, vous trouverez des informations sur la façon de définir les différents paramètres qui contrôlent les détails de base de vos SQL journaux Postgre.

Définition de la période de conservation des journaux

Le rds.log_retention_period paramètre indique la durée pendant laquelle votre pour SQL instance de base de données Postgre conserve ses fichiers journaux. La valeur par défaut est de 3 jours (4 320 minutes), mais vous pouvez définir une valeur comprise entre 1 jour (1 440 minutes) et 7 jours (10 080 minutes). Assurez-vous que votre pour SQL instance de base de données Postgre dispose d'un espace de stockage suffisant pour conserver les fichiers journaux pendant une période donnée.

Nous vous recommandons de publier régulièrement vos CloudWatch journaux sur Amazon Logs afin de pouvoir consulter et analyser les données du système longtemps après leur suppression de votre . RDSpour une SQL instance de base de données Postgre. Pour en savoir plus, consultez Publier des SQL logs Postgre sur Amazon CloudWatch Logs.

Définition de la rotation des fichiers journaux

Amazon RDS crée de nouveaux fichiers journaux toutes les heures par défaut. Le timing est contrôlé par le paramètre log_rotation_age. Ce paramètre a une valeur par défaut de 60 (minutes), mais vous pouvez le régler sur une valeur comprise entre 1 minute et 24 heures (1 440 minutes). Au moment de la rotation, un fichier journal distinct est créé. Le fichier est nommé selon le modèle spécifié par le paramètre log_filename.

Les fichiers journaux peuvent également faire l'objet d'une rotation en fonction de leur taille, comme indiqué dans le paramètre log_rotation_size. Ce paramètre indique que le journal doit faire l'objet d'une rotation lorsqu'il atteint la taille spécifiée (en kilo-octets). RDSPour une SQL instance de base de données Postgre, elle log_rotation_size n'est pas définie, c'est-à-dire qu'aucune valeur n'est spécifiée. Toutefois, vous pouvez définir ce paramètre entre 0 et 2 097 151 Ko (kilo-octets).

Les noms de fichier journal sont basés sur le modèle de nom de fichier spécifié dans le paramètre log_filename. Les valeurs disponibles pour ce paramètre sont les suivantes :

  • postgresql.log.%Y-%m-%d : format par défaut du nom de fichier journal. Inclut l'année, le mois et la date dans le nom du fichier journal.

  • postgresql.log.%Y-%m-%d-%H – Inclut l'heure dans le format du nom de fichier journal.

Pour plus d'informations, consultez log_rotation_ageet consultez log_rotation_sizela SQL documentation Postgre.

Définition de la destination du journal (stderr, csvlog)

Par défaut, Amazon RDS Postgre SQL génère des journaux au format d'erreur standard (stderr). Ce format correspond au réglage par défaut du paramètre log_destination. Chaque message est préfixé selon le modèle spécifié dans le paramètre log_line_prefix. Pour de plus amples informations, veuillez consulter Compréhension du paramètre log_line_prefix.

pour Postgre SQL peut également générer les journaux au csvlog format. Le csvlog est utile pour analyser les données du journal sous forme de données de valeurs séparées par des virgules (CSV). Par exemple, supposons que vous utilisez l'extension log_fdw pour travailler avec vos journaux en tant que tables externes. La table externe créée sur les fichiers journaux stderr contient une seule colonne avec les données des événements de journal. En ajoutant csvlog au log_destination paramètre, vous obtenez le fichier journal au CSV format avec des démarcations pour les multiples colonnes de la table étrangère. Vous pouvez désormais trier et analyser vos journaux plus facilement. Pour savoir comment utiliser log_fdw avec csvlog, consultez Utilisation de l'extension log_fdw pour accéder au journal de base de données en utilisant SQL.

Si vous spécifiez csvlog pour ce paramètre, sachez que les deux fichiers stderr et csvlog sont générés. Assurez-vous de surveiller le stockage consommé par les journaux, en tenant compte de rds.log_retention_period et des autres paramètres qui affectent le stockage et la rotation des journaux. Utiliser stderr et csvlog fait plus que doubler le stockage consommé par les journaux.

Si vous ajoutez csvlog à log_destination et que vous souhaitez revenir au paramètre stderr seul, vous devez réinitialiser le paramètre. Choisissez le paramètre log_destination, choisissez Edit parameter (Modifier le paramètre), puis Reset (Réinitialiser).

Pour plus d'informations sur la configuration de la journalisation, consultez Travailler avec les SQL journaux Amazon RDS et Aurora Postgre : partie 1.

Compréhension du paramètre log_line_prefix

Le format du journal stderr précède chaque message du journal des détails spécifiés par le paramètre log_line_prefix, comme suit.

%t:%r:%u@%d:[%p]:t

Vous ne pouvez pas modifier ce paramètre. Chaque entrée de journal envoyée à stderr inclut les informations suivantes.

  • %t : heure de l'entrée du journal

  • %r : adresse de l'hôte distant

  • %u@%d : nom d'utilisateur @ nom de base de données

  • [%p] : ID de processus si disponible