Amazon Relational Database Service
Guide de l'utilisateur

Fichiers journaux de base de données Amazon RDS

Vous pouvez afficher, télécharger et consulter les journaux de base de données à l'aide de la console Amazon RDS, 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 consulter les fichiers journaux de base de données pour votre moteur de base de données à l'aide de la console Amazon RDS. 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.

Console

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.

AWS CLI

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
API RDS

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 la console Amazon RDS, l'AWS CLI ou l'API pour télécharger un fichier journal de base de données.

Console

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
AWS CLI

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, OS X 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
API RDS

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 contrôler le contenu d'un fichier journal à l'aide de la console Amazon RDS.

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

En plus de l'affichage et du téléchargement de journaux d'instance de base de données, vous pouvez publier des journaux vers Amazon CloudWatch Logs. CloudWatch Logs vous 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 plus d'informations, consultez Modification de la rétention 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)