Powiadomienia o przychodach nie działają

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X.
info

Krótki opis problemu

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

Komunikat o błędzie

E-maile z powiadomieniami o zarabianiu nie będą wysyłane do subskrybentów. Nie będą wyświetlane żadne komunikaty o błędach.

Informacje o powiadomieniach o zdarzeniach związanych z zarabianiem

Zarabianie obsługuje powiadomienia o zdarzeniach, które umożliwiają:

  1. informowanie wszystkich deweloperów o zdarzeniach takich jak nowe produkty, nowe wersje Warunków korzystania z usługi czy nowe plany taryfowe;
  2. informowanie wybranych deweloperów o zdarzeniach takich jak opublikowanie dokumentu rozliczeniowego lub osiągnięcie określonego procenta docelowej liczby transakcji (jeśli kupili plan taryfowy z możliwością dostosowania powiadomień);
  3. informowanie dostawcy interfejsu API o zdarzeniach związanych z deweloperami, np. o zarejestrowaniu konta przez dewelopera lub o zarejestrowaniu się dewelopera w planie taryfowym;
  4. więcej informacji o typach powiadomień i sposobach ich konfigurowania znajdziesz tutaj.

Wymagania wstępne

Upewnij się, że spełniasz te wymagania wstępne:

  1. Akceptacja planu taryfowego

    W przypadku tych powiadomień o zarabianiu sprawdź, czy deweloperzy zaakceptowali odpowiedni plan taryfowy :

    1. Nowy plan taryfowy
    2. Zmieniony plan taryfowy
    3. Wygasły plan taryfowy
    4. Odnawiany plan taryfowy
    5. Przekroczono limit częstotliwości
    6. Wyczerpany plan taryfowy Freemium

      Jeśli deweloper nie zaakceptował planu taryfowego, te powiadomienia nie będą się wyświetlać.

  2. Harmonogram zadań powinien być uruchomiony w przypadku konkretnego powiadomienia

    Zarabianie udostępnia harmonogram zadań i zestaw zadań, które są wstępnie zaplanowane do uruchamiania w określonych godzinach. Harmonogram zadań musi być uruchomiony w przypadku konkretnego powiadomienia. Jeśli nie zostanie uruchomiony, powiadomienia nie będą się wyświetlać.

    1. Aby sprawdzić, czy zaplanowane zadanie dla konkretnego powiadomienia zostało uruchomione, postępuj zgodnie z instrukcjami podanymi w tym dokumencie:

      Planowanie zadań związanych z zarabianiem

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

    2. Jeśli zaplanowane zadanie dla konkretnego powiadomienia zostało już uruchomione, ale nadal nie otrzymujesz powiadomień, przejdź do sekcji Możliwe przyczyny, aby rozwiązać ten problem.
    3. W przeciwnym razie poczekaj, aż zaplanowane zadanie dla konkretnego powiadomienia zostanie uruchomione.

Możliwe przyczyny

Oto niektóre możliwe przyczyny tego problemu:

Przyczyna Opis Instrukcje rozwiązywania problemów, które mają zastosowanie do
Nieprawidłowa konfiguracja SMTP Podana konfiguracja SMTP jest nieprawidłowa. Użytkownicy Edge Private Cloud

Harmonogram zadań powiadomień

Zadanie powiadomienia nie zostało uruchomione. Użytkownicy Edge Public Cloud i Private Cloud

Przyczyna 1. Nieprawidłowa konfiguracja SMTP

Diagnoza

  1. Sprawdź plik /opt/apigee/edge-mint-management-server/conf/apix-mint.properties i upewnij się, że te 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 są ustawione, przejdź do kroku 3. Jeśli są prawidłowe, przejdź do kroku 4.
  3. Prawidłowo zaktualizuj ustawienia serwera SMTP i użytkownika, korzystając z instrukcji w tym dokumencie:

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

  4. Ponownie sprawdź, czy powiadomienia o zarabianiu działają. Jeśli nie, przejdź do kroku 5.
  5. Jeśli ustawienia SMTP są prawidłowe, uruchom wywołanie interfejsu API Wyświetl wysłane powiadomienia, aby sprawdzić stan wysłanego powiadomienia.
    1. Ten interfejs API zwraca plik JSON ze wszystkimi uruchomionymi powiadomieniami i ich stanem.
    2. Poniżej znajdziesz przykładowy plik JSON :
      {
              "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" : "..."
      }

      Jeśli sprawdzisz plik JSON, zobaczysz, że stan konkretnego powiadomienia „Zaktualizuj dewelopera” to „NIEUDANE”.

  6. Może to być spowodowane tym, że serwer SMTP i port nie są dostępne z serwera zarządzania. Użyj polecenia telnet, aby sprawdzić, czy możesz połączyć się z określonym serwerem SMTP na określonym porcie.
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    Jeśli w danych wyjściowych polecenia telnet pojawi się błąd „Connection timed out” (Przekroczono limit czasu połączenia) lub „Connection refused” (Odmowa połączenia), przejdź do sekcji Rozwiązanie.

Rozwiązanie

  1. Skontaktuj się z administratorem sieci i upewnij się, że serwer SMTP może akceptować połączenia z innych komputerów, a określony port jest otwarty na świat zewnętrzny.
  2. Jeśli problem nadal występuje, przejdź do sekcji Informacje diagnostyczne, które musisz zebrać.

Przyczyna 2. Harmonogram zadań powiadomień

Zadanie powiadomienia nie zostało uruchomione.

Diagnoza

  1. Uruchom to wywołanie interfejsu API, aby wyświetlić wszystkie aktualnie zaplanowane zadania związane z zarabianiem.

    /monetize/apis/get/triggers

  2. Sprawdź, czy warunek powiadomienia jest obecny i włączony w przypadku powiadomienia, które nie działa. Jeśli nie jest obecny, przejdź do kroku 3, aby utworzyć warunek powiadomienia, i pomiń pozostałe kroki.
    1. Jeśli jest obecny, sprawdź, czy jest włączony. Jeśli nie, uruchom interfejs API Aktualizuj warunek i działanie powiadomienia, aby zaktualizować warunek powiadomienia.

      LUB

    2. Użyj interfejsu, aby zaktualizować warunek powiadomienia, korzystając z procesu opisanego w tym dokumencie:

      Interfejs zdarzeń

    3. Uruchom wywołanie interfejsu API Utwórz warunek i działanie powiadomienia, aby utworzyć odpowiedni warunek powiadomienia i odpowiadające mu działanie.
      1. Po utworzeniu warunku powiadomienia uruchom wywołanie interfejsu API Wyświetl warunki i działania powiadomień, aby sprawdzić, czy warunek powiadomienia został utworzony.
      2. Możesz też ponownie przetworzyć powiadomienie za pomocą interfejsu API Ponownie przetwórz powiadomienie.
    4. Ten krok dotyczy tylko użytkowników Private Cloud. Jeśli warunek powiadomienia jest obecny od kroku 1, ale e-maile z powiadomieniami nadal nie przychodzą, sprawdź dziennik serwera zarządzania /opt/apigee/var/log/edge-management-server/logs/system.log i zobacz, czy warunek powiadomienia został uruchomiony.
      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 został uruchomiony, ale nadal nie otrzymujesz powiadomień, przejdź do sekcji Informacje diagnostyczne, które musisz zebrać, i podaj informacje oraz dane wyjściowe z powyższych kroków.

Rozwiązanie

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

Informacje diagnostyczne, które musisz zebrać

Jeśli problem nadal występuje po wykonaniu powyższych instrukcji, skontaktuj się z zespołem pomocy Apigee Edge i podaj te informacje diagnostyczne.

Użytkownicy Public Cloud i Private Cloud powinni podać te informacje:

  1. Nazwa organizacji
  2. Nazwa środowiska
  3. Warunek powiadomienia o zarabianiu, który nie działał
  4. Szczegółowe informacje o tym, które sekcje tego przewodnika zostały wypróbowane, 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