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.

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.

Remarque : 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 exécutions de travail sont supprimés. 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, sélectionnez un compartiment dans la liste déroulante 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.
Sélectionnez 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 la journalisation 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 déjà un :

Ouvrez le menu de navigation et sélectionnez Observation & gestion. Sous Logging Analytics, sélectionnez Administration.
Sur la page Présentation de l'administration, sous Ressources, sélectionnez Groupes de journaux.
Choisissez un compartiment dans lesquels vous avez le droit de travailler, puis sélectionnez 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 de ce 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.
Choisissez Créer.

La page de détails du groupe de journaux apparaît.
Sélectionnez Journaux.
Sélectionnez Activer le journal du service.
Sous Sélectionner une ressource :
1. Pour Compartiment de 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, procédez comme suit :
1. Pour 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 d'enregistrement du journal.
2. Pour Groupe de journaux, sélectionnez un groupe de journaux dans la liste déroulante ou créez un groupe.
Pour Conservation de journal, sélectionnez le nombre de mois pendant lesquels les journaux doivent être conservés.
Sélectionnez 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.

Remarque : cette fonctionnalité s'applique uniquement aux déploiements de réplication de données.

Avant de collecter des diagnostics, veillez à créer un bucket Oracle 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 sélectionnez 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, sélectionnez 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 diagnostic.
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.
  
  Remarque : les diagnostics collectés pour le déploiement OCI GoldenGate stockent les journaux GoldenGate pour toute la durée de la vie du déploiement. Ils sont indépendants des dates d'ouverture et d'arrivée sélectionnées.

Une fois vous avez sélectionné 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.

Une fois le téléchargement terminé, décompressez le fichier et vérifiez son contenu :

/etc/ogg : contient des fichiers de paramètres
/var/report : contient les fichiers de rapport et de rejet
/var/log : contient des fichiers journaux
ER-events.log : contient les événements d'extraction et de réplication
ggserr.log : contient les erreurs OCI GoldenGate
restapi.log : contient les journaux d'API REST
adminsrvr.log : contient les journaux du service d'administration.
pmsrvr.log : contient les journaux du service de mesures de performances
distsrvr.log : contient les journaux du service de distribution
recvsrvr.log : contient les journaux du service de destinataire
extract.log : contient les journaux du processus d'extraction
replicat.log : contient les journaux du processus Replicat