Amazon RDS Fichiers journaux de base de données - Amazon Relational Database Service

Amazon RDS Fichiers journaux de base de données

Vous pouvez afficher, télécharger et consulter les journaux de base de données à l'aide d’AWS Management Console, de l'AWS Command Line Interface (AWS CLI) ou de l'API Amazon RDS. L'affichage, le téléchargement ou la consultation des journaux de transactions ne sont pas pris en charge.

Pour accéder aux informations spécifiques à chaque moteur de base de données, consultez le tableau suivant :

Liste et affichage des fichiers journaux de base de données

Vous pouvez afficher les fichiers journaux de base de données pour votre moteur de base de données à l'aide d’AWS Management Console. Vous pouvez répertorier les fichiers journaux disponibles pour téléchargement ou surveillance à l'aide de l'AWS CLI ou de l'API Amazon RDS.

Note

Si vous ne parvenez pas à afficher la liste des fichiers journaux pour une instance de base de données Oracle existante, redémarrez l'instance.

Pour afficher un fichier journal de base de données

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

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

  3. Choisissez le nom de l'instance de base de données qui contient le fichier journal que vous voulez consulter.

  4. Choisissez l'onglet Logs & events (Journaux et événements).

  5. Faites défiler jusqu'à la section Journaux.

  6. Dans la section Journaux, choisissez le journal que vous souhaitez afficher, puis choisissez Afficher.

Pour répertorier les fichiers journaux de base de données disponibles pour une instance de base de données, utilisez la commande describe-db-log-files de l'AWS CLI.

L'exemple suivant renvoie une liste des fichiers journaux pour une instance DB nommée my-db-instance.

Exemple

aws rds describe-db-log-files --db-instance-identifier my-db-instance

Pour répertorier les fichiers journaux de base de données disponibles pour une instance de base de données, utilisez l'action DescribeDBLogFiles de l'API Amazon RDS.

Téléchargement d'un fichier journal de base de données

Vous pouvez utiliser AWS Management Console, l'AWS CLI ou l'API pour télécharger un fichier journal de base de données.

Pour télécharger un fichier journal de base de données

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

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

  3. Choisissez le nom de l'instance de base de données qui contient le fichier journal que vous voulez consulter.

  4. Choisissez l'onglet Logs & events (Journaux et événements).

  5. Faites défiler jusqu'à la section Journaux.

  6. Dans la section Journaux, sélectionnez le bouton en regard du journal que vous voulez télécharger, puis choisissez Télécharger.

  7. Ouvrez le menu contextuel (clic droit) pour le lien fourni, puis choisissez Enregistrer le lien sous. Saisissez l'emplacement souhaité pour l'enregistrement du fichier journal, puis cliquez sur Enregistrer.

    
								affichage du fichier journal

Pour télécharger un fichier journal de base de données, utilisez la commande download-db-log-file-portion de l'AWS CLI. Par défaut, cette commande télécharge uniquement la portion la plus récente d'un fichier journal. Vous pouvez toutefois télécharger un fichier complet en spécifiant le paramètre --starting-token 0.

L'exemple suivant montre comment télécharger le contenu d'un fichier journal appelé log/ERROR.4 et le stocker dans un fichier local appelé errorlog.txt.

Exemple

Pour Linux, macOS ou Unix :

aws rds download-db-log-file-portion \ --db-instance-identifier myexampledb \ --starting-token 0 --output text \ --log-file-name log/ERROR.4 > errorlog.txt

Pour Windows :

aws rds download-db-log-file-portion ^ --db-instance-identifier myexampledb ^ --starting-token 0 --output text ^ --log-file-name log/ERROR.4 > errorlog.txt

Pour télécharger un fichier journal de base de données, utilisez l'action DownloadDBLogFilePortion de l'API Amazon RDS.

Consultation d'un fichier journal de base de données

Vous pouvez surveiller le contenu d'un fichier journal à l'aide d’AWS Management Console.

Console

Pour consulter un fichier journal de base de données

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

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

  3. Choisissez le nom de l'instance de base de données qui contient le fichier journal que vous voulez consulter.

  4. Choisissez l'onglet Logs & events (Journaux et événements).

  5. Dans la section Journaux, choisissez un fichier journal, puis Consulter.

Publication des journaux de base de données dans Amazon CloudWatch Logs

Outre l'affichage et le téléchargement des journaux d'instance de base de données, vous pouvez publier des journaux dans Amazon CloudWatch Logs. CloudWatch Logs permet d'effectuer une analyse en temps réel des données de journaux, de stocker les données dans un stockage hautement durable et de gérer les données grâce à l'agent CloudWatch Logs. AWS conserve les données de journaux publiées dans CloudWatch Logs pendant une période indéterminée, sauf si vous précisez une durée de conservation. Pour de plus amples informations, veuillez consulter Modification de la conservation des données de journaux dans CloudWatch Logs.

Pour accéder aux informations spécifiques à chaque moteur de base de données, consultez le tableau suivant :

Lecture du contenu des fichiers journaux avec REST

Amazon RDS fournit un point de terminaison REST qui permet d'accéder aux fichiers journaux des instances de base de données. Ceci est utile si vous devez écrire une application pour diffuser en continu le contenu de fichiers journaux Amazon RDS.

La syntaxe est la suivante :

GET /v13/downloadCompleteLogFile/DBInstanceIdentifier/LogFileName HTTP/1.1 Content-type: application/json host: rds.region.amazonaws.com

Les paramètres suivants sont obligatoires :

  • DBInstanceIdentifier—le nom assigné par le client de l'instance de base de données qui contient le fichier journal que vous souhaitez télécharger.

  • LogFileName—le nom du fichier journal à télécharger.

La réponse contient les contenus du fichier journal demandé, en tant que flux.

L'exemple suivant télécharge le fichier journal appelé log/ERROR.6 pour l'instance de base de données appelée sample-sql dans la région us-west-2.

GET /v13/downloadCompleteLogFile/sample-sql/log/ERROR.6 HTTP/1.1 host: rds.us-west-2.amazonaws.com X-Amz-Security-Token: AQoDYXdzEIH//////////wEa0AIXLhngC5zp9CyB1R6abwKrXHVR5efnAVN3XvR7IwqKYalFSn6UyJuEFTft9nObglx4QJ+GXV9cpACkETq= X-Amz-Date: 20140903T233749Z X-Amz-Algorithm: AWS4-HMAC-SHA256 X-Amz-Credential: AKIADQKE4SARGYLE/20140903/us-west-2/rds/aws4_request X-Amz-SignedHeaders: host X-Amz-Content-SHA256: e3b0c44298fc1c229afbf4c8996fb92427ae41e4649b934de495991b7852b855 X-Amz-Expires: 86400 X-Amz-Signature: 353a4f14b3f250142d9afc34f9f9948154d46ce7d4ec091d0cdabbcf8b40c558

Si vous spécifiez une instance de base de données qui n'existe pas, la réponse se compose de l'erreur suivante :

  • DBInstanceNotFoundDBInstanceIdentifier ne fait pas référence à une instance de base de données existante. (HTTP status code: 404)