Le notifiche sulla monetizzazione non funzionano

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Sintomo

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

Messaggio di errore

Le email di notifica relative alla monetizzazione agli utenti iscritti non verranno inviate. Non verrà visualizzato alcun messaggio di errore.

Informazioni sulle notifiche degli eventi di monetizzazione

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

  1. Avvisa tutti gli sviluppatori in caso di eventi quali nuovi prodotti, nuove versioni di Termini e condizioni o nuovi piani tariffari.
  2. Avvisare specifici sviluppatori di eventi come la pubblicazione di un documento di fatturazione o il raggiungimento di una percentuale del numero target di transazioni (se hanno acquistato un piano tariffario di notifica regolabile).
  3. Avvisare un fornitore di API in caso di eventi relativi allo sviluppatore, ad esempio la registrazione di un account o la sottoscrizione di un piano tariffario.
  4. Ulteriori dettagli sul tipo di notifiche disponibili e su come impostarle sono disponibili qui.

Prerequisiti

Assicurati che siano stati 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 lo sviluppatore in questione.

  2. Il job Scheduler deve essere eseguito per la notifica specifica

    La monetizzazione fornisce un programma di pianificazione dei job e una serie di job pre-programmati per essere eseguiti a orari prestabiliti. Il programma di pianificazione del 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 è stato eseguito il job pianificato per una notifica specifica:

      Pianificare i job di monetizzazione

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

    2. Se il job pianificato 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 l'esecuzione del job pianificato per la notifica specifica.

Possibili cause

Di seguito sono riportate alcune delle possibili cause:

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

Pianificazione del job di notifica

 Il job di notifica non è stato avviato. Utenti perimetrali di cloud pubblico 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 sono errate o non sono configurate, vai al passaggio 3. Se è corretto, vai al passaggio 4.
  3. Aggiorna correttamente il server SMTP e le impostazioni utente seguendo le istruzioni riportate nel seguente documento:

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

  4. Ricontrolla se ora le notifiche Monetizzazione funzionano. In caso contrario, vai al passaggio 5.
  5. Se le impostazioni SMTP sono corrette, esegui la chiamata API View notifications sent (Visualizza notifiche inviate) per controllare lo stato della notifica inviata.
    1. Questa API restituisce un JSON con tutte le notifiche che sono state attivate e lo stato di ognuna.
    2. Di seguito è riportato un JSON di esempio : 
      {
        "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 è "NON RIUSCITA" per la precedente notifica "Aggiornamento dello sviluppatore".

  6. Ciò potrebbe essere dovuto al fatto che il server e la porta SMTP non sono 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 "Sessione di connessione scaduta" o "Connessione rifiutata" per l'output telnet, quindi passa a 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 al mondo esterno per la comunicazione.
  2. Se il problema persiste, vai alla sezione Raccogliere le informazioni diagnostiche specificando

Causa 2: pianificazione del job di notifica

Il job di notifica non è stato avviato.

Diagnosi

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

    /monetize/apis/get/triggers

  2. Controlla se la condizione di notifica è presente e se è abilitata per la notifica che non funziona. Se non è presente, vai al passaggio 3 per creare la condizione di notifica e salta gli altri passaggi.
    1. Se è presente, controlla se è impostato su true. Se non è così, esegui l'API Update a notification status and Action per aggiornare la condizione di notifica.

      OPPURE

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

      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 Elenca condizioni e azioni di notifica per verificare se la condizione di notifica è stata creata.
      2. Puoi rielaborare la notifica anche utilizzando l'API Rielabora un'API di notifica.
    4. Questo passaggio è applicabile solo per gli utenti del Private Cloud. Se la condizione di notifica è presente nel passaggio 1 e le email di notifica continuano a non essere ricevute, 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 continui a non ricevere le notifiche, vai a Raccogliere informazioni diagnostiche con le informazioni e gli output dei passaggi precedenti acquisiti.

Risoluzione

  1. Rielabora la notifica utilizzando l'API Rielabora una 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 dell'organizzazione
  2. Nome ambiente
  3. Condizione della notifica di monetizzazione non funzionante
  4. Dettagli sulle sezioni di questo playbook che abbiamo provato e su eventuali altri approfondimenti che ci aiuteranno a risolvere rapidamente il problema.

Oltre alle informazioni precedenti, gli utenti di Private Cloud devono anche fornire le seguenti informazioni:

  • Log del server di gestione

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