Tutoriel : Accéder aux logs depuis un bucket

Après vous être accordé l’accès en lecture, vous pouvez récupérer les logs d’audit et d’infrastructure de votre cluster directement depuis le bucket OOS où ils sont stockés. Ces buckets contiennent des fichiers logs horodatés qui enregistrent toute activité via l’API Kubernetes et tout évènement lié à l’infrastructure pour votre cluster.

Ce tutoriel explique comment accéder au bucket OOS et télécharger les fichiers logs avec des commandes compatibles s3. Vous apprendrez d’abord commment lister les logs disponibles dans votre bucket, puis comment télécharger un fichier log précis vers votre environnement local.

Accéder aux logs depuis votre bucket OOS

La procédure ci-dessous décrit comment lister les fichiers logs disponibles dans votre bucket OOS et télécharger un log précis vers votre environnement local.

Avant de commencer : Assurez-vous d’avoir :

Lister les logs disponibles dans votre bucket OOS

Pour télécharger un fichier log, vous devez d’abord déterminer sa clé exacte en listant le contenu du bucket contenant vos logs d’audit ou d’infrastructure. Pour ce faire, vous pouvez utiliser n’importe quelle commande compatible s3. Pour en savoir plus, voir Lister les objets d’un bucket.

Lister les logs disponibles dans votre Bucket OOS avec s3

Utilisez la commande ls pour lister les logs disponibles dans votre bucket :

Exemple de requête
$ aws s3 ls s3://YOUR_BUCKET \
    --endpoint https://oos.eu-west-2.outscale.com

La commande ls renvoie une liste d’objets avec leur clé.

Lister les logs disponibles dans votre Bucket OOS avec s3api

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Utilisez la commande list-objects-v2 pour lister les logs disponibles dans votre bucket :

Exemple de requête
$ aws s3api list-objects-v2 \
    --bucket YOUR_BUCKET \
    --endpoint https://oos.eu-west-2.outscale.com

La commande list-objects-v2 renvoie une liste d’objets avec leur clé.

Télécharger votre fichier log

Une fois que votre ID de compte OUTSCALE est ajouté à la section readers de la ressource OOSAccess, ce compte obtient automatiquement un accès read-only aux buckets OOS contenant les logs de votre cluster. Vous pouvez ensuite récupérer ces logs directement depuis vos buckets OOS à l’aide de commandes compatibles s3. Pour en savoir plus, voir Télécharger un objet depuis un bucket.

Télécharger votre fichier log avec s3

Pour télécharger votre fichier log depuis un bucket, utilisez la commande cp en suivant cette syntaxe :

Exemple de requête
$ aws s3 cp s3://YOUR_BUCKET/YOUR_OBJECT PATH/TO/FILE \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les options suivantes que vous devez spécifier :

  • s3://YOUR_BUCKET/YOUR_OBJECT: Le nom du bucket contenant les logs d’audit et d’infrastructure du cluster et le nom du fichier log que vous voulez télécharger.

  • PATH/TO/FILE: le chemin pointant vers l’endroit où vous voulez télécharger l’objet.

  • endpoint: L’endpoint OOS correspondant à la Région de votre cluster.

Télécharger votre fichier log avec s3api

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Utilisez la commande get-object pour télécharger votre fichier log depuis le bucket OOS :

Exemple de requête
$ aws s3api get-object \
    --bucket YOUR_BUCKET \
    --key OBJECT \
    outfile=<~/home/Name_Of_The_Downloaded_Object> \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les options suivantes que vous devez spécifier :

  • bucket: Le nom du bucket contenant les logs d’audit et d’infrastructure du cluster.

  • key: le nom du fichier log que vous voulez télécharger.

  • outfile: le nom du fichier log, une fois téléchargé en local. Ce nom peut être un chemin.

  • endpoint: L’endpoint OOS correspondant à la Région de votre cluster.

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.