Soluciona problemas de integración

Estos son algunos problemas comunes y los pasos para solucionar problemas relacionados con la integración del conector de la central de APIs.

Los metadatos de la API no aparecen en el concentrador de APIs

• Tiempo de sincronización inicial: La sincronización inicial puede tardar algunas horas en comenzar y en que los datos de la API aparezcan en API Hub. Se recomienda esperar unas horas.
• Estado de la instancia del complemento: Verifica que la instancia del complemento en el centro de APIs no se haya borrado ni cambiado.
• ID de puerta de enlace: Asegúrate de que el ID de puerta de enlace correcto esté configurado de forma adecuada en la configuración del conector del centro de APIs de Apigee Edge para la nube privada.
• Verifica los registros: Comprueba si hay algún error registrado en los registros del servicio del conector del centro de APIs de Edge para Private Cloud /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

El proxy se implementó, pero la información del concentrador de APIs no es precisa

• Demora en la propagación: Espera unos minutos para que la información del proxy implementado se propague y se refleje en el centro de APIs.
• Revisa los registros: Revisa los registros del conector del centro de API de Edge para Private Cloud para obtener detalles sobre los proxies subidos. Esto puede ayudar a identificar si la actualización del proxy se procesó correctamente para la sincronización.

La organización del usuario dejó de sincronizarse sin que se cambiara nada en el conector del Centro de APIs

• Estado de la instancia del complemento (lado del concentrador de APIs): Verifica si se desaprovisionó, borró o modificó la instancia del complemento asociada en el concentrador de APIs. Cualquier cambio en el concentrador de APIs puede afectar directamente la sincronización desde el conector del concentrador de APIs.
• Revisa los registros: Revisa los registros del conector del centro de APIs de Edge para la nube privada en busca de errores, advertencias o problemas que puedan indicar una interrupción en el proceso de sincronización. Esto podría incluir problemas de conectividad o de autenticación con el concentrador de APIs.

Usa la API de estado (recomendada para las organizaciones que habilitaron la opción):

La API de estado proporciona una forma directa de ver qué organizaciones habilitaron la sincronización y la están realizando de forma activa.

Solución de problemas basada en registros

¿Dónde se almacenan los registros del conector del concentrador de APIs?

/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

¿Cómo obtengo información sobre las organizaciones habilitadas?

Para determinar qué organizaciones (orgs) están habilitadas y sincronizadas actualmente, puedes aprovechar la API de estado y revisar los registros del sistema.

• Acción: Llama al extremo de la API de estado.
• Salida esperada: Las organizaciones que aceptaron participar se mostrarán en las secciones apiSyncStatus y analyticsSyncStatus de la respuesta de la API. Las organizaciones con la sincronización de metadatos habilitada aparecerán en apiSyncStatus, y las organizaciones con la sincronización de tiempo de ejecución habilitada aparecerán en analyticsSyncStatus.

  {
   "apiSyncStatus": [
     {
       "organization": "foo",
       "phase": "Preparing", // ColdTransfer => Preparing
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 100, // total proxies known to uapim connector
             "pendingItems": 90,  // pending proxies to upload
             "completedItems": 6, // completed proxies to upload
             "failedItems": 4 // proxies failed to upload
           }
         },
         "environment": { //environment upload status
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 1, // pending environments to process
             "completedItems": 3, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "bar",
       "phase": "Processing", // "Streaming" -> "Processing"
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 110, // total proxies known to uapim connector
             "pendingItems": 16, // pending proxies to upload
             "completedItems": 3, // completed proxies to upload
             "failedItems": 1 // proxies failed to upload
           }
         },
         "environment": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 3, // pending environments to process
             "completedItems": 1, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "test",
       "phase": "Queued", // "Yet to start" -> "Queued"
       "lastUpdated": "2025-04-16T00:56:45Z"
     }
   ],
   "analyticsSyncStatus": [
     {
       "organization": "test",
       "environment": "dev",
       "failedItems": 2,
       "lastUpdated": "2025-04-16T00:56:45Z"
     },
     {
       "organization": "test",
       "environment": "prod",
       "failedItems": 4,
       "lastUpdated": "2025-04-16T00:56:45Z"
     }
   ]
  }
  

• Inspección de los registros del sistema: Para obtener una vista más detallada y confirmar la configuración de la sincronización para organizaciones individuales, puedes examinar los registros del sistema en busca de entradas específicas.
  • Verifica los registros:

    /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Comandos de búsqueda: Usa grep o herramientas de búsqueda de registros similares para encontrar las siguientes líneas de registro:
    • Para la sincronización de metadatos de la organización metadata-org, haz lo siguiente:

      grep "Setup metadata sync for organization: metadata-org"  /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • Ejemplo de fragmento de registro:

      2025-07-10 08:47:09,901  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupMetadataSync() : Setup metadata sync for organization: metadata-org

    • Busca el texto Setup metadata sync for organization: seguido del nombre de la organización.
    • Para la sincronización de datos del entorno de ejecución de org runtime-org, haz lo siguiente:

      grep "Setup runtime data sync for organization: runtime-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • Ejemplo de fragmento de registro:

      2025-07-10 08:47:09,902  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupRuntimeSyncData() : Setup runtime data sync for organization: runtime-org

    • Busca el texto Configurar la sincronización de datos del tiempo de ejecución para la organización: seguido del nombre de la organización.

¿Cómo obtengo información de todos los pares (org,env) que no se pudieron habilitar a partir de los registros?

Para obtener información sobre las organizaciones que no se pudieron habilitar, puedes examinar las entradas de error específicas en los registros del sistema.

• Verifica los registros: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Comandos de búsqueda: Usa grep o herramientas de búsqueda de registros similares para encontrar líneas de registro que indiquen un error durante la actualización del estado de sincronización de metadatos.
  • En el caso de las actualizaciones de estado de sincronización de metadatos fallidas para org/env failed-org/failed-env:

    grep "Error while updating metadata sync status for org: failed-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Ejemplo de fragmento de registro:

    2025-07-15 10:30:15,123 main ERROR c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateMetadataSyncStatus() : Error while updating metadata sync status for org: failed-org

  • Busca el texto Error while updating metadata sync status for org/env: seguido de la organización y el entorno (por ejemplo, failed-org/failed-env).

¿Cómo puedo obtener un resumen del cambio de estado de la transferencia de la organización a partir de los registros?

Para obtener un resumen de cuándo se actualiza el estado de transferencia de sincronización (org, env), puedes examinar las entradas específicas de los registros del sistema.

• Verifica los registros: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Comandos de búsqueda: Usa grep o herramientas de búsqueda de registros similares para encontrar líneas de registro que indiquen una actualización del estado de la transferencia para una organización y un entorno.
  • Para obtener actualizaciones sobre el estado de la transferencia, haz lo siguiente:

    grep "Transfer status is updated for org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Ejemplo de fragmento de registro:

    2025-07-15 18:35:01,789 main INFO c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateTransferStatus() : Transfer status is updated for org: org1 to BULK_TRANSFER
    2025-07-10 08:47:11,364  main INFO  c.a.u.m.UAPIMMetadataServiceImpl - UAPIMMetadataServiceImpl.updateEnvironmentStatus() : Transfer status is updated for org: org1 to STREAMING

  • Busca el texto exacto "Se actualizó el estado de la transferencia para org/env", seguido de la organización y el entorno específicos (p.ej., org1/prod) y el estado.