Publication des journaux Aurora PostgreSQL sur Amazon Logs CloudWatch - Amazon Aurora
Activer l'option de publication des journaux sur Amazon CloudWatchSurveillance des événements du journal sur Amazon CloudWatchAnalyse des journaux PostgreSQL à l'aide de Logs Insights CloudWatch

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.

Publication des journaux Aurora PostgreSQL sur Amazon Logs CloudWatch

Vous pouvez configurer votre cluster de base de données Aurora PostgreSQL pour exporter régulièrement les données des journaux vers CloudWatch Amazon Logs. Dans ce cas, les événements du journal PostgreSQL de votre cluster de bases de données Aurora PostgreSQL sont automatiquement publiés sur Amazon, sous le nom d'Amazon Logs. CloudWatch CloudWatch Dans CloudWatch, vous pouvez trouver les données de journal exportées dans un groupe de journaux pour votre cluster de base de données Aurora PostgreSQL. Le groupe de journaux contient un ou plusieurs flux de journaux qui contiennent les événements du journal PostgreSQL de chaque instance du cluster.

La publication des journaux dans CloudWatch Logs vous permet de conserver les enregistrements des journaux PostgreSQL de votre cluster dans un espace de stockage hautement durable. Grâce aux données de journal disponibles dans CloudWatch Logs, vous pouvez évaluer et améliorer les opérations de votre cluster. Vous pouvez également l'utiliser CloudWatch pour créer des alarmes et afficher les métriques. Pour en savoir plus, veuillez consulter la section Surveillance des événements du journal sur Amazon CloudWatch.

Note

La publication de vos journaux PostgreSQL dans Logs consomme de l'espace CloudWatch de stockage, et vous devez payer des frais pour ce stockage. Assurez-vous de supprimer tous les CloudWatch journaux dont vous n'avez plus besoin.

La désactivation de l'option d'exportation du journal pour un cluster de base de données Aurora PostgreSQL existant n'affecte aucune donnée déjà contenue dans les journaux. CloudWatch Les journaux existants restent disponibles dans CloudWatch Logs en fonction de vos paramètres de conservation des journaux. Pour en savoir plus sur CloudWatch les journaux, consultez Qu'est-ce qu'Amazon CloudWatch Logs ?

Aurora PostgreSQL prend en charge la publication de journaux dans Logs pour CloudWatch les versions suivantes.

  • Versions 14.3 et 14 ultérieures

  • Versions 13.3 et 13 ultérieures

  • Versions 12.8 et 12 ultérieures

  • 11.12 et versions 11 ultérieures

Activer l'option de publication des journaux sur Amazon CloudWatch

Pour publier le journal PostgreSQL de votre cluster de bases de données Aurora PostgreSQL dans Logs, choisissez l'option d'exportation du journal CloudWatch pour le cluster. Vous pouvez choisir le paramètre d'exportation du journal lorsque vous créez votre cluster de base de données Aurora PostgreSQL. Ou bien, vous pouvez modifier le cluster ultérieurement. Lorsque vous modifiez un cluster existant, les journaux PostgreSQL de chaque instance sont publiés sur le cluster CloudWatch à partir de ce moment. Pour Aurora PostgreSQL, le journal PostgreSQL postgresql.log () est le seul journal publié sur Amazon. CloudWatch

Vous pouvez utiliser la AWS Management Console, AWS CLI, ou l'API RDS pour activer la fonction d'exportation de journaux pour votre cluster de base de données Aurora PostgreSQL.

Vous choisissez l'option Log exports pour commencer à publier les journaux PostgreSQL de votre cluster de base de données Aurora PostgreSQL vers Logs. CloudWatch

Pour activer la fonction d'exportation des journaux à partir de la console

  1. Ouvrez la console Amazon RDS à l’adresse https://console.aws.amazon.com/rds/.

  2. Dans le panneau de navigation, choisissez Databases (Bases de données).

  3. Choisissez le cluster de base de données Aurora PostgreSQL dont vous souhaitez publier les données de journal dans Logs. CloudWatch

  4. Sélectionnez Modify.

  5. Dans la section Log exports (Exportations des journaux), choisissez PostgreSQL log (Journal Postgresql).

  6. Choisissez Continuer, puis Modifier le cluster sur la page récapitulative.

Vous pouvez activer l'option d'exportation des journaux pour commencer à publier les journaux Aurora PostgreSQL sur CloudWatch Amazon Logs avec le. AWS CLI Pour ce faire, exécutez la modify-db-clusterAWS CLIcommande avec les options suivantes :

  • --db-cluster-identifier — Identifiant du cluster de bases de données.

  • --cloudwatch-logs-export-configuration: paramètre de configuration pour les types de journaux à définir pour l'exportation vers CloudWatch Logs for the DB cluster.

Vous pouvez également publier des journaux Aurora PostgreSQL en exécutant l'une des commandes de l'AWS CLI suivantes :

Exécutez l'une de ces commandes de l'AWS CLI avec les options suivantes :

  • --db-cluster-identifier — Identifiant du cluster de bases de données.

  • --engine — Moteur de base de données.

  • --enable-cloudwatch-logs-exports: paramètre de configuration des types de journaux à activer pour l'exportation vers les CloudWatch journaux du cluster de base de données.

D'autres options peuvent être requises en fonction de la commande d'AWS CLI que vous exécutez.

La commande suivante crée un cluster de base de données Aurora PostgreSQL pour publier les fichiers journaux dans Logs. CloudWatch

Pour LinuxmacOS, ou Unix :

aws rds create-db-cluster \
    --db-cluster-identifier my-db-cluster \
    --engine aurora-postgresql \
    --enable-cloudwatch-logs-exports postgresql

Dans Windows :

aws rds create-db-cluster ^
    --db-cluster-identifier my-db-cluster ^
    --engine aurora-postgresql ^
    --enable-cloudwatch-logs-exports postgresql

La commande suivante modifie un cluster de base de données Aurora PostgreSQL existant pour publier les fichiers journaux dans Logs. CloudWatch La valeur --cloudwatch-logs-export-configuration n'est pas un objet JSON. La clé de cet objet est EnableLogTypes, et sa valeur est postgresql.

Pour LinuxmacOS, ou Unix :

aws rds modify-db-cluster \
    --db-cluster-identifier my-db-cluster \
    --cloudwatch-logs-export-configuration '{"EnableLogTypes":["postgresql"]}'

Dans Windows :

aws rds modify-db-cluster ^
    --db-cluster-identifier my-db-cluster ^
    --cloudwatch-logs-export-configuration '{\"EnableLogTypes\":[\"postgresql\"]}'
Note

Lorsque vous utilisez l'invite de commande Windows, villez à utiliser des guillemets doubles (") d'échappement dans le code JSON en les préfixant d'une barre oblique inverse (\).

L'exemple suivant modifie un cluster de base de données Aurora PostgreSQL existant pour désactiver la publication de fichiers journaux dans Logs. CloudWatch La valeur --cloudwatch-logs-export-configuration n'est pas un objet JSON. La clé de cet objet est DisableLogTypes, et sa valeur est postgresql.

Pour LinuxmacOS, ou Unix :

aws rds modify-db-cluster \
    --db-cluster-identifier mydbinstance \
    --cloudwatch-logs-export-configuration '{"DisableLogTypes":["postgresql"]}'

Dans Windows :

aws rds modify-db-cluster ^
    --db-cluster-identifier mydbinstance ^
    --cloudwatch-logs-export-configuration "{\"DisableLogTypes\":[\"postgresql\"]}"
Note

Lorsque vous utilisez l'invite de commandes Windows, vous devez utiliser des guillemets doubles (") d'échappement dans le code JSON en les préfixant d'une barre oblique inverse (\).

Vous pouvez activer l'option d'exportation des journaux pour commencer à publier les journaux d'Aurora PostgreSQL avec l'API RDS. Pour cela, exécutez l'opération ModifyDBCluster avec les options suivantes :

  • DBClusterIdentifier — Identifiant du cluster de bases de données.

  • CloudwatchLogsExportConfiguration— Le paramètre de configuration des types de journaux à activer pour l'exportation vers les CloudWatch journaux pour le cluster de base de données.

Vous pouvez également publier des journaux Aurora PostgreSQL avec l'API RDS en exécutant l'une des opérations d'API RDS suivantes :

Exécutez l'action de l'API RDS avec les paramètres suivants :

  • DBClusterIdentifier — Identifiant du cluster de bases de données.

  • Engine — Moteur de base de données.

  • EnableCloudwatchLogsExports: paramètre de configuration des types de journaux à activer pour l'exportation vers les CloudWatch journaux du cluster de base de données.

D'autres paramètres peuvent être requis en fonction de la commande d'AWS CLI que vous exécutez.

Surveillance des événements du journal sur Amazon CloudWatch

Avec les événements du journal Aurora PostgreSQL publiés et disponibles sous le nom d' CloudWatch Amazon Logs, vous pouvez consulter et surveiller les événements à l'aide d'Amazon. CloudWatch Pour plus d'informations sur la surveillance, voir Afficher les données de journal envoyées à CloudWatch Logs.

Lorsque vous activez les exportations de journaux, un nouveau groupe de journaux est automatiquement créé en utilisant le préfixe /aws/rds/cluster/ avec le nom de votre Aurora PostgreSQL et le type de journal, comme dans le modèle suivant. 

/aws/rds/cluster/your-cluster-name/postgresql

Par exemple, supposons qu'un cluster de base de données Aurora PostgreSQL docs-lab-apg-small nommé exporte son journal vers Amazon Logs. CloudWatch Le nom de son groupe de journaux dans Amazon CloudWatch est indiqué ci-dessous.

/aws/rds/cluster/docs-lab-apg-small/postgresql

Si un groupe de journaux de ce nom existe déjà, Aurora l'utilise pour exporter les données de journaux du cluster de bases de données Aurora. Chaque instance de base de données dans le cluster de base de données Aurora PostgreSQL charge son journal PostgreSQL dans le groupe de journaux en tant que flux de journaux distinct. Vous pouvez examiner le groupe de journaux et ses flux de journaux à l'aide des différents outils graphiques et analytiques disponibles sur Amazon CloudWatch.

Par exemple, vous pouvez rechercher des informations dans les événements du journal de votre cluster de base de données Aurora PostgreSQL et filtrer les événements à l'aide de la console Logs, de l' CloudWatch API Logs ou CloudWatch de AWS CLI l'API Logs. Pour plus d'informations, consultez la section Recherche et filtrage des données de journal dans le guide de l'utilisateur Amazon CloudWatch Logs.

Par défaut, les nouveaux groupes de journaux sont créés en utilisant l'option Never expire (Ne jamais expirer) pour leur période de conservation. Vous pouvez utiliser la console CloudWatch LogsAWS CLI, ou l'API CloudWatch Logs pour modifier la période de conservation des journaux. Pour en savoir plus, consultez la section Conservation des données du journal des modifications dans CloudWatch Logs du guide de l'utilisateur Amazon CloudWatch Logs.

Astuce

Vous pouvez utiliser une configuration automatique, telle que AWS CloudFormation, pour créer des groupes de journaux avec des périodes de rétention de journaux, des filtres de métriques et des autorisations d'accès personnalisés.

Analyse des journaux PostgreSQL à l'aide de Logs Insights CloudWatch

Les journaux PostgreSQL de votre cluster de base de données Aurora PostgreSQL CloudWatch étant publiés sous forme de journaux, vous pouvez CloudWatch utiliser Logs Insights pour rechercher et analyser de manière interactive les données de vos journaux dans Amazon Logs. CloudWatch CloudWatch Logs Insights inclut un langage de requête, des exemples de requêtes et d'autres outils pour analyser les données de vos journaux afin que vous puissiez identifier les problèmes potentiels et vérifier les correctifs. Pour en savoir plus, consultez Analyser les données des CloudWatch journaux avec Logs Insights dans le guide de l'utilisateur Amazon CloudWatch Logs. Amazon CloudWatch Logs

Pour analyser les journaux PostgreSQL avec Logs Insights CloudWatch

  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de navigation, ouvrez Logs (Journaux) et choisissez Log Insights.

  3. Dans Select log group(s) (Sélectionner des groupes de journaux), sélectionnez le groupe de journaux pour votre cluster de base de données Aurora PostgreSQL.

    Choisissez le groupe de journaux Aurora PostgreSQL.

  4. Dans l'éditeur de requête, supprimez la requête affichée, saisissez les informations suivantes, puis choisissez Run query (Exécuter la requête).

    ##Autovacuum execution time in seconds per 5 minute
fields @message
| parse @message "elapsed: * s" as @duration_sec
| filter @message like / automatic vacuum /
| display @duration_sec
| sort @timestamp
| stats avg(@duration_sec) as avg_duration_sec, 
max(@duration_sec) as max_duration_sec 
by bin(5 min)
    Exécutez une requête dans l'éditeur de requête.

  5. Choisissez l'onglet Visualisation.

    Onglet Visualization (Visualisation).

  6. Choisissez Add to dashboard (Ajouter au tableau de bord).

  7. Dans Select a dashboard (Sélectionner un tableau de bord), sélectionnez un tableau de bord ou saisissez un nom pour créer un tableau de bord.

  8. Dans Widget type (Type de widget), choisissez un type de widget pour votre visualisation.

    Tableau de bord

  9. (Facultatif) Ajoutez d'autres widgets en fonction des résultats de vos requêtes de journaux.

    1. Sélectionnez Add widget (Ajouter un widget).

    2. Choisissez un type de widget, tel que Line (Ligne).

      Choisissez un widget.

    3. Dans la fenêtre Add to this dashboard (Ajouter à ce tableau de bord), choisissez Logs (Journaux).

      Ajoutez des journaux au tableau de bord.

    4. Dans Select log group(s) (Sélectionner des groupes de journaux), sélectionnez le groupe de journaux pour votre cluster de bases de données.

    5. Dans l'éditeur de requête, supprimez la requête affichée, saisissez les informations suivantes, puis choisissez Run query (Exécuter la requête).

      ##Autovacuum tuples statistics per 5 min
fields @timestamp, @message
| parse @message "tuples: " as @tuples_temp
| parse @tuples_temp "* removed," as @tuples_removed
| parse @tuples_temp "remain, * are dead but not yet removable, " as @tuples_not_removable
| filter @message like / automatic vacuum /
| sort @timestamp
| stats  avg(@tuples_removed) as avg_tuples_removed, 
avg(@tuples_not_removable) as avg_tuples_not_removable 
by bin(5 min)
      Exécutez une requête dans l'éditeur de requête.

    6. Choisissez Create widget (Créer un widget).

      Votre tableau de bord doit ressembler à l'image suivante.

      Tableau de bord avec deux graphiques.