Powiadomienia o przychodach nie działają

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X.
informacje.

Krótki opis problemu

Powiadomienia o zarabianiu nie działają, więc e-maile nie są wysyłane do subskrybentów.

Komunikat o błędzie

E-maile z powiadomieniem o zarabianiu do subskrybentów nie będą wysyłane. Nie zostaną zarejestrowane żadne komunikaty o błędach.

Powiadomienia o zdarzeniach związanych z zarabianiem

Funkcja zarabiania obsługuje powiadomienia o wydarzeniach, dzięki którym możesz:

  1. Powiadamiaj wszystkich deweloperów o wydarzeniach takich jak nowe produkty, nowe wersje warunków lub plany cen.
  2. powiadamiać konkretnych deweloperów o zdarzeniach, np. opublikowaniu dokumentu rozliczeniowego lub osiągnięciu określonego odsetka transakcji (jeśli kupili abonament z możliwością dostosowania).
  3. powiadamiać dostawcę interfejsu API o wydarzeniach związanych z deweloperem, na przykład gdy deweloper zarejestruje się na konto lub zarejestruje się w celu skorzystania z abonamentu;
  4. Więcej informacji na temat rodzajów powiadomień i sposobu ich konfiguracji znajdziesz tutaj.

Wymagania wstępne

Upewnij się, że zostały spełnione te wymagania wstępne:

  1. Zatwierdzenie abonamentu

    Sprawdź, czy deweloperzy zaakceptowali te powiadomienia o zarabianiu :

    1. Nowy plan taryf
    2. Skorygowany plan taryf
    3. Wygasły abonament
    4. Odnowiony abonament
    5. Przekroczono limit liczby żądań
    6. Abonament Freemium ze zużyciem

      Jeśli deweloper nie zaakceptował abonamentu, te powiadomienia nie będą w jego przypadku wywoływane.

  2. Harmonogram zadań powinien być uruchomiony dla konkretnego powiadomienia

    Funkcja generowania przychodu udostępnia harmonogram zadań i zestaw zadań, które są z góry zaplanowane do uruchomienia w wyznaczonych godzinach. Dla określonego powiadomienia należy uruchomić algorytm szeregowania zadań. Jeśli nie jest prowadzona, powiadomienia nie będą wywoływane.

    1. Skorzystaj z instrukcji w poniższym dokumencie, aby sprawdzić, czy zaplanowane zadanie dla określonego powiadomienia zostało uruchomione:

      Planowanie zadań dotyczących zarabiania

      Uwaga: harmonogram zawsze możesz zmienić w zależności od swojego przypadku użycia.

    2. Jeśli zaplanowane zadanie dla danego powiadomienia zostało już uruchomione, ale nadal nie otrzymujesz powiadomień, przejdź do sekcji Możliwe przyczyny, aby dalej rozwiązywać ten problem.
    3. Jeśli tak nie jest, poczekaj, aż zostanie uruchomione zaplanowane zadanie dla określonego powiadomienia.

Możliwe przyczyny

Oto kilka możliwych przyczyn tego problemu:

Przyczyna Opis Instrukcje dotyczące rozwiązywania problemów dotyczące
Nieprawidłowa konfiguracja SMTP Podana konfiguracja SMTP jest nieprawidłowa. Użytkownicy Edge Private Cloud

Harmonogram zadań powiadomień

Zadanie powiadamiania nie zostało uruchomione. Użytkownicy chmury publicznej i prywatnej chmury brzegowej

Przyczyna 1. Nieprawidłowa konfiguracja SMTP

Diagnostyka

  1. Sprawdź plik /opt/apigee/edge-mint-management-server/conf/apix-mint.properties i upewnij się, że poniższe właściwości SMTP są prawidłowo ustawione.
    mint.notification.javaMail.properties={"mail.smtp.host": "smtp.gmail.com",
    "mail.smtp.port": "465", "mail.smtp.starttls.enable": "true", "mail.smtp.auth": "true", "mail.smtp.username": "blah@gmail.com", "mail.smtp.password": "blah" }
    
  2. Sprawdź, czy ustawienia serwera SMTP i użytkownika są prawidłowe. Jeśli te ustawienia są nieprawidłowe lub nie zostały skonfigurowane, przejdź do kroku 3. Jeśli wszystko się zgadza, przejdź do kroku 4.
  3. Wykonaj instrukcje w tym dokumencie, aby poprawnie zaktualizować ustawienia serwera SMTP i użytkownika:

    /private-cloud/latest/configuring-edge-smtp-server

  4. Sprawdź ponownie, czy powiadomienia o zarabianiu działają. Jeśli nie, przejdź do kroku 5.
  5. Jeśli ustawienia SMTP są poprawne, uruchom Wyświetl wysłane powiadomieniawywołania interfejsu API, aby sprawdzić stan wysłanego powiadomienia.
    1. Ten interfejs API zwraca plik JSON ze wszystkimi uruchomionymi powiadomieniami i stanem każdego z nich.
    2. Przykładowy plik JSON znajdziesz poniżej :
      {
              "hasMoreItems" : false,
              "notifications" : [ {
              "fromAlias" : "No Reply",
              "fromEmail" : "****@apigee.com",
              "id" : "4e2d0d9a-69a4-4430-957d-02fa2a3cb581",
              "notificationType" : "EMAIL",
              "orgId" : "myorg",
              "rawMessage" : "...",
              "retryCount" : 0,
              "retryStatuses" : [ {
                   "responseCode" : 0,
                   "responseMessage" : "{\"Headers\":null,\"Content : \":null,\"StatusCode\":\"0\"}",
                   "retriedAt" : 1518605291092,
                   "retryAttempt" : 0
              } ],
              "source" : "MailTo: [****@blah.com], Org: [myorg], EventType: [UPDATE_DEVELOPER]",
              "status" : "FAILED",
              "subject" : "Notification of developer changing company details",
              "templateId" : "814315c8-d8ca-4b3e-90bb-a8366600e625",
              "templateName" : "DEFAULT_UPDATE_DEVELOPER_TEMPLATE",
              "templateParametersJSON" : "{\"developer.legalName\":\"\",\"developer.name\":\"John Smith\"}",
              "toAlias" : "***@blah.com",
              "toEmail" : "***@blah.com",
              "unsubscribeURL" : "..."
      }
      

      W pliku JSON jest wyświetlany stan „FAILED” dotyczące tego powiadomienia: „Zaktualizuj dewelopera”.

  6. Przyczyną tej sytuacji może być to, że serwer SMTP i port są nieosiągalne z serwera zarządzania. Użyj polecenia telnet, aby sprawdzić, czy możesz połączyć się z określonym serwerem SMTP przez podany port.
    telnet <SMTP-server-IP-address> <SMTP-Port#>
    

    Jeśli pojawi się błąd „Upłynął limit czasu połączenia” lub „Połączenie odrzucone” aby uzyskać dane wyjściowe Telnet, a następnie przejdź do sekcji Rozwiązanie.

Rozdzielczość

  1. Skontaktuj się z administratorem sieci i upewnij się, że serwer SMTP może akceptować połączenia z innych komputerów oraz że dany port jest otwarty na komunikację z zewnątrz.
  2. Jeśli problem nadal występuje, przejdź do sekcji Musi zbierać informacje diagnostyczne wraz z

Przyczyna 2. Harmonogram zadań powiadomień

Zadanie powiadamiania nie zostało uruchomione.

Diagnostyka

  1. Aby wyświetlić wszystkie aktualnie zaplanowane zadania związane z generowaniem przychodu, uruchom to wywołanie interfejsu API.

    /monetize/apis/get/triggers

  2. Sprawdź, czy warunek powiadomienia jest obecny i jest włączony w przypadku niedziałającego powiadomienia. Jeśli go nie ma, przejdź do kroku 3, aby utworzyć warunek powiadomienia, i pomiń pozostałe kroki.
    1. Jeśli jest dostępny, sprawdź, czy ma wartość true (prawda). Jeśli nie, wykonaj instrukcje aktualizacji warunku powiadomienia i interfejsu API działania, aby zaktualizować warunek powiadomienia.

      LUB

    2. Zaktualizuj warunek powiadomienia w interfejsie, korzystając z procesu opisanego w tym dokumencie:

      Interfejs zdarzeń

    3. Uruchom wywołanie interfejsu Create a notification API and action API, aby utworzyć odpowiedni warunek powiadomienia i odpowiadające mu działanie.
      1. Po utworzeniu warunku powiadomienia uruchom wywołanie interfejsu List notification termin and actions API, aby sprawdzić, czy warunek powiadomienia został utworzony.
      2. Powiadomienie możesz też przetworzyć ponownie, używając Reprocess a Notification API.
    4. Ten krok dotyczy tylko użytkowników Private Cloud. Jeśli warunek powiadomienia jest obecny w kroku 1, a e-maile z powiadomieniami nadal nie są wysyłane, sprawdź dziennik serwera zarządzania /opt/apigee/var/log/edge-management-server/logs/system.log i sprawdź, czy warunek powiadomienia został spełniony.
      grep "Executing Mint Scheduler" /opt/apigee/var/log/edge-management-server/logs/system.log | grep  -o  "Executing Mint Scheduler : \[.*\]" | grep -v "for org : \[null\]" |sort | uniq -c
      
    5. Jeśli warunek powiadomienia jest aktywny, ale nadal nie otrzymujesz powiadomień, przejdź do sekcji Wymagane zbieranie informacji diagnostycznych wraz z informacjami i wynikami opisanymi powyżej.

Rozwiązanie

  1. Ponownie przetwórz powiadomienie za pomocą interfejsu Reprocess a Notification API.

Musi zbierać informacje diagnostyczne

Jeśli po wykonaniu powyższych czynności problem nie ustąpi, skontaktuj się z zespołem pomocy Apigee Edge oraz podaj poniższe informacje diagnostyczne.

Użytkownicy chmury publicznej i prywatnej powinni podać te informacje:

  1. Nazwa organizacji
  2. Nazwa środowiska
  3. Warunek powiadomienia o możliwości zarabiania nie zadziałał
  4. Szczegółowe informacje o wypróbowanych sekcjach tego Poradnika oraz inne informacje, które pomogą nam szybciej rozwiązać ten problem.

Oprócz powyższych informacji użytkownicy Private Cloud powinni też podać te informacje:

  • Dziennik serwera zarządzania

    /opt/apigee/var/log/edge-management-server/logs/system.log