12.3. Journaux et outils de débogage

Procédure

1. Dans la console Web MTC, cliquez sur Migration Plans.
2. Cliquez sur le numéro Migrations en regard d’un plan de migration pour afficher la page Migrations.
3. Cliquez sur une migration pour en afficher les détails (Migration details).

4. Développez Migration resources pour afficher les ressources de migration et leur état dans une arborescence.

   Note

   Pour résoudre un échec de migration, commencez par une ressource de haut niveau qui a échoué, puis descendez dans l’arborescence vers les ressources de niveau inférieur.

5. Cliquez sur le menu Options à côté d'une ressource et sélectionnez l'une des options suivantes :

   • La commande Copy oc describe copie la commande dans votre presse-papiers.

     • Connectez-vous au cluster concerné, puis exécutez la commande.

       Les conditions et les événements de la ressource sont affichés au format YAML.

   • La commande Copy oc logs copie la commande dans votre presse-papiers.

     • Connectez-vous au cluster concerné, puis exécutez la commande.

       Si la ressource prend en charge le filtrage des journaux, un journal filtré est affiché.

   • View JSON affiche les données de la ressource au format JSON dans un navigateur Web.

     Les données sont les mêmes que celles de la sortie de la commande oc get <resource>.

Procédure

1. Dans la console Web MTC, cliquez sur Migration Plans.
2. Cliquez sur le numéro Migrations en regard d’un plan de migration.
3. Cliquez sur View logs.
4. Cliquez sur l’icône Copier pour copier la commande oc logs dans votre presse-papiers.

5. Connectez-vous au cluster concerné et saisissez la commande dans la CLI.

   Le journal agrégé relatif au plan de migration est affiché.

Procédure

1. Procurez-vous le pod mig-log-reader :

   $ oc -n openshift-migration get pods | grep log

   Copy to Clipboard Toggle word wrap

2. Saisissez la commande suivante pour afficher un seul journal de migration :

   $ oc -n openshift-migration logs -f <mig-log-reader-pod> -c color 

   1

   Copy to Clipboard Toggle word wrap

   1

   L’option -c plain affiche le journal sans couleurs.

Procédure

1. Dans la console Web OpenShift Container Platform, cliquez sur Observe Metrics.

2. Saisissez une requête PromQL, sélectionnez une fenêtre temporelle à afficher, puis cliquez sur Run Queries.

   Si votre navigateur Web n’affiche pas tous les résultats, utilisez la console Prometheus.

Procédure

1. Accédez au répertoire dans lequel vous souhaitez stocker les données must-gather.

2. Exécutez la commande oc adm must-gather pour l’une des options de collecte de données suivantes :

   • Pour collecter les données relatives à l’heure écoulée :

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.7

     Copy to Clipboard Toggle word wrap

     Les données sont enregistrées en tant que must-gather/must-gather.tar.gz. Vous pouvez envoyer ce fichier dans un dossier d’assistance sur le Portail Client de Red Hat.

   • Pour collecter les données des dernières 24 heures :

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.7 \
       -- /usr/bin/gather_metrics_dump

     Copy to Clipboard Toggle word wrap

     Cette opération peut prendre beaucoup de temps. Les données sont enregistrées sous le nom must-gather/metrics/prom_data.tar.gz.

Procédure

1. Décompressez le fichier prom_data.tar.gz :

   $ tar -xvzf must-gather/metrics/prom_data.tar.gz

   Copy to Clipboard Toggle word wrap

2. Créez une instance Prometheus locale :

   $ make prometheus-run

   Copy to Clipboard Toggle word wrap

   La commande produit l’URL Prometheus.

   Sortie

   Started Prometheus on http://localhost:9090

   Copy to Clipboard Toggle word wrap

3. Démarrez un navigateur Web et accédez à l’URL pour afficher les données à l’aide de la console Web Prometheus.

4. Après avoir consulté les données, supprimez l’instance Prometheus, ainsi que les données :

   $ make prometheus-cleanup

   Copy to Clipboard Toggle word wrap

Procédure

1. Vérifiez l’état d’une CR MigMigration :

   $ oc get migmigration <migmigration> -o yaml

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   status:
     conditions:
     - category: Warn
       durable: true
       lastTransitionTime: "2021-01-26T20:48:40Z"
       message: 'Final Restore openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf: partially failed on destination cluster'
       status: "True"
       type: VeleroFinalRestorePartiallyFailed
     - category: Advisory
       durable: true
       lastTransitionTime: "2021-01-26T20:48:42Z"
       message: The migration has completed with warnings, please look at `Warn` conditions.
       reason: Completed
       status: "True"
       type: SucceededWithWarnings

   Copy to Clipboard Toggle word wrap

2. Vérifiez l’état de la CR Restore en utilisant la commande Velero describe :

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     restore describe <restore>

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   Phase:  PartiallyFailed (run 'velero restore logs ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf' for more information)
   
   Errors:
     Velero:     <none>
     Cluster:    <none>
     Namespaces:
       migration-example:  error restoring example.com/migration-example/migration-example: the server could not find the requested resource

   Copy to Clipboard Toggle word wrap

3. Vérifiez les journaux de la CR Restore en utilisant la commande Velero logs :

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     restore logs <restore>

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   time="2021-01-26T20:48:37Z" level=info msg="Attempting to restore migration-example: migration-example" logSource="pkg/restore/restore.go:1107" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf
   time="2021-01-26T20:48:37Z" level=info msg="error restoring migration-example: the server could not find the requested resource" logSource="pkg/restore/restore.go:1170" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf

   Copy to Clipboard Toggle word wrap

   Le message d’erreur du journal de la CR Restore (the server could not find the requested resource) indique la cause de l’échec partiel de la migration.

Procédure

1. Répertoriez les CR MigMigration dans l’espace de nommage openshift-migration :

   $ oc get migmigration -n openshift-migration

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   NAME                                   AGE
   88435fe0-c9f8-11e9-85e6-5d593ce65e10   6m42s

   Copy to Clipboard Toggle word wrap

2. Inspectez la CR MigMigration :

   $ oc describe migmigration 88435fe0-c9f8-11e9-85e6-5d593ce65e10 -n openshift-migration

   Copy to Clipboard Toggle word wrap

   La sortie est semblable aux exemples suivants.