Sprawdzanie stanu przesyłania i błędów

Stan przesyłania metadanych i danych środowiska wykonawczego możesz w każdej chwili sprawdzić, wysyłając zapytanie do lokalnego punktu końcowego stanu złącza Apigee API Hub for Private Cloud.

Sprawdzanie stanu przesyłania

Na maszynie wirtualnej, na której działa oprogramowanie sprzęgające Apigee API Hub for Private Cloud, użyj tego polecenia curl:

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

Dane wyjściowe zawierają informacje o:

• Metadane interfejsu API: stan przesyłania metadanych interfejsu API, w tym organizacja, środowisko, bieżący etap (np. „Przygotowywanie”, „Przetwarzanie”, „W kolejce”), łączna liczba przesłanych/ukończonych/oczekujących przesłań, liczba błędów i czas ostatniej aktualizacji.
• Metadane środowiska wykonawczego: stan przesyłania danych środowiska wykonawczego, z informacjami o organizacji, środowisku, liczbie błędów i czasie ostatniej aktualizacji.

Typowe problemy i instrukcje rozwiązywania

Jeśli napotkasz problemy, sprawdź logi łącznika i punkt końcowy stanu. Główny plik dziennika narzędzia do łączenia z centrum Apigee znajduje się w lokalizacji /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

1. Łącznik centrum interfejsów API Apigee dla chmury prywatnej nie uruchamia się:
   • Sprawdź logi: przejrzyj /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log pod kątem komunikatów o błędach związanych z konfiguracją.
   • Sprawdź ustawienia: dokładnie sprawdź wszystkie skonfigurowane ustawienia na stronie uapim-connector.properties i zmienne środowiskowe.
   • Dostęp do Pub/Sub: sprawdź w logach, czy opdk-connector ma dostęp do podanych tematów Pub/Sub.
   • Dostęp do serwera zarządzania: sprawdź dzienniki, aby dowiedzieć się, czy opdk-connector może wywołać serwer zarządzania Apigee za pomocą podanego adresu URL i danych logowania.
   • Czas uruchamiania: jeśli w środowisku Apigee są tysiące wdrożeń, uruchomienie łącznika centrum Apigee może zająć około 20–30 minut.
2. Metadane interfejsu API nie są widoczne w centrum interfejsów API:
   • Logi konektora: sprawdź logi opdk-connector, aby zobaczyć, czy ma on dostęp do tematu Pub/Sub z metadanymi interfejsu API i czy może wywołać serwer zarządzania.
   • Stan przesyłania: sprawdź dane wyjściowe curl localhost:8080/v1/uapim/status. Znajdź sekcję APIMetadata.
     • Czy lastUpdated jest aktualny?
     • Czy wartość errorCount stale rośnie?
     • Na jakim etapie jest projekt?
   • Wyjątki/błędy: wyszukaj w logach wyjątki lub błędy związane z przetwarzaniem metadanych.
3. Dane czasu działania nie są widoczne w centrum interfejsów API:
   • Dzienniki łącznika: sprawdź, czy łącznik opdk ma dostęp do tematu Pub/Sub środowiska wykonawczego i czy może wywoływać serwer zarządzania.
   • Status przesyłania: użyj polecenia curl localhost:8080/v1/uapim/status. Skup się na sekcji RuntimeData.
     • Czy lastUpdated jest aktualny?
     • Czy wartość errorCount stale rośnie?
   • Wyjątki/błędy: w logach związanych z przetwarzaniem danych w czasie działania wyszukaj wyjątki i błędy.
   • Konfiguracja procesora wiadomości: sprawdź, czy parametr message-processor-communication.properties jest prawidłowo skonfigurowany na wszystkich procesorach wiadomości w przypadku zapisu dwukierunkowego i czy procesory wiadomości zostały ponownie uruchomione.
   • Podłączenie NFS: sprawdź, czy podłączenie NFS jest prawidłowo skonfigurowane i dostępne zarówno dla procesorów MP, jak i łącznika UAPIM.
4. Serwer proxy został wdrożony, ale informacje w centrum interfejsów API są nieprawidłowe:
   • Czas oczekiwania: poczekaj kilka minut, aż dane zostaną rozpowszechnione.
   • Dzienniki: sprawdź dzienniki opdk-connector, aby uzyskać informacje o przesłanych serwerach proxy. Może to pomóc w określeniu, czy oprogramowanie sprzęgające przetwarza zdarzenia wdrożenia.