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 las copias de seguridad de despliegue y recopile diagnósticos del despliegue de OCI GoldenGate.

Temas relacionados

Logs de procesos y errores

Puede integrar OCI Logging con OCI GoldenGate para activar, gestionar y buscar logs de procesos y errores 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.

Note:

Puede gestionar el ciclo de vida del log, incluidos los logs que crea automáticamente OCI GoldenGate. 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 la conexión mediante la Consola de Oracle Cloud

  1. En la página Despliegues, seleccione el despliegue para el que desea activar el registro.
  2. En la página Detalles de despliegue, seleccione Supervisión.
  3. En la página Monitoring, desplácese hasta Logs.
  4. En la tabla Logs, en el menú Acciones de uno de los logs, seleccione Activar log.
  5. En el panel Activar log, en la lista desplegable Compartimento, seleccione un compartimento.
  6. 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
  7. En Nombre de log, introduzca un nombre.
  8. Para la retención de logs, seleccione el número de meses de la lista desplegable.
  9. Haga clic en Activar registro.

Espere a que el estado se active. Una vez que está activa, la función 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

  1. 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>" }
  2. 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"  
    }
}
  3. 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>"
}
  4. 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>"
}
  5. 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    
        }  
    }
}
  6. 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"
}
  7. 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>"
}
  8. 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 de registro si aún no tiene uno:

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Logging Analytics, haga clic en Administración.
  2. En la página Visión general de administración, en Recursos, haga clic en Grupos de logs.
  3. Seleccione un compartimiento en el que tenga permiso para trabajar y haga clic en Create Log Group.

    Aparecerá el panel Crear grupo de logs.

  4. Complete lo siguiente:
    • Compartimento: 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.
  5. Haga clic en Create.

    A continuación aparecerá la página de detalles de grupo de logs.

  6. Haga clic en Logs.
  7. Haga clic en Activar registro de servicio.
  8. En Select Resource:
    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.
  9. En Configurar log:
    1. En Categoría de log, seleccione un valor de la lista desplegable.
    2. En Nombre de Log, introduzca un nombre.
  10. 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 en la lista desplegable o cree un nuevo grupo.
  11. En Retención de logs, seleccione el número de meses para los que desea retener los logs.
  12. Haga clic en Activar registro.

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.

Note:

Esta función solo se aplica a los 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:
  1. En la página Despliegues, seleccione el despliegue para el que desea recopilar diagnósticos.
  2. En la página Detalles del despliegue, en el menú Acciones, seleccione Recopilar diagnósticos.
  3. 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 la 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 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.

      Note:

      Los diagnósticos recopilados del despliegue de OCI GoldenGate contienen logs GoldenGate de toda la vida real del despliegue y son independientes de las fechas inicial y final seleccionadas.
Tras 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 un enlace Descargar.