Comment enregistrer les logs

Lorsque vous créez un déploiement, votre conteneur génère des journaux. Vous pouvez enregistrer ces journaux dans un bucket S3 de votre choix une fois que vous avez terminé votre déploiement. En configurant un Endpoint Storage, vous pourrez récupérer ces journaux à tout moment, même après la terminaison du déploiement.

Liez votre Endpoint Storage à votre version d'application

Pour ce faire, vous devrez lier votre version d'application à votre Endpoint Storage. Accédez à la page de détails de la version de l'application, et recherchez le Stockage des journaux du conteneur section. Activez l'interrupteur et sélectionnez votre Endpoint Storage dans la zone de sélection.

Si vous activez le stockage des journaux du conteneur sans sélectionner un Endpoint Storage valide, vous ne pourrez pas récupérer vos journaux. Pour vous assurer d'avoir un Endpoint Storage valide, veuillez vous référer à la documentation d'installation.

C'est tout ! Chaque déploiement utilisant cette version de l'application stockera désormais les journaux du conteneur dans votre bucket S3.

Chemin de répertoire par défaut

Le chemin dans votre bucket S3 ressemblera à ceci.

• edgegap/arbitrium

• La première partie de l'e-mail de votre client, la plupart des navigateurs S3 n'aiment pas "@"

• Le nom de votre Endpoint Storage

• app / version app / container_log

• La date AAAA-MM-JJ

Vous pouvez créer plusieurs Endpoint Storage avec le même bucket S3 mais avec un nom différent. Ainsi, vous pourriez avoir divers répertoires pour de nombreux environnements si vous le souhaitez.

Cas d'utilisation supplémentaires

Ces cas d'utilisation peuvent être utiles lors des tests, lorsque vous ne souhaitez pas que tous les journaux de vos déploiements soient envoyés au stockage.

Enregistrer les journaux du conteneur avec votre requête de déploiement

Lorsque vous créez un déploiement, vous pouvez préciser si vous souhaitez stocker les journaux de votre conteneur avec votre requête de déploiement. Cela est indépendant des paramètres de la version de l'application, ce qui signifie qu'il n'est pas nécessaire d'avoir configuré auparavant l'Endpoint Storage avec votre version d'application, mais simplement d'avoir un Endpoint Storage fonctionnel.

Vous pouvez le faire en ajoutant le JSON suivant à votre requête de déploiement. Le endpoint_storage est le nom de votre Endpoint Storage.

{
  "container_log_storage": {
    "enabled": true,
    "endpoint_storage": "demo-bucket"
  }
}

Si le endpoint_storage n'est pas fourni, nous tenterons d'utiliser l'endpoint storage de la version de l'application. Si aucun endpoint storage n'est trouvé, les journaux du conteneur ne seront pas stockés.

Enregistrer les journaux du conteneur avec votre requête d'arrêt

Une autre manière pratique de l'utiliser est lors de la terminaison de votre déploiement. Si vous avez des raisons de croire que quelque chose s'est mal passé à l'intérieur de votre conteneur, vous pouvez demander à sauvegarder les journaux du conteneur. Cette option est disponible avec les routes d'arrêt de déploiement et d'arrêt manuel (Self stop).

Vous pouvez le faire en ajoutant le paramètre de requête container_log_storage à votre requête. Le paramètre container_log_storage est le nom de votre Endpoint Storage. Vous pouvez aussi mettre true pour utiliser l'endpoint storage de la version de l'application.

Vous pouvez consulter notre Documentation API pour plus de détails sur les paramètres des requêtes de déploiement et d'arrêt.