Le notifiche sulla monetizzazione non funzionano

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Sintomo

Le notifiche di monetizzazione non funzionano, pertanto non vengono inviate email agli utenti iscritti.

Messaggio di errore

Le email relative alle notifiche di monetizzazione inviate agli iscritti non verranno inviate. Non verrà osservato alcun messaggio di errore.

Informazioni sulle notifiche degli eventi di monetizzazione

La monetizzazione supporta le notifiche di eventi, che ti consentono di:

  1. Avvisa tutti gli sviluppatori in merito a eventi quali nuovi prodotti, nuove versioni dei termini e condizioni o nuovi piani tariffari.
  2. Avvisare sviluppatori specifici in merito a eventi quali la pubblicazione di un documento di fatturazione o il raggiungimento di una percentuale del numero di transazioni target (se hanno acquistato un piano con tasso di notifica regolabile).
  3. Avvisare un fornitore di API in merito a eventi relativi allo sviluppatore, ad esempio quando uno sviluppatore si registra a un account o quando sottoscrive un piano tariffario.
  4. Puoi trovare ulteriori dettagli sul tipo di notifiche presenti e su come configurarle qui.

Prerequisiti

Assicurati che siano soddisfatti i seguenti prerequisiti:

  1. Accettazione del piano tariffario

    Per le seguenti notifiche di monetizzazione, controlla se gli sviluppatori hanno accettato il piano tariffario corrispondente :

    1. Nuovo piano tariffario
    2. Piano tariffario rivisto
    3. Piano tariffario scaduto
    4. Piano tariffario rinnovato
    5. Limite di frequenza superato
    6. Piano tariffario freemium esaurito

      Se lo sviluppatore non ha accettato il piano tariffario, queste notifiche non verranno attivate per quello specifico sviluppatore.

  2. Il programma di pianificazione job deve essere eseguito per la specifica Notification

    La monetizzazione fornisce uno strumento di pianificazione dei job e un insieme di job preprogrammati per l'esecuzione in orari prestabiliti. Lo scheduler del job deve essere eseguito per una notifica specifica. In caso contrario, le notifiche non verranno attivate.

    1. Utilizza le istruzioni fornite nel seguente documento per verificare se il job pianificato per una notifica specifica è stato eseguito:

      Pianificare job di monetizzazione

      Nota:puoi sempre modificare la programmazione in base al tuo caso d'uso.

    2. Se il job programmato per la notifica specifica è già stato eseguito e continui a non ricevere le notifiche, vai alla sezione Possibili cause per risolvere ulteriormente il problema.
    3. In caso contrario, attendi fino all'esecuzione del job pianificato per la notifica specifica.

Possibili cause

Ecco alcune delle possibili cause di questo problema:

Causa Descrizione Istruzioni per la risoluzione dei problemi applicabili per
Configurazione SMTP errata La configurazione SMTP fornita non è corretta. Utenti del cloud privato perimetrale

Pianificazione del job di notifica

 Il job di notifica non è stato avviato. Utenti di cloud pubblico perimetrale e cloud privato

Causa 1: configurazione SMTP errata

Diagnosi

  1. Controlla il file /opt/apigee/edge-mint-management-server/conf/apix-mint.properties e verifica che le seguenti proprietà SMTP siano impostate correttamente. 
    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. Verifica che le impostazioni utente e del server SMTP siano corrette. Se queste impostazioni non sono corrette o non sono configurate, vai al passaggio 3. Se è corretto, vai al passaggio 4.
  3. Aggiorna correttamente il server SMTP e le impostazioni utente utilizzando le istruzioni riportate nel seguente documento:

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

  4. Ricontrolla se le Notifiche di monetizzazione funzionano ora. In caso contrario, vai al passaggio 5.
  5. Se le impostazioni SMTP sono corrette, esegui la chiamata API Visualizza notifiche inviate per controllare lo stato della notifica inviata.
    1. Questa API restituisce un JSON con tutte le notifiche attivate e lo stato di ciascuna.
    2. Di seguito è riportato un esempio di 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" : "..."
}

      Se controlli il file JSON, lo stato visualizzato sarà "FAILED" per la notifica "Update Developer" indicata sopra.

  6. La causa potrebbe essere che il server SMTP e la porta potrebbero non essere raggiungibili dal server di gestione. Utilizza il comando telnet per verificare se riesci a connetterti al server SMTP specificato sulla porta specificata. 
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    Se viene visualizzato l'errore "Connessione scaduta" o "Connessione rifiutata" per l'output Telnet, vai alla risoluzione.

Risoluzione

  1. Collabora con l'amministratore di rete e assicurati che il server SMTP sia in grado di accettare connessioni da altri computer e che la porta specifica sia aperta all'esterno per la comunicazione.
  2. Se il problema persiste, vai alla sezione "Devi raccogliere informazioni diagnostiche" con il

Causa 2: pianificazione del job di notifica

Il job di notifica non è stato avviato.

Diagnosi

  1. Esegui la seguente chiamata API per visualizzare tutti i job di monetizzazione attualmente pianificati.

    /monetize/apis/get/triggers

  2. Controlla se la condizione di notifica è presente e abilitata per la notifica che non funziona. Se non è presente, vai al passaggio 3 per creare la condizione di notifica e ignora gli altri passaggi.
    1. Se è presente, verifica se è attivato su true. In caso contrario, esegui l'API Update a notification condizione and Action per aggiornare la condizione di notifica.

      OPPURE

    2. Utilizza l'interfaccia utente per aggiornare la condizione di notifica utilizzando la procedura fornita nel documento riportato di seguito:

      UI Eventi

    3. Esegui la chiamata Crea una condizione di notifica e un'API di azione per creare la condizione di notifica appropriata e l'azione corrispondente.
      1. Una volta creata la condizione di notifica, esegui la chiamata all'API List notifica condizioni e azioni per verificare se la condizione di notifica è stata creata.
      2. Puoi anche rielaborare la notifica utilizzando Rielabora un'API di notifica.
    4. Questo passaggio è applicabile solo per gli utenti Private Cloud. Se nel passaggio 1 è presente la condizione di notifica, ma non ricevi ancora le email di notifica, controlla il log del server di gestione /opt/apigee/var/log/edge-management-server/logs/system.log per verificare se la condizione di notifica è stata attivata. 
      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. Se la condizione di notifica viene attivata, ma ancora non ricevi le notifiche, vai alla sezione Raccogliere informazioni diagnostiche con informazioni e output dei passaggi precedenti acquisiti.

Risoluzione

  1. Rielabora la notifica utilizzando l'API Rielabora un'API di notifica

Raccogliere informazioni diagnostiche

Se il problema persiste anche dopo aver seguito le istruzioni riportate sopra, contatta l'assistenza Apigee Edge e fornisci le seguenti informazioni diagnostiche.

Gli utenti del cloud pubblico e privato devono fornire le seguenti informazioni:

  1. Nome organizzazione
  2. Nome ambiente
  3. Condizione della notifica di monetizzazione non funzionante
  4. Dettagli sulle sezioni di questa guida pratica messe a punto e altri approfondimenti che ci aiuteranno a risolvere il problema in modo rapido.

Oltre a queste informazioni, gli utenti di Private Cloud devono fornire anche le seguenti informazioni:

  • Log del server di gestione

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