Controllare lo stato del caricamento e gli errori

Puoi controllare lo stato dei caricamenti dei metadati e dei dati di runtime in qualsiasi momento eseguendo una query sull'endpoint di stato locale del connettore Apigee API Hub for Private Cloud.

Controllo dello stato del caricamento

Utilizza il seguente comando curl sulla macchina virtuale che esegue il connettore Apigee API Hub for Private Cloud:

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

L'output fornisce informazioni su:

• Metadati API: stato dei caricamenti dei metadati API, inclusi organizzazione, ambiente, fase attuale (ad esempio "Trasferimento collettivo", "Streaming", "Ancora da avviare"), caricamenti totali/completati/in attesa, conteggio degli errori e ora dell'ultimo aggiornamento.
• Metadati di runtime: stato dei caricamenti dei dati di runtime, che mostra l'organizzazione, l'ambiente, il conteggio degli errori e l'ora dell'ultimo aggiornamento.

Problemi comuni e procedure di risoluzione dei problemi

Se riscontri problemi, consulta i log del connettore e l'endpoint di stato. Il file di log principale per il connettore hub Apigee si trova in /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

1. Il connettore Apigee API Hub for Private Cloud non si avvia:
   • Controlla i log: esamina /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log per individuare messaggi di errore relativi alla configurazione.
   • Verifica le impostazioni: controlla tutte le impostazioni configurate in uapim-connector.properties e le variabili di ambiente.
   • Accesso a Pub/Sub: verifica nei log se opdk-connector è in grado di accedere agli argomenti Pub/Sub forniti.
   • Accesso al server di gestione: controlla i log per verificare se opdk-connector può chiamare correttamente il server di gestione Apigee con l'URL e le credenziali specificati.
   • Tempo di avvio: se nell'ambiente Apigee sono presenti migliaia di deployment, l'avvio del connettore hub Apigee può richiedere circa 20-30 minuti.
2. I metadati dell'API non vengono visualizzati nell'hub API:
   • Log del connettore: esamina i log di opdk-connector per verificare se può accedere all'argomento Pub/Sub dei metadati API e chiamare il server di gestione.
   • Stato caricamento: controlla l'output di curl localhost:8080/v1/uapim/status. Cerca la sezione APIMetadata.
     • Is lastUpdated recent?
     • Il valore errorCount aumenta costantemente?
     • In che fase si trova?
   • Eccezioni/errori: cerca nei log eventuali eccezioni o errori generati relativi all'elaborazione dei metadati.
3. I dati di runtime non vengono visualizzati nell'hub API:
   • Log del connettore: controlla se opdk-connector può accedere all'argomento Pub/Sub di runtime e chiamare il server di gestione.
   • Stato caricamento: utilizza il comando curl localhost:8080/v1/uapim/status. Concentrati sulla sezione RuntimeData.
     • Is lastUpdated recent?
     • Il valore errorCount aumenta costantemente?
   • Eccezioni/errori: cerca eventuali eccezioni o errori nei log relativi all'elaborazione dei dati di runtime.
   • Configurazione del processore di messaggi: assicurati che message-processor-communication.properties sia configurato correttamente su tutti i processori di messaggi per la scrittura doppia e che i processori di messaggi siano stati riavviati.
   • Montaggio NFS: verifica che il montaggio NFS sia configurato correttamente e accessibile sia dai MP che dal connettore UAPIM.
4. Proxy di cui è stato eseguito il deployment, ma le informazioni nell'hub API non sono accurate:
   • Tempo di attesa: attendi qualche minuto affinché i dati vengano propagati.
   • Log: controlla i log di opdk-connector per informazioni sui proxy caricati. Questo può aiutarti a capire se il connettore sta elaborando gli eventi di deployment.