18.10. Didacticiel: Logging
Il existe différentes méthodes pour afficher vos journaux dans Red Hat OpenShift Service sur AWS (ROSA). Les procédures suivantes permettent de transmettre les journaux à AWS CloudWatch et de visualiser les journaux directement via le pod en utilisant les journaux oc.
La ROSA n’est pas préconfigurée avec une solution de journalisation.
18.10.1. Envoi de journaux vers CloudWatch Copier lienLien copié sur presse-papiers!
Installez le service d’extension de journalisation pour transférer les journaux à AWS CloudWatch.
Exécutez le script suivant pour configurer votre cluster ROSA pour transférer les journaux vers CloudWatch:
$ curl https://raw.githubusercontent.com/openshift-cs/rosaworkshop/master/rosa-workshop/ostoy/resources/configure-cloudwatch.sh | bashNoteConfigurer ROSA pour envoyer des journaux à CloudWatch va au-delà du cadre de ce tutoriel. L’intégration à AWS et l’activation de la journalisation CloudWatch sont des aspects importants de ROSA, de sorte qu’un script est inclus pour simplifier le processus de configuration. Le script configurera automatiquement AWS CloudWatch. Il est possible d’examiner le script pour comprendre les étapes impliquées.
Exemple de sortie
Varaibles are set...ok. Policy already exists...ok. Created RosaCloudWatch-mycluster role. Attached role policy. Deploying the Red Hat OpenShift Logging Operator namespace/openshift-logging configured operatorgroup.operators.coreos.com/cluster-logging created subscription.operators.coreos.com/cluster-logging created Waiting for Red Hat OpenShift Logging Operator deployment to complete... Red Hat OpenShift Logging Operator deployed. secret/cloudwatch-credentials created clusterlogforwarder.logging.openshift.io/instance created clusterlogging.logging.openshift.io/instance created Complete.Après quelques minutes, vous devriez commencer à voir les groupes de journaux à l’intérieur d’AWS CloudWatch. Exécutez la commande suivante pour voir les groupes de journaux:
$ aws logs describe-log-groups --log-group-name-prefix rosa-myclusterExemple de sortie
{ "logGroups": [ { "logGroupName": "rosa-mycluster.application", "creationTime": 1724104537717, "metricFilterCount": 0, "arn": "arn:aws:logs:us-west-2:000000000000:log-group:rosa-mycluster.application:*", "storedBytes": 0, "logGroupClass": "STANDARD", "logGroupArn": "arn:aws:logs:us-west-2:000000000000:log-group:rosa-mycluster.application" }, { "logGroupName": "rosa-mycluster.audit", "creationTime": 1724104152968, "metricFilterCount": 0, "arn": "arn:aws:logs:us-west-2:000000000000:log-group:rosa-mycluster.audit:*", "storedBytes": 0, "logGroupClass": "STANDARD", "logGroupArn": "arn:aws:logs:us-west-2:000000000000:log-group:rosa-mycluster.audit" },
18.10.2. La sortie des données dans les flux et les journaux Copier lienLien copié sur presse-papiers!
Envoyez un message à stdout.
- Dans l’application OSToy, cliquez sur Accueil, puis cliquez sur la zone de message pour Log Message (stdout).
- Écrivez un message à la sortie sur le flux stdout, par exemple "Tout va bien!".
Cliquez sur Envoyer un message.
Envoyez un message à stderr.
- Cliquez sur la zone de message pour Log Message (stderr).
- Écrivez un message à la sortie sur le flux stderr, par exemple "Oh non! Erreur ! ».
Cliquez sur Envoyer un message.
18.10.3. Affichage des journaux de l’application à l’aide de la commande oc Copier lienLien copié sur presse-papiers!
Entrez la commande suivante dans l’interface de ligne de commande (CLI) pour récupérer le nom de votre pod frontend:
$ oc get pods -o nameExemple de sortie
pod/ostoy-frontend-679cb85695-5cn7x1 pod/ostoy-microservice-86b4c6f559-p594d- 1
- Le nom du pod est ostoy-frontend-679cb85695-5cn7x.
Exécutez la commande suivante pour voir les messages stdout et stderr:
$ oc logs <pod-name>Exemple de sortie
$ oc logs ostoy-frontend-679cb85695-5cn7x [...] ostoy-frontend-679cb85695-5cn7x: server starting on port 8080 Redirecting to /home stdout: All is well! stderr: Oh no! Error!
18.10.4. Affichage des journaux avec CloudWatch Copier lienLien copié sur presse-papiers!
- Accédez à CloudWatch sur la console web AWS.
Dans le menu de gauche, cliquez sur Logs, puis Log Groups pour voir les différents groupes de journaux. Il faut voir 3 groupes:
-
ajouter au panier Rosa-<cluster-name>.application -
> Rosa-<cluster-name>.audit caractéristiques de Rosa-<cluster-name>.infrastructure
-
- Cliquez sur rosa-<cluster-name>.application.
Cliquez sur le flux de journal pour le pod frontend.
- Filtre pour stdout et stderr.
Développez la ligne pour afficher les messages que vous avez saisis plus tôt et d’autres informations pertinentes.
- Entrez dans les flux de journaux et sélectionnez le microservice.
- Entrez "microservice" dans la barre de recherche pour voir d’autres messages dans vos journaux.
Développez l’une des entrées pour voir la couleur de la gousse frontale reçue du microservice et quel pod a envoyé cette couleur à la gousse frontale.