Dépannage à l'aide des journaux

Découvrez comment résoudre 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 OCI Logging à OCI GoldenGate pour activer, gérer et rechercher les journaux de processus et d'erreurs GoldenGate. L'intégration avec le service Logging est facultative.

Journaux d'erreurs : contient le contenu du fichier ggserr.log qui consigne les événements de traitement, les messages, les erreurs et les avertissements générés par GoldenGate.
Journaux de processus : contiennent le contenu de plusieurs fichiers journaux pour le service d'administration, le service de distribution, le service de mesures de performances, le service de destinataire et les événements d'extraction/de réplication.

Avant de commencer à utiliser OCI Logging :

Familiarisez-vous avec les concepts de base et la terminologie utilisés dans le service OCI Logging. Reportez-vous à Présentation de Logging dans la documentation OCI Logging.
Créez un groupe pour gérer l'accès aux groupes de journaux et au contenu des journaux. Reportez-vous à Utilisation des groupes dans la documentation OCI IAM.
Ajoutez des stratégies pour activer la journalisation publique pour OCI GoldenGate.

Remarques :

Vous gérez le cycle de vie des journaux, y compris les journaux créés automatiquement pour vous par OCI GoldenGate. Les journaux ne sont pas supprimés lorsque le travail et les traitements de travail le sont. En savoir plus sur les tarifs d'observabilité et de gestion.

Ajouter des stratégies pour utiliser OCI Logging avec OCI GoldenGate

Pour activer les journaux de service, vous devez accorder l'accès en gestion sur le groupe de journaux et l'accès à la ressource à l'utilisateur. 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 stratégies 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 stratégies.

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

Sur la page Déploiements, sélectionnez le déploiement pour lequel vous voulez activer la journalisation.
Sur la page Détails du déploiement, sélectionnez Surveillance.
Dans la page Monitoring, faites défiler la page jusqu'à Logs.
Dans la table 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 de journaux, vous pouvez :
- Sélectionnez un groupe dans la liste déroulante.
- Créez un groupe
- Laissez-le vide et un groupe par défaut est automatiquement affecté
Entrez un nom dans le champ Nom du journal.
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 qu'elle est active, la fonction Journaux de diagnostic est activée pour les journaux de processus et 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 OCI Logging à l'aide de la CLI

Création d'un groupe de journal

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

Charge utile 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 dans les 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 un 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 Logging pour OCI GoldenGate dans le service OCI Logging

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

Ouvrez le menu de navigation et cliquez sur Observation et gestion. Sous Logging Analytics, cliquez sur Administration.
Sur la page de présentation de l'administration, sous Ressources, cliquez sur Groupes de journaux.
Choisissez un compartiment dans lesquels vous avez l'autorisation de travailler, puis cliquez sur Créer un groupe de journaux.

Le panneau Créer un groupe de journaux s'affiche.
Renseignez les informations ci-dessous :
- Compartiment : compartiment dans lequel créer le groupe de journaux. Ce champ est prérempli en fonction du choix de compartiment.
- Nom : nom du groupe de journaux. Le nom de groupe de journaux doit commencer par une lettre. Pour plus d'informations, reportez-vous à Noms de journaux et de groupes de journaux. Evitez de saisir des informations confidentielles.
- Description : description conviviale.
- (Facultatif) Entrez les informations de balisage.
Cliquez sur Créer.

La page de détails du groupe de journaux apparaît.
Cliquez sur Journaux.
Cliquez sur Activer le journal du service.
Sous Sélectionner une ressource :
1. Dans Compartiment de ressource, sélectionnez le compartiment de la ressource.
2. Dans Service, sélectionnez GoldenGate dans la liste déroulante.
3. Dans Ressource, sélectionnez un déploiement dans la liste déroulante.
Sous Configurer le journal, procédez comme suit :
1. Dans Catégorie de journal, sélectionnez une valeur dans la liste déroulante.
2. Dans Nom de journal, entrez un nom.
Sélectionnez Afficher les options avancées, puis sous Emplacement du journal :
1. Pour Compartiment, sélectionnez le compartiment dans lesquels enregistrer le journal.
2. Dans Groupe de journaux, sélectionnez un groupe de journaux dans la liste déroulante ou créez un groupe.
Dans Conservation de journal, sélectionnez le nombre de mois pendant lesquels conserver les journaux.
Cliquez sur Activer le journal.

Journaux de sauvegarde de déploiement

Vous pouvez sauvegarder manuellement un déploiement OCI GoldenGate dans Oracle Object Storage, puis télécharger la sauvegarde en local. Vous pouvez ensuite localiser les journaux de déploiement pour résoudre les problèmes d'état.

Pour découvrir comment créer une sauvegarde manuelle, reportez-vous à Gestion des sauvegardes de déploiement.

La sauvegarde de déploiement manuelle contient la structure complète du répertoire de déploiement GoldenGate et des fichiers, dont les fichiers journaux et les fichiers de trace. Les répertoires et 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 trace, etc.
- /var/checkpt : point de reprise
- /var/data : fichiers de trace
- /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

Collecte de diagnostics

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

Remarques :

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

Avant de collecter des diagnostics, veillez à créer un bucket OCI Object Storage.

Pour collecter des diagnostics de déploiement, procédez comme suit :

Sur la page Déploiements, sélectionnez le déploiement pour lequel collecter des diagnostics.
Sur la page Détails du déploiement, dans le menu Actions, sélectionnez Collecter des diagnostics.
Dans le panneau Collecter des diagnostics, renseignez les champs suivants, puis cliquez sur Collecter des diagnostics :
1. Dans la liste déroulante Bucket, sélectionnez le bucket dans lequel enregistrer le fichier de diagnostic. Pour sélectionner un bucket dans un autre compartiment, cliquez sur Modifier le compartiment.
2. Dans Préfixe de nom de diagnostics, entrez un nom abrégé ou quelques caractères servant de préfixe au nom du fichier de diagnostics.
3. (Facultatif) Sélectionnez la date de début, à partir de laquelle collecter les journaux système.
4. (Facultatif) Sélectionnez la date de fin, jusqu'à laquelle collecter les journaux système.
  
  Remarques :
  Les diagnostics collectés pour le déploiement OCI GoldenGate contiennent les journaux GoldenGate de toute la durée de la vie du déploiement, ils ne dépendent pas des dates d'ouverture et d'arrivée sélectionnées.

Après avoir cliqué sur Collecter des diagnostics, un nouveau champ nommé Diagnostics s'affiche sous la section GoldenGate de la carte Informations sur le déploiement. La mise à disposition du fichier ZIP de diagnostic pour téléchargement peut prendre plusieurs minutes. Lorsqu'il est disponible, un lien Télécharger apparaît.

Informations relatives au titre et au copyright

Oracle et/ou ses affiliés.