Dépannage à l'aide des journaux

Voyez comment dépanner les problèmes courants à l'aide de la journalisation OCI et des journaux trouvés dans vos sauvegardes de déploiement, et collecter des diagnostics à partir de votre déploiement OCI GoldenGate.

Rubriques connexes

Dépannage à l'aide de la console Oracle Cloud

Journaux des processus et des erreurs

Vous pouvez intégrer le service de journalisation OCI à OCI GoldenGate pour activer, gérer et rechercher le processus GoldenGate et les journaux d'erreurs. L'intégration au service de journalisation est facultative.

Journaux d'erreurs : Contient le contenu du fichier ggserr.log qui journalise le traitement des événements, des messages, des erreurs et des avertissements générés par GoldenGate.
Journaux de processus : Contient du contenu provenant de plusieurs fichiers journaux pour le service d'administration, le service de distribution, le service de mesures de performance, le service récepteur et les événements Extract/Replicat.

Avant de commencer à utiliser le service de journalisation OCI :

Familiarisez-vous avec les concepts et la terminologie de base utilisés dans le service de journalisation pour OCI. Voir Aperçu du service de journalisation dans la documentation sur le service de journalisation pour OCI.
Créez un groupe pour gérer l'accès aux groupes de journaux et au contenu des journaux. Voir Utilisation des groupes dans la documentation sur OCI IAM.
Ajoutez des politiques pour activer la journalisation publique pour OCI GoldenGate.

Note :

Vous gérez le cycle de vie des journaux, y compris ceux créés automatiquement par OCI GoldenGate. Lorsque le travail et les exécutions de travail sont supprimées, les journaux ne le sont pas. En savoir plus sur les tarifs d'observabilité et de gestion.

Ajouter des politiques pour utiliser le service de journalisation OCI avec OCI GoldenGate

Pour activer les journaux de service, vous devez autoriser l'utilisateur à gérer le groupe de journaux et à accéder à la ressource. Les journaux et les groupes de journaux utilisent le type de ressource log-group, mais pour effectuer des recherches dans le contenu des journaux, vous devez utiliser le type de ressource log-content. Ajoutez les politiques suivantes :

allow group <group-name> to manage log-groups in compartment <compartment-name>
allow group <group-name> to manage log-content in compartment <compartment-name>

En savoir plus sur les politiques.

Activer la journalisation à l'aide de la console Oracle Cloud

Dans la page Déploiements, sélectionnez le déploiement pour lequel vous voulez activer la journalisation.
Dans la page Détails du déploiement, sélectionnez Surveillance.
Dans la page Monitoring, faites défiler l'affichage vers le bas jusqu'à Logs.
Dans le tableau Journaux, dans le menu Actions de l'un des journaux, sélectionnez Activer le journal.
Dans le panneau Activer le journal, dans la liste déroulante Compartiment, sélectionnez un compartiment.
Pour le groupe Log, vous pouvez :
- Sélectionner un groupe dans la liste déroulante
- Créer un groupe
- Laissez-le vide et un groupe par défaut est automatiquement affecté
Dans le champ Log name, entrez un nom.
Pour la conservation des journaux, sélectionnez le nombre de mois dans la liste déroulante.
Cliquez sur Activer le journal.

Attendez que le statut devienne Actif. Une fois activée, la fonction Journaux de diagnostic est activée pour le processus et les journaux d'erreurs. Les journaux de processus et d'erreurs sont techniquement des 'journaux de service' car ils proviennent d'un service natif Oracle Cloud Infrastructure tel qu'OCI GoldenGate.

Activer la journalisation OCI à l'aide de l'interface de ligne de commande

Créer un groupe de journaux

Demande

oci --profile <profile_name> logging log-group create --compartment-id <compartment_ocid>
      --display-name <display_name>

Réponse

{ "opc-work-request-id": "<log-workrequest-ocid>" }

Obtenir l'ID groupe de journaux

Demande

oci --profile <profile_name> logging work-request get --work-request-id
      <log-workrequest-ocid>

Réponse

{  
    "data": {    
    "compartment-id": "<compartment_ocid>",    
    "id": "<log-workrequest-ocid>",    
    "operation-type": "CREATE_LOG_GROUP",    
    "percent-complete": 100.0,    
    "resources": [      
        {        
            "action-type": "CREATED",        
            "entity-type": "loggroup",        
            "entity-uri": "/logGroups/<log-group-ocid>",        
            "identifier": "<log-group-ocid>"      
        }    
    ],    "
    status": "SUCCEEDED",    
    "time-accepted": "2023-05-09T05:57:09.641000+00:00",    
    "time-finished": "2023-05-09T05:57:09.641000+00:00",    
    "time-started": "2023-05-09T05:57:09.641000+00:00"  
    }
}

Créer/activer un objet de journal

Demande

oci --profile <profile-name> logging log create --display-name <display-name> --log-group-id
      <log-group-ocid> --log-type SERVICE/CUSTOM --is-enabled true  --configuration file://path_to_json_file

Données utiles de demande JSON

{  
    "compartment-id": "<compartment-ocid>",     
    "source":    
        {        
            "resource": "<GoldenGate-deployment-ocid>",            
            "service": "goldengate",            
            "source-type": "OCISERVICE",            
            "category": "error_logs/process_logs"      
        }    
}

Réponse

Response 
{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

Désactiver la journalisation OCI

Demande

oci --profile <profile_name> logging log update --is-enabled false --log-group-id <log-group-ocid> --log-id <log-ocid>

Réponse

{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

Rechercher des journaux OCI

Demande

oci --profile <profile_name> logging-search search-logs
      --search-query "search \"<compartment_ocid>/<log-group-ocid>/<log-ocid>\"" --time-start '2023-05-09 09:54' --time-end '2023-05-09 09:55'

Réponse

{  
    "data": {    
        "fields": null,    
        "results": [      
            {        
                "data": {          
                "datetime": 1683626095205,          
                "logContent": {            
                    "data": {              
                        "level": "INFO",              
                        "message": "Executing command '{\n    \"name\": \"report\",\n    \"reportType\": \"lag\",\n    \"thresholds\": [\n        {\n            \"type\": \"info\",\n            \"units\": \"seconds\",\n           \"value\": 0\n        }\n    ]\n}'",              
                        "processName": "adminsrvr",              
                        "resourceId": "<GoldenGate-deployment-ocid>"            
                    },            
                    "id": "20230509095455.2051683626095",            
                    "oracle": {              
                        "compartmentid": "<compartment-ocid>",              
                        "ingestedtime": "2023-05-09T09:55:05.889Z",              
                        "loggroupid": "<log-group-ocid>",              
                        "logid": "<log-ocid>",              
                        "tenantid": "<tenant-ocid>"            
                    },            
                    "source": "<GoldenGate-deployment-ocid>",            
                    "specversion": "1.0",            
                    "time": "2023-05-09T09:54:55.205Z",            
                    "type": "com.oraclecloud.goldengate.deployment.process_logs"          
                }        
            }      
        } ],    
        "summary": {      
            "field-count": null,      
            "result-count": 1    
        }  
    }
}

Obtenir le statut du journal

Demande

oci --profile <profile_name> logging log get --log-group-id <log-group-ocid> --log-id
      <log-ocid>

Réponse

{  
    "data": {    
        "compartment-id": "<compartment-ocid>",    
        "configuration": {      
            "archiving": {        
                "is-enabled": false      
            },      
            "compartment-id": "<compartment-ocid>",      
            "source": {        
                "category": "process_logs",        
                "parameters": {},        
                "resource": "<GoldenGate-deployment-ocid>",        
                "service": "goldengate",        
                "source-type": "OCISERVICE"      
            }    
        },    
        "defined-tags": {      
            "Oracle-Tags": {        
                "CreatedBy": "<creater_email_id>",        
                "CreatedOn": "2023-05-09T06:24:30.279Z"      
            }    
        },    
        "display-name": "<display_name>",    
        "freeform-tags": {},    
        "id": "<log-ocid>",    
        "is-enabled": false,    "
        lifecycle-state": "INACTIVE",    
        "log-group-id": "<log-group-ocid>",    
        "log-type": "SERVICE",    
        "retention-duration": 30,    
        "tenancy-id": "<tenancy-ocid>",    
        "time-created": "2023-05-09T06:24:30.452000+00:00",    
        "time-last-modified": "2023-05-09T06:30:17.345000+00:00"  
    },  
    "etag": "cb5bb295-9954-4949-b33f-67d6da50f83f"
}

Supprimer le journal

Demande

oci --profile <profile_name> logging log delete --log-group-id <log-group-ocid> --log-id <log-ocid>

Réponse

{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

Supprimer le groupe de journaux

Demande

oci --profile GGSTEST logging log-group delete --log-group-id <log-group-ocid>

Réponse

{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

Activer la journalisation pour OCI GoldenGate dans le service de journalisation OCI

Créez un groupe de journaux et configurez un journal de service dans le service de journalisation si vous n'en avez pas encore :

Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Logging Analytics, cliquez sur Administration.
Dans la page Aperçu de l'administration, sous Ressources, cliquez sur Groupes de journaux.
Sélectionnez un compartiment que vous êtes autorisé à utiliser et cliquez sur Créer un groupe de journaux.

Le panneau Créer un groupe de journaux s'affiche.
Entrez les informations suivantes :
- Compartiment : Compartiment dans lequel créer le groupe de journaux. Ce champ est prérempli en fonction du compartiment sélectionné.
- Nom : Nom du groupe de journaux. Le premier caractère du nom d'un groupe de journaux doit être une lettre. Pour plus d'informations, voir Noms de groupe de journaux et de journaux. Évitez d'entrer des informations confidentielles.
- Description : Description conviviale.
- (Facultatif) Entrez les informations de marquage.
Cliquez sur Créer.

La page de détails des groupes de journaux s'affiche alors.
Cliquez sur Journaux.
Cliquez sur Activer le journal de service.
Sous Sélectionner une ressource :
1. Pour Compartiment de la ressource, sélectionnez le compartiment de la ressource.
2. Pour Service, sélectionnez GoldenGate dans la liste déroulante.
3. Pour Ressource, sélectionnez un déploiement dans la liste déroulante.
Sous Configurer le journal :
1. Pour Catégorie de journal, sélectionnez une valeur dans la liste déroulante.
2. Pour Nom du journal, entrez un nom.
Sélectionnez Afficher les options avancées et sous Emplacement du journal :
1. Pour Compartiment, sélectionnez le compartiment dans lequel enregistrer le journal.
2. Pour Groupe de journaux, sélectionnez un groupe de journaux dans la liste déroulante ou créez-en un nouveau.
Pour Conservation des journaux, sélectionnez le nombre de mois pendant lesquels les journaux doivent être conservés.
Cliquez sur Activer le journal.

Journaux de sauvegarde de déploiement

Vous pouvez sauvegarder manuellement un déploiement GoldenGate pour OCI dans le service de stockage d'objets Oracle, puis télécharger la sauvegarde localement. Vous pouvez ensuite localiser les journaux de déploiement pour résoudre les problèmes d'état.

Pour savoir comment créer une sauvegarde manuelle, voir Gestion des sauvegardes de déploiement.

La sauvegarde manuelle du déploiement contient la structure complète et les fichiers du répertoire de déploiement de GoldenGate, y compris les fichiers journaux et de piste. Les répertoires et les fichiers utiles pour le dépannage sont les suivants :

/etc : configuration
- /etc/ogg : fichiers de paramètres
/var : fichiers journaux, point de reprise, fichiers de piste, etc.
- /var/checkpt : point de reprise
- /var/data : fichiers de piste
- /var/report : fichiers de rapport
- /var/log : fichiers journaux
  - ER-events.log
  - ggserr.log
  - restapi.log
  - adminsrvr.log
  - pmsrvr.log
  - distsrvr-stdout.log
  - recsrvr-stdout.log
  - distsrvr.log
  - recvsrvr.log
  - extract.log
  - replicat.log

Collecter des diagnostics

Collectez des diagnostics pour analyser ou partager des informations sur votre déploiement de GoldenGate pour OCI. Les informations collectées peuvent être partagées avec My Oracle Support si vous rencontrez des problèmes.

Note :

Cette fonction s'applique uniquement aux déploiements de réplication de données.

Avant de collecter des diagnostics, assurez-vous de créer un seau du service de stockage d'objets pour OCI.

Pour collecter des diagnostics de déploiement :

Dans la page Déploiements, sélectionnez le déploiement pour lequel vous voulez collecter les diagnostics.
Dans la page Détails du déploiement, dans le menu Actions, sélectionnez Collecter des diagnostics.
Dans le panneau Collecter des diagnostics, remplissez les champs suivants, puis cliquez sur Créer des diagnostics :
1. Dans la liste déroulante Seau, sélectionnez le seau dans lequel enregistrer le fichier de diagnostics. Pour sélectionner un seau dans un autre compartiment, cliquez sur Changer de compartiment.
2. Pour Préfixe de nom des diagnostics, entrez un nom abrégé ou quelques caractères à utiliser en tant que préfixe du nom du fichier de diagnostics.
3. (Facultatif) Sélectionnez la date de début de la collecte des journaux du système.
4. (Facultatif) Sélectionnez la date de fin de la collecte des journaux du système.
  
  Note :
  Les diagnostics collectés pour le déploiement d'OCI GoldenGate contiennent les journaux GoldenGate pour toute la durée de vie du déploiement et sont indépendants des dates de début et de fin sélectionnées.

Lorsque vous cliquez sur Collecter des diagnostics, un nouveau champ intitulé Diagnostics s'affiche dans la section GoldenGate de la carte d'informations Déploiement. Il peut s'écouler plusieurs minutes avant que le fichier zip de diagnostics soit disponible pour téléchargement. Lorsqu'il est disponible, un lien Télécharger s'affiche.

Informations sur le titre et les droits d'auteur

Oracle et/ou ses sociétés affiliées.