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

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

Dane wyjściowe zawierają informacje o:

• Metadane interfejsu API: stan przesyłania metadanych interfejsu API, w tym organizacja, środowisko, bieżący etap (np. „Przesyłanie zbiorcze”, „Streaming”, „Jeszcze się nie rozpoczęło”), łączna liczba przesłanych/ukończonych/oczekujących plików, 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ź dzienniki łącznika i punkt końcowy stanu. Główny plik dziennika złącza 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: w logach wyszukaj wyjątki lub błędy związane z przetwarzaniem metadanych.
3. Dane środowiska wykonawczego 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: upewnij się, że message-processor-communication.properties jest prawidłowo skonfigurowany na wszystkich procesorach wiadomości na potrzeby podwójnego zapisu i że 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 dla łą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.