Publication de journaux MySQL sur Amazon CloudWatch Logs

Vous pouvez configurer votre instance de base de données MySQL pour publier les données de journal dans un groupe de CloudWatch journaux dans Amazon Logs. Avec CloudWatch Logs, vous pouvez effectuer une analyse en temps réel des données du journal, puis les utiliser CloudWatch pour créer des alarmes et afficher des métriques. Vous pouvez utiliser CloudWatch les journaux pour stocker vos enregistrements de journal dans un espace de stockage hautement durable.

Amazon RDS publie chaque journal de base de données MySQL sous la forme d'un flux de base de données distinct dans le groupe de journaux. Par exemple, si vous configurez la fonction d'exportation de sorte à inclure le journal de requêtes lentes, les données de requêtes lentes sont stockées dans un flux de journal de requêtes lentes dans le groupe de journaux /aws/rds/instance/my_instance/slowquery.

Le journal d'erreurs est activé par défaut. Le tableau ci-dessous récapitule les conditions requises pour les autres journaux MySQL.

Log	Exigence
Journal d'audit	L'instance de base de données doit disposer d'un groupe d'options personnalisées avec l'option MARIADB_AUDIT_PLUGIN.
Journal général	L'instance de base de données doit disposer d'un groupe de paramètres personnalisés avec le paramètre general_log = 1 pour autoriser la journalisation générale.
Journal des requêtes lentes	L'instance de base de données doit disposer d'un groupe de paramètres personnalisés avec le paramètre slow_query_log = 1 pour autoriser la journalisation de requête lente.
Journal des erreurs d'authentification de base de données IAM	Vous devez activer le type de journal iam-db-auth-error pour une instance de base de données en créant ou en modifiant une instance de base de données.
Sortie de journal	L'instance de base de données doit utiliser un groupe de paramètres personnalisé avec le paramètre défini log_output = FILE pour écrire des journaux dans le système de fichiers et les publier dans CloudWatch Logs.

console

Pour publier les journaux MySQL dans CloudWatch Logs à l'aide de la console

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

2. Dans le panneau de navigation, choisissez Bases de données, puis l'instance de base de données que vous souhaitez modifier.

3. Sélectionnez Modify (Modifier).

4. Dans la section Exportations de journaux, choisissez les journaux que vous souhaitez commencer à publier dans CloudWatch Logs.

5. Choisissez Continuer, puis Modifier l'instance de base de données sur la page récapitulative.

console

Pour publier les journaux MySQL dans CloudWatch Logs à l'aide de la console

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

2. Dans le panneau de navigation, choisissez Bases de données, puis l'instance de base de données que vous souhaitez modifier.

3. Sélectionnez Modify (Modifier).

4. Dans la section Exportations de journaux, choisissez les journaux que vous souhaitez commencer à publier dans CloudWatch Logs.

5. Choisissez Continuer, puis Modifier l'instance de base de données sur la page récapitulative.

AWS CLI

Vous pouvez publier des journaux MySQL avec le AWS CLI. Vous pouvez appeler la commande modify-db-instance avec les paramètres suivants :

• --db-instance-identifier

• --cloudwatch-logs-export-configuration

Note

Une modification apportée à l'option --cloudwatch-logs-export-configuration est toujours appliquée immédiatement à l'instance de base de données. Par conséquent, les options --apply-immediately et --no-apply-immediately sont sans effet.

Vous pouvez également publier des journaux MySQL en appelant les AWS CLI commandes suivantes :

• create-db-instance

• restore-db-instance-from-db-snapshot

• restore-db-instance-from-s3

• restore-db-instance-to-point-in-time

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

• --db-instance-identifier

• --enable-cloudwatch-logs-exports

• --db-instance-class

• --engine

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

L'exemple suivant modifie une instance de base de données MySQL existante pour publier des fichiers CloudWatch journaux dans Logs. La valeur --cloudwatch-logs-export-configuration n'est pas un objet JSON. La clé pour cet objet est EnableLogTypes et sa valeur est un tableau de chaînes avec une combinaison quelconque de audit, error, general et slowquery.

Dans Linux, macOS, ou Unix:

aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit","error","general","slowquery"]}'
   

Dans Windows:

aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit","error","general","slowquery"]}'
				

L'exemple suivant crée une instance de base de données MySQL et publie des fichiers CloudWatch journaux dans Logs. La valeur --enable-cloudwatch-logs-exports est un tableau de chaînes JSON. Les chaînes peuvent être une combinaison de audit, error, general et slowquery.

Dans Linux, macOS, ou Unix:

aws rds create-db-instance \
    --db-instance-identifier mydbinstance \
    --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' \
    --db-instance-class db.m4.large \
    --engine MySQL 
    			

Dans Windows:

aws rds create-db-instance ^
    --db-instance-identifier mydbinstance ^
    --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' ^
    --db-instance-class db.m4.large ^
    --engine MySQL
    			

AWS CLI

Vous pouvez publier des journaux MySQL avec le AWS CLI. Vous pouvez appeler la commande modify-db-instance avec les paramètres suivants :

• --db-instance-identifier

• --cloudwatch-logs-export-configuration

Note

Une modification apportée à l'option --cloudwatch-logs-export-configuration est toujours appliquée immédiatement à l'instance de base de données. Par conséquent, les options --apply-immediately et --no-apply-immediately sont sans effet.

Vous pouvez également publier des journaux MySQL en appelant les AWS CLI commandes suivantes :

• create-db-instance

• restore-db-instance-from-db-snapshot

• restore-db-instance-from-s3

• restore-db-instance-to-point-in-time

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

• --db-instance-identifier

• --enable-cloudwatch-logs-exports

• --db-instance-class

• --engine

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

L'exemple suivant modifie une instance de base de données MySQL existante pour publier des fichiers CloudWatch journaux dans Logs. La valeur --cloudwatch-logs-export-configuration n'est pas un objet JSON. La clé pour cet objet est EnableLogTypes et sa valeur est un tableau de chaînes avec une combinaison quelconque de audit, error, general et slowquery.

Dans Linux, macOS, ou Unix:

aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit","error","general","slowquery"]}'
   

Dans Windows:

aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --cloudwatch-logs-export-configuration '{"EnableLogTypes":["audit","error","general","slowquery"]}'
				

L'exemple suivant crée une instance de base de données MySQL et publie des fichiers CloudWatch journaux dans Logs. La valeur --enable-cloudwatch-logs-exports est un tableau de chaînes JSON. Les chaînes peuvent être une combinaison de audit, error, general et slowquery.

Dans Linux, macOS, ou Unix:

aws rds create-db-instance \
    --db-instance-identifier mydbinstance \
    --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' \
    --db-instance-class db.m4.large \
    --engine MySQL 
    			

Dans Windows:

aws rds create-db-instance ^
    --db-instance-identifier mydbinstance ^
    --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' ^
    --db-instance-class db.m4.large ^
    --engine MySQL
    			

API RDS

Vous pouvez publier des journaux MySQL avec l'API RDS. Vous pouvez appeler l'action ModifyDBInstance avec les paramètres suivants :

• DBInstanceIdentifier

• CloudwatchLogsExportConfiguration

Note

Une modification apportée au paramètre CloudwatchLogsExportConfiguration est toujours appliquée immédiatement à l'instance de base de données. Par conséquent, le paramètre ApplyImmediately est sans effet.

Vous pouvez également publier des journaux MySQL en appelant les opérations d'API RDS suivantes :

• CreateDBInstance

• RestoreDBInstanceFromDBSnapshot

• RestoreDBInstanceFromS3

• RestoreDBInstanceToPointInTime

Exécutez l'une de ces opérations d'API RDS avec les paramètres suivants :

• DBInstanceIdentifier

• EnableCloudwatchLogsExports

• Engine

• DBInstanceClass

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

API RDS

Vous pouvez publier des journaux MySQL avec l'API RDS. Vous pouvez appeler l'action ModifyDBInstance avec les paramètres suivants :

• DBInstanceIdentifier

• CloudwatchLogsExportConfiguration

Note

Une modification apportée au paramètre CloudwatchLogsExportConfiguration est toujours appliquée immédiatement à l'instance de base de données. Par conséquent, le paramètre ApplyImmediately est sans effet.

Vous pouvez également publier des journaux MySQL en appelant les opérations d'API RDS suivantes :

• CreateDBInstance

• RestoreDBInstanceFromDBSnapshot

• RestoreDBInstanceFromS3

• RestoreDBInstanceToPointInTime

Exécutez l'une de ces opérations d'API RDS avec les paramètres suivants :

• DBInstanceIdentifier

• EnableCloudwatchLogsExports

• Engine

• DBInstanceClass

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