Verificar o status e os erros do upload

É possível verificar o status dos uploads de metadados e dados de execução a qualquer momento consultando o endpoint de status local do conector do Apigee API Hub para Private Cloud.

Verificando o status do upload

Use o seguinte comando curl na máquina virtual que executa o conector do Apigee API Hub para nuvem privada:

curl localhost:8080/v1/uapim/status

    {
      "APIMetadata": [
        {
          "organization": "test",
          "environment": "dev",
          "stage": "BULK_TRANSFER",
          "totalDeployments": 100,
          "completed": 10,
          "lastUpdated": "04-16-2025 00:56:45",
          "errors": 0
        },
        {
          "organization": "test",
          "environment": "prod",
          "stage": "STREAMING",
          "pendingUploads": 10,
          "errors": 1,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "stage": "Yet to Start",
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ],
      "RuntimeData": [
        {
          "organization": "test",
          "environment": "dev",
          "errorCount": 2,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test",
          "environment": "prod",
          "errorCount": 4,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "errorCount": 0,
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ]
    }

A saída fornece insights sobre:

• Metadados da API: status dos uploads de metadados da API, incluindo organização, ambiente, estágio atual (por exemplo, "Transferência em massa", "Streaming", "Ainda não começou"), 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.
   • Verificar 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 pode 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 eles 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.