Solución de problemas mediante los logs

Descubra cómo solucionar problemas comunes mediante el registro y los logs de OCI que se encuentran en sus copias de seguridad de despliegue y recopilar diagnósticos de su despliegue de OCI GoldenGate.

Logs de procesos y errores

Puede integrar OCI Logging con OCI GoldenGate para activar, gestionar y buscar logs de errores y procesos de GoldenGate. La integración con el servicio Logging es opcional.

Logs de errores: contienen contenido del archivo ggserr.log que registra eventos de procesamiento, mensajes, errores y advertencias generados por GoldenGate.
Logs de proceso: contienen contenido de varios archivos log para el servicio de administración, el servicio de distribución, el servicio de métricas de rendimiento, el servicio de receptor y los eventos de Extract/Replicat.

Antes de empezar a utilizar OCI Logging:

Familiarícese con los conceptos básicos y la terminología utilizados en el servicio OCI Logging. Consulte Visión general de Logging en la documentación de OCI Logging.
Cree un grupo para gestionar el acceso a los grupos de logs y el contenido del log. Consulte Trabajar con grupos en la documentación de OCI IAM.
Agregue políticas para activar el registro público para OCI GoldenGate.

Nota: Puede gestionar el ciclo de vida del log, incluidos los logs que OCI GoldenGate crea automáticamente. Los logs no se suprimen cuando se suprimen el trabajo y las ejecuciones de trabajos. Obtenga más información sobre los precios de Observability and Management.

Agregar políticas para utilizar OCI Logging con OCI GoldenGate

Para activar los logs de servicio, debe otorgar a su usuario acceso de administración en el grupo de log y acceso al recurso. Los logs y los grupos de logs utilizan el tipo de recurso log-group, pero para buscar el contenido de los logs, debe utilizar el tipo de recurso log-content. Agregue las siguientes políticas:

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

Más información sobre las políticas.

Activación de Logging mediante la Consola de Oracle Cloud

En la página Despliegues, seleccione el despliegue para el que desea activar el registro.
En la página Detalles de despliegue, seleccione Supervisión.
En la página Monitoring, desplácese hasta Logs.
En la tabla Logs, en el menú Acciones de uno de los logs, seleccione Activar log.
En el panel Activar log, en la lista desplegable Compartimento, seleccione un compartimento.
Para el grupo Log, puede:
- Seleccionar un grupo de la lista desplegable
- Cree un grupo nuevo
- Dejarlo en blanco y se asigna automáticamente un grupo por defecto
En Nombre de log, introduzca un nombre.
Para la retención de logs, seleccione el número de meses de la lista desplegable.
Seleccione Activar log.

Espere a que el estado se active. Una vez que está activa, la función de logs de diagnóstico se activa para los logs de proceso y error. Los logs de proceso y error son técnicamente "logs de servicio", ya que provienen de un servicio nativo de Oracle Cloud Infrastructure como OCI GoldenGate.

Activación de OCI Logging mediante la CLI

Crear Grupo de Log

Solicitud

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

Respuesta

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

Obtener ID de grupo de logs

Solicitud

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

Respuesta

{
    "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"
    }
}

Crear/Activar Objeto de Log

Solicitud

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

Carga útil de solicitud JSON

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

Respuesta

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

Desactivar registro de OCI

Solicitud

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

Respuesta

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

Buscar logs de OCI

Solicitud

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'

Respuesta

{
    "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
        }
    }
}

Obtener estado de log

Solicitud

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

Respuesta

{
    "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"
}

Suprimir Log

Solicitud

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

Respuesta

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

Suprimir Grupo de Logs

Solicitud

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

Respuesta

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

Activación del registro para OCI GoldenGate en el servicio OCI Logging

Cree un grupo de registros y configure un log de servicio en el servicio Logging si aún no tiene uno:

Abra el menú de navegación y seleccione Observability & Management. En Logging Analytics, seleccione Administración.
En la página Visión general de administración, en Recursos, seleccione Grupos de logs.
Seleccione un compartimento en los que tenga permiso para trabajar y seleccione Crear Grupo de Logs.

Aparecerá el panel Crear grupo de logs.
Complete lo siguiente:
- Compartimento: compartimento en la que desea crear el grupo de logs. Este campo se rellena previamente según la opción elegida de compartimento.
- Nombre: nombre para este grupo de logs. El primer carácter de un nombre de grupo de logs debe ser una letra. Para obtener más información, consulte Nombres de log y grupo de logs. Evite introducir información confidencial.
- Descripción: descripción fácil de recordar.
- (Opcional) Introduzca información de etiquetado.
Seleccione Crear.

A continuación aparecerá la página de detalles de grupo de logs.
Seleccione Logs.
Seleccione Activar log de servicio.
En Select Resource (Seleccionar recurso):
1. En Compartimento de recurso, seleccione el compartimento del recurso.
2. En Servicio, seleccione GoldenGate en la lista desplegable.
3. En Recurso, seleccione un despliegue en la lista desplegable.
En Configure log:
1. En Categoría de log, seleccione un valor de la lista desplegable.
2. En Nombre de Log, introduzca un nombre.
Seleccione Mostrar opciones avanzadas y, en Ubicación de log:
1. En Compartimento, seleccione el compartimento donde desea guardar el log.
2. En Grupo de logs, seleccione un grupo de logs de la lista desplegable o cree un nuevo grupo.
En Retención de logs, seleccione el número de meses para los que desea retener los logs.
Seleccione Activar log.

Logs de copia de seguridad de despliegue

Puede realizar una copia de seguridad manual de un despliegue de OCI GoldenGate en Oracle Object Storage y, a continuación, descargar la copia de seguridad localmente. A continuación, puede localizar los logs de despliegue para solucionar problemas de estado.

Para obtener más información sobre cómo crear una copia de seguridad manual, consulte Gestión de copias de seguridad de despliegue.

La copia de seguridad de despliegue manual contiene la estructura y los archivos completos del directorio de despliegue de GoldenGate, incluidos los archivos log y de seguimiento. Los directorios y archivos que son útiles para la solución de problemas incluyen:

/etc: configuración
- /etc/ogg: archivos de parámetros
/var: archivos log, punto de control, archivos de seguimiento, etc.
- /var/checkpt: punto de control
- /var/data: archivos de pista
- /var/report: archivos de informe
- /var/log: archivos log
  - 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

Recopilación de diagnósticos

Recopile diagnósticos para analizar o compartir información sobre el despliegue de OCI GoldenGate. La información recopilada se puede compartir con My Oracle Support si se produce alguna incidencia.

Nota: Esta función solo se aplica a los despliegues de replicación de datos.

Antes de recopilar diagnósticos, asegúrese de que crea un cubo de Oracle Object Storage.

Para recopilar diagnósticos de despliegue:

En la página Despliegues, seleccione el despliegue para el que desea recopilar diagnósticos.
En la página Detalles del despliegue, en el menú Acciones, seleccione Recopilar diagnósticos.
En el panel Recopilar diagnósticos, complete los siguientes campos y, a continuación, seleccione Recopilar diagnósticos:
1. En la lista desplegable Bucket, seleccione el cubo en la que desea guardar el archivo de diagnóstico. Si desea seleccionar un cubo de un compartimento diferente, seleccione Cambiar compartimento.
2. En Prefijo de nombre del diagnóstico, introduzca una abreviatura o algunos caracteres como prefijo del nombre del archivo de diagnósticos.
3. (Opcional) Seleccione la Fecha de inicio a partir de la cual se recopilarán los logs del sistema.
4. (Opcional) Seleccione la Fecha de finalización hasta la cual se recopilarán los logs del sistema.
  
  Nota: Los diagnósticos recopilados del despliegue de OCI GoldenGate incluyen logs de GoldenGate para toda la vida real del despliegue y son independientes de las fechas inicial y final seleccionadas.

Una vez que haya seleccionado Recopilar diagnósticos, aparecerá un nuevo campo denominado Diagnóstico en la sección GoldenGate de la ficha de información Despliegue. El archivo zip de diagnósticos puede tardar varios minutos en estar disponible para su descarga. Cuando está disponible, aparece un enlace Descargar.

Una vez finalizada la descarga, descomprima el archivo y revise su contenido:

/etc/ogg: contiene archivos de parámetros
/var/report: contiene archivos de informe y descarte
/var/log: contiene archivos log
ER-events.log: contiene eventos de Extract y Replicat
ggserr.log: contiene errores de OCI GoldenGate
restapi.log: contiene logs de API de REST
adminsrvr.log: contiene los logs del servicio de administración
pmsrvr.log: contiene los logs del servicio de métricas de rendimiento
distsrvr.log: contiene los logs del servicio de distribución
recvsrvr.log: contiene los logs del servicio de receptor
extract.log: contiene los logs del proceso de extracción
replicat.log: contiene los logs de proceso de Replicat