Verificar o status e os erros do upload

É possível verificar o status dos uploads de metadados e dados de ambiente de execução a qualquer momento consultando o endpoint de status local do conector do hub de APIs da Apigee para nuvem privada.

Verificando o status do upload

Use o seguinte comando curl na máquina virtual que executa o conector do hub de APIs do Apigee para nuvem privada:

curl localhost:8080/v1/uapim/status

  {
 "apiSyncStatus": [
   {
     "organization": "foo",
     "phase": "Preparing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 100,
           "pendingItems": 90,
           "completedItems": 6,
           "failedItems": 4
         }
       },
       "environment": { //environment upload status
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 1,
           "completedItems": 3,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "bar",
     "phase": "Processing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 110,
           "pendingItems": 16,
           "completedItems": 3,
           "failedItems": 1
         }
       },
       "environment": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 3,
           "completedItems": 1,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "test",
     "phase": "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"
   }
 ]
}

A saída fornece insights sobre:

• Metadados da API: status dos uploads de metadados da API, incluindo organização, ambiente, etapa atual (por exemplo, "Preparando", "Processando", "Em fila"), uploads totais/concluídos/pendentes, contagem de erros e hora da última atualização.
• Metadados de tempo de execução: status dos uploads de dados de tempo de execução, mostrando organização, ambiente, contagem de erros e hora da última atualização.

Problemas comuns e etapas de solução de problemas

Se você encontrar problemas, consulte os registros do conector e o endpoint de status. O principal arquivo de registro do conector do hub da Apigee está localizado em /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

1. O conector do hub de APIs da Apigee para nuvem privada não é iniciado:
   • Verificar registros: examine /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log em busca de mensagens de erro relacionadas à configuração.
   • Verifique as configurações: confira todas as configurações definidas em uapim-connector.properties e as variáveis de ambiente.
   • Acesso ao Pub/Sub: verifique nos registros se o opdk-connector consegue acessar os tópicos do Pub/Sub fornecidos.
   • Acesso ao servidor de gerenciamento: verifique os registros para saber se opdk-connector pode chamar o servidor de gerenciamento da Apigee com o URL e as credenciais fornecidos.
   • Tempo de inicialização: se houver milhares de implantações no seu ambiente do Apigee, o conector do hub do Apigee poderá levar de 20 a 30 minutos para ser iniciado.
2. Os metadados da API não aparecem no hub de API:
   • Registros do conector: analise os registros opdk-connector para saber se ele pode acessar o tópico do Pub/Sub de metadados da API e chamar o servidor de gerenciamento.
   • Status do upload: verifique a saída curl localhost:8080/v1/uapim/status. Procure a seção APIMetadata.
     • O lastUpdated é recente?
     • O errorCount está aumentando de forma consistente?
     • Em que estágio ele está?
   • Exceções/erros: pesquise nos registros exceções ou erros relacionados ao processamento de metadados.
3. Os dados de ambiente de execução não aparecem no hub de APIs:
   • Registros do conector: verifique se o opdk-connector pode acessar o tópico do Pub/Sub de execução e chamar o servidor de gerenciamento.
   • Status do upload: use o comando curl localhost:8080/v1/uapim/status. Concentre-se na seção RuntimeData.
     • O lastUpdated é recente?
     • O errorCount está aumentando de forma consistente?
   • Exceções/erros: procure exceções ou erros nos registros relacionados ao processamento de dados de tempo de execução.
   • Configuração do processador de mensagens: verifique se o message-processor-communication.properties está configurado corretamente em todos os MPs para gravação dupla e se os MPs foram reiniciados.
   • Montagem do NFS: verifique se a montagem do NFS está configurada corretamente e acessível pelos MPs e pelo conector UAPIM.
4. O proxy foi implantado, mas as informações no hub da API não estão corretas:
   • Tempo de espera: aguarde alguns minutos para que os dados sejam propagados.
   • Registros: verifique os registros do opdk-connector para informações sobre proxies enviados. Isso pode ajudar a identificar se o conector está processando os eventos de implantação.