Le notifiche sulla monetizzazione non funzionano

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Sintomo

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

Messaggio di errore

Le email relative alle notifiche di monetizzazione alle persone iscritte non verranno inviate. Non verranno visualizzati messaggi di errore.

Informazioni sulle notifiche degli eventi di monetizzazione

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

  1. Notificare a tutti gli sviluppatori eventi come nuovi prodotti, nuove versioni dei Termini e condizioni o nuovi piani tariffari.
  2. Notificare a sviluppatori specifici eventi come la pubblicazione di un documento di fatturazione o il raggiungimento di una percentuale del numero di transazioni target (se hanno acquistato un piano tariffario di notifica regolabile).
  3. Notificare a un fornitore di API eventi relativi agli sviluppatori, ad esempio quando uno sviluppatore registra un account o si registra a un piano tariffario.
  4. Ulteriori dettagli sul tipo di notifiche e su come configurarle sono disponibili 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 traffico superato
    6. Piano tariffario freemium esaurito

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

  2. Lo scheduler dei job deve essere eseguito per la notifica specifica

    La monetizzazione fornisce uno scheduler dei job e un insieme di job pre-pianificati per l'esecuzione in orari predefiniti. Lo scheduler dei job deve essere eseguito per una notifica specifica. Se non viene eseguito, le notifiche non verranno attivate.

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

      Pianificare i job di monetizzazione

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

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

Possibili cause

Ecco alcune delle possibili cause di questo problema:

Causa Descrizione Istruzioni per la risoluzione dei problemi applicabili a
Configurazione SMTP errata La configurazione SMTP fornita non è corretta. Utenti di Edge Private Cloud

Pianificazione dei job di notifica

 Il job di notifica non è stato avviato. Utenti di Edge Public Cloud e Private Cloud

Causa 1: configurazione SMTP errata

Diagnosi

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

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

  4. Controlla di nuovo 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 visualizzare lo stato della notifica inviata.
    1. Questa API restituisce un JSON con tutte le notifiche attivate e lo stato di ognuna di esse.
    2. Di seguito è riportato un sample 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 JSON, lo stato della notifica specifica "Aggiorna sviluppatore" è "FAILED".

  6. Questo potrebbe essere dovuto al fatto che il server e la porta SMTP 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 "Timeout della connessione" o "Connessione rifiutata" per l'output di telnet, vai alla sezione Risoluzione.

Risoluzione

  1. Collabora con l'amministratore di rete e assicurati che il server SMTP sia in grado di accettare connessioni da altre macchine e che la porta specifica sia aperta al mondo esterno per la comunicazione.
  2. Se il problema persiste, vai a Raccogliere le informazioni di diagnostica necessarie con le

Causa 2: pianificazione dei 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 ed è abilitata per la notifica che non funziona. Se non è presente, vai al passaggio 3 per creare la condizione di notifica e salta il resto dei passaggi.
    1. Se è presente, controlla se è impostata su true. In caso contrario, esegui l'API Aggiorna una condizione e un'azione di notifica per aggiornare la condizione di notifica.

      OPPURE

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

      Interfaccia utente Eventi

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

Risoluzione

  1. Rielabora la notifica utilizzando l'API Rielabora una notifica.

Raccogliere le informazioni di diagnostica necessarie

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

Gli utenti di Public Cloud e Private Cloud devono fornire le seguenti informazioni:

  1. Nome dell'organizzazione
  2. Nome ambiente
  3. Condizione di notifica di monetizzazione che non ha funzionato
  4. Dettagli sulle sezioni di questa guida che hai provato e su eventuali altre informazioni che ci aiuteranno ad accelerare la risoluzione del problema.

Oltre alle informazioni sopra riportate, 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