Solución de problemas mediante los logs

Descubra cómo solucionar problemas comunes mediante el registro y los logs de OCI encontrados en las copias de seguridad de despliegue, y recopilar diagnósticos del despliegue de OCI GoldenGate.

Logs de procesos y errores

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

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

Antes de empezar a utilizar OCI Logging:

Familiarícese con los conceptos y la terminología básicos 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 al 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 de los logs, incluidos los logs que crea automáticamente OCI GoldenGate. Los logs no se suprimirán cuando se supriman el trabajo y las ejecuciones de trabajos. Más información sobre precios de observabilidad y gestión.

Agregar políticas para utilizar OCI Logging con OCI GoldenGate

Para activar los logs de servicio, debe otorgar al usuario acceso de gestión en el grupo de logs 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 del registro 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 de logs, puede:
- Seleccione un grupo en la lista desplegable.
- Cree un grupo nuevo
- Déjelo en blanco y se asignará automáticamente un grupo por defecto
Para el nombre de log, introduzca un nombre.
Para la retención de logs, seleccione el número de meses en la lista desplegable.
Haga clic en Activar log.

Espere a que el estado pase a Activo. Una vez que está activa, la función Logs de diagnóstico se activa para el proceso y los logs de errores. Los logs de procesos y errores 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 logs

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

Activar el registro para OCI GoldenGate en el servicio OCI Logging

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

Abra el menú de navegación y haga clic en Observación y gestión. En Logging Analytics, haga clic en Administración.
En la página Visión general de administración, en Recursos, haga clic en Grupos de logs.
Seleccione un compartimento en el que tenga permiso para trabajar y haga clic en Crear grupo de logs.

Aparece el panel Crear grupo de logs.
Complete lo siguiente:
- Compartment: compartimento en el 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.
Haga clic en Crear.

A continuación aparecerá la página de detalles de grupo de logs.
Haga clic en Logs.
Haga clic en Activar log de servicio.
En 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 Configurar log:
1. En Categoría de log, seleccione un valor en 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 en el que desea guardar el log.
2. En Grupo de logs, seleccione un grupo de logs en la lista desplegable o cree un nuevo grupo.
En Retención de log, seleccione el número de meses durante los que se conservarán los logs.
Haga clic en 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 despliegues de replicación de datos.

Antes de recopilar diagnósticos, asegúrese de crear un cubo de OCI 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, haga clic en Recopilar diagnósticos:
1. En la lista desplegable Cubo, seleccione el cubo en el que desea guardar el archivo de diagnóstico. Si desea seleccionar un cubo de un compartimento diferente, haga clic en Cambiar compartimento.
2. En Prefijo de nombre de diagnóstico, introduzca una abreviatura o algunos caracteres como prefijo del nombre de 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 contienen logs de GoldenGate de toda la vida útil del despliegue y son independientes de las fechas de inicio y finalización seleccionadas.

Después de hacer clic en Recopilar diagnósticos, aparecerá un nuevo campo denominado Diagnóstico en la sección GoldenGate de la tarjeta de información Despliegue. El archivo zip de diagnósticos puede tardar varios minutos en estar disponible para su descarga. Cuando está disponible, aparece el enlace Descargar.

Documentación de Oracle Cloud Infrastructure