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ą:
- informowanie wszystkich deweloperów o zdarzeniach takich jak nowe produkty, nowe wersje Warunków korzystania z usługi czy nowe plany taryfowe;
- 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ń);
- informowanie dostawcy interfejsu API o zdarzeniach związanych z deweloperami, np. o zarejestrowaniu konta przez dewelopera lub o zarejestrowaniu się dewelopera w planie taryfowym;
- więcej informacji o typach powiadomień i sposobach ich konfigurowania znajdziesz tutaj.
Wymagania wstępne
Upewnij się, że spełniasz te wymagania wstępne:
- Akceptacja planu taryfowego
W przypadku tych powiadomień o zarabianiu sprawdź, czy deweloperzy zaakceptowali odpowiedni plan taryfowy :
- Nowy plan taryfowy
- Zmieniony plan taryfowy
- Wygasły plan taryfowy
- Odnawiany plan taryfowy
- Przekroczono limit częstotliwości
- Wyczerpany plan taryfowy Freemium
Jeśli deweloper nie zaakceptował planu taryfowego, te powiadomienia nie będą się wyświetlać.
- 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ć.
- 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.
- 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.
- W przeciwnym razie poczekaj, aż zaplanowane zadanie dla konkretnego powiadomienia zostanie uruchomione.
- Aby sprawdzić, czy zaplanowane zadanie dla konkretnego powiadomienia zostało uruchomione, postępuj zgodnie z instrukcjami podanymi w tym dokumencie:
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 |
| Zadanie powiadomienia nie zostało uruchomione. | Użytkownicy Edge Public Cloud i Private Cloud |
Przyczyna 1. Nieprawidłowa konfiguracja SMTP
Diagnoza
- Sprawdź plik
/opt/apigee/edge-mint-management-server/conf/apix-mint.propertiesi 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" }
- 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.
- Prawidłowo zaktualizuj ustawienia serwera SMTP i użytkownika, korzystając z instrukcji w tym dokumencie:
- Ponownie sprawdź, czy powiadomienia o zarabianiu działają. Jeśli nie, przejdź do kroku 5.
- Jeśli ustawienia SMTP są prawidłowe, uruchom wywołanie interfejsu API Wyświetl wysłane powiadomienia, aby sprawdzić stan wysłanego powiadomienia.
- Ten interfejs API zwraca plik JSON ze wszystkimi uruchomionymi powiadomieniami i ich stanem.
- 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”.
- 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
- 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.
- 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
- Uruchom to wywołanie interfejsu API, aby wyświetlić wszystkie aktualnie zaplanowane zadania związane z zarabianiem.
- 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.
- 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
- Użyj interfejsu, aby zaktualizować warunek powiadomienia, korzystając z procesu opisanego w tym dokumencie:
- Uruchom wywołanie interfejsu API Utwórz warunek i działanie powiadomienia, aby utworzyć odpowiedni warunek powiadomienia i odpowiadające mu działanie.
- Po utworzeniu warunku powiadomienia uruchom wywołanie interfejsu API Wyświetl warunki i działania powiadomień, aby sprawdzić, czy warunek powiadomienia został utworzony.
- Możesz też ponownie przetworzyć powiadomienie za pomocą interfejsu API Ponownie przetwórz powiadomienie.
- 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.logi 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
- 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.
- 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.
Rozwiązanie
- 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:
- Nazwa organizacji
- Nazwa środowiska
- Warunek powiadomienia o zarabianiu, który nie działał
- 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