Las notificaciones de monetización no funcionan

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Síntoma

Las notificaciones de monetización no funcionan y, por lo tanto, no se envían correos electrónicos a los usuarios suscritos.

Mensaje de error

No se enviarán los correos electrónicos sobre las notificaciones de monetización a los usuarios suscritos. No se observarán mensajes de error.

Acerca de las notificaciones de eventos de monetización

La monetización es compatible con notificaciones de eventos que te permiten hacer lo siguiente:

  1. Notifica a todos los desarrolladores sobre eventos como productos nuevos, versiones nuevas de los Términos y Condiciones o planes de tarifas nuevos.
  2. Notificar a desarrolladores específicos sobre eventos como la publicación de un documento de facturación o cuando se alcanza un porcentaje de su cantidad objetivo de transacciones (si compraron un plan de tarifa de notificación ajustable).
  3. Notificar a un proveedor de API sobre eventos relacionados con el desarrollador, como cuando un desarrollador se registra para obtener una cuenta o cuando se registra en un plan de tarifas
  4. Aquí encontrarás más detalles sobre el tipo de notificaciones disponibles y cómo configurarlas.

Requisitos previos

Asegúrate de que se hayan cumplido los siguientes requisitos previos:

  1. Aceptación del plan de tarifas

    Para las siguientes notificaciones de monetización, verifica si los desarrolladores aceptaron el plan de tarifas correspondiente :

    1. Nuevo plan de tarifas
    2. Plan de tarifas revisado
    3. Plan de tarifas vencido
    4. Plan de tarifas renovados
    5. Se superó el límite de frecuencia
    6. Agotamiento del plan de tarifas freemium

      Si el desarrollador no aceptó el plan de tarifas, estas notificaciones no se activarán para ese desarrollador específico.

  2. El Programador de trabajos se debe ejecutar para la notificación específica.

    La monetización proporciona un programador de trabajos y un conjunto de trabajos que están programados previamente para ejecutarse en horarios predesignados. Se debe ejecutar el programador de trabajos para recibir una notificación específica. De lo contrario, no se activarán las notificaciones.

    1. Usa las instrucciones proporcionadas en el siguiente documento para ver si se ejecutó el trabajo programado para una notificación específica:

      Programa trabajos de monetización

      Nota: Puedes cambiar el programa según tu caso de uso.

    2. Si ya se ejecutó el trabajo programado para esa notificación específica y todavía no recibes las notificaciones, ve a la sección Posibles causas para solucionar este problema.
    3. De lo contrario, espera hasta que se ejecute el trabajo programado para la notificación específica.

Causas posibles

Estas son algunas de las posibles causas de este problema:

Causa Descripción Instrucciones de solución de problemas aplicables a
Configuración de SMTP incorrecta La configuración de SMTP proporcionada no es correcta. Usuarios de la nube privada perimetral

Programación del trabajo de notificación

 No se inició el trabajo de notificación. Usuarios de la nube pública y privada perimetral

Causa 1: La configuración de SMTP es incorrecta

Diagnóstico

  1. Verifica el archivo /opt/apigee/edge-mint-management-server/conf/apix-mint.properties y si las siguientes propiedades SMTP están configuradas correctamente. 
    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 que la configuración del usuario y del servidor SMTP sea correcta. Si esta configuración es incorrecta o no está establecida, continúa con el paso 3. Si esto es correcto, continúa con el paso 4.
  3. Actualiza el servidor SMTP y la configuración del usuario correctamente con las instrucciones del siguiente documento:

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

  4. Vuelve a revisar si las notificaciones de monetización ahora funcionan. De lo contrario, continúa con el paso 5.
  5. Si la configuración de SMTP es correcta, ejecuta la llamada a la API Ver notificaciones enviadas para ver el estado de la notificación enviada.
    1. Esta API muestra un JSON con todas las notificaciones que se activaron y el estado de cada una de ellas.
    2. A continuación, se proporciona un JSON de muestra : 
      {
        "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" : "..."
}

      Si revisas el archivo JSON, este muestra el estado como "ERROR". para la notificación anterior específica "Actualizar desarrollador".

  6. Esto puede deberse a que no se puede acceder al servidor SMTP ni al puerto desde el servidor de administración. Usa el comando telnet para comprobar si puedes conectarte al servidor SMTP especificado en el puerto indicado. 
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    Qué hacer si aparece el error “Se agotó el tiempo de espera de la conexión” o "Conexión rechazada" para obtener la salida de Telnet, luego, proceda a Resolution.

Solución

  1. Trabaja con el administrador de red y asegúrate de que el servidor SMTP pueda aceptar conexiones de otras máquinas y de que el puerto específico esté abierto al mundo exterior para comunicarse.
  2. Si el problema persiste, ve a Debe recopilar información de diagnóstico con el

Causa 2: Programa de trabajo de notificación

No se inició el trabajo de notificación.

Diagnóstico

  1. Ejecuta la siguiente llamada a la API para ver todos los trabajos de monetización programados actualmente.

    /monetize/apis/get/triggers

  2. Verifica si la condición de notificación está presente y habilitada para la notificación que no funciona. Si no aparece, continúa con el paso 3 para crear la condición de notificación y omite el resto de los pasos.
    1. Si está presente, comprueba si está habilitado como verdadero. De lo contrario, ejecuta la API de Update a notification condition and action para actualizar la condición de notificación.

      O

    2. Usa la IU para actualizar la condición de notificación a través del proceso proporcionado en el siguiente documento:

      IU de eventos

    3. Ejecuta la llamada Create a notification condition and action API para crear la condición de notificación apropiada y la acción correspondiente.
      1. Una vez que se cree la condición de notificación, ejecuta la llamada a la API de List notification conditions and actions para verificar si se creó.
      2. También puedes volver a procesar la notificación con la opción Vuelve a procesar una API de notificaciones.
    4. Este paso solo se aplica a los usuarios de la nube privada. Si la condición de notificación está presente en el paso 1 y los correos electrónicos de notificación siguen sin llegar, revisa el registro del servidor de administración /opt/apigee/var/log/edge-management-server/logs/system.log y verifica si se activó la condición de notificación. 
      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. Si se activa la condición de notificación, pero todavía no recibes las notificaciones, ve a Se debe recopilar información de diagnóstico donde se muestre la información y el resultado de los pasos anteriores.

Solución

  1. Vuelve a procesar la notificación con la API de volver a procesar una notificación.

Se debe recopilar información de diagnóstico

Si el problema persiste incluso después de seguir las instrucciones anteriores, comunícate con el equipo de asistencia de Apigee Edge y proporcione la siguiente información de diagnóstico.

Los usuarios de las nubes públicas y privadas deben proporcionar la siguiente información:

  1. Nombre de la organización
  2. Nombre del entorno
  3. Condición de notificación de monetización que no funcionó
  4. Detalles sobre las secciones de esta guía que se han probado y cualquier otra información que nos ayude a resolver rápidamente este problema.

Además de la información mencionada anteriormente, los usuarios de la nube privada también deben proporcionar la siguiente información:

  • Registro del servidor de administración

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