Las notificaciones de monetización no funcionan

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X. Información

Síntoma

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

Mensaje de error

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

Acerca de las notificaciones de eventos de monetización

La monetización admite notificaciones de eventos que te permiten hacer lo siguiente:

  1. Notifica a todos los desarrolladores sobre eventos, como productos nuevos, versiones de los Términos y Condiciones o planes de tarifas nuevos.
  2. Notifica a desarrolladores específicos sobre eventos como la publicación de un documento de facturación o cuando se alcanza un porcentaje de la cantidad objetivo de transacciones (si compraron un plan de notificaciones ajustable).
  3. Notifica a un proveedor de APIs sobre eventos relacionados con el desarrollador, como cuando un desarrollador se registra en una cuenta o en un plan de tarifas.
  4. Haga clic aquí para obtener más información sobre los tipos de notificaciones que existen y sobre cómo se pueden configurar las notificaciones.

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 renovadas
    5. Se superó el límite de frecuencia
    6. Plan de tarifas freemium agotado

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

  2. Se debe ejecutar el Programador de trabajos 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 momentos previamente designados. El programador de trabajos debe ejecutarse para una notificación específica. Si no se ejecuta, no se activarán las notificaciones.

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

      Cómo programar trabajos de monetización

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

    2. Si ya se ejecutó el trabajo programado para la notificación específica y aún 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

Algunas de las posibles causas de este problema son las siguientes:

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 de la nube privada perimetral

Causa 1: Configuración de SMTP incorrecta

Diagnóstico

  1. Revisa el archivo /opt/apigee/edge-mint-management-server/conf/apix-mint.properties y verifica si las siguientes propiedades de 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 si el servidor SMTP y la configuración de usuario son correctos. Si estos parámetros de configuración son incorrectos o no los estableciste, 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 de usuario correctamente siguiendo las instrucciones del siguiente documento:

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

  4. Vuelve a verificar si las notificaciones de monetización ya 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 ejemplo de 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" : "..."
}

      Si verificas el JSON, muestra el estado "FALLIDO" para la notificación específica anterior "Actualizar desarrollador".

  6. Es posible que esto se deba a que el servidor SMTP y el puerto no están disponibles desde el servidor de administración. Usa el comando telnet para verificar si puedes conectarte al servidor SMTP especificado en el puerto especificado. 
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    Si aparece el error “Se agotó el tiempo de espera de la conexión” o “Se rechazó la conexión” en la salida de Telnet, continúa con la Resolución.

Resolución

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

Causa 2: programación del 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 la notificación está presente y si está habilitada para la notificación que no funciona. Si no lo está, continúa con el paso 3 para crear la condición de la notificación y omite el resto de los pasos.
    1. Si está presente, verifica si está habilitada como verdadera. De lo contrario, ejecuta Update a notification condition and action API para actualizar la condición de notificación.

      O

    2. Usa la IU para actualizar la condición de la notificación mediante el proceso que se proporciona en el siguiente documento:

      IU de Eventos

    3. Ejecuta la llamada a Create a notification condition and action API para crear la condición de notificación adecuada y la acción correspondiente.
      1. Una vez que se haya creado la condición de notificación, ejecuta la llamada a la API de List notification conditions and actions para verificar si se creó la condición de notificación.
      2. También puedes volver a procesar la notificación con Volver a procesar una API de notificaciones.
    4. Este paso solo se aplica a los usuarios de la nube privada. Si la condición de la notificación está presente en el paso 1 y los correos electrónicos de notificación siguen sin recibirse, revisa el registro del servidor de administración /opt/apigee/var/log/edge-management-server/logs/system.log y fíjate 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 la notificación y aún no recibes las notificaciones, continúa con Debe recopilar información de diagnóstico con la información y el resultado de los pasos anteriores capturados.

Solución

  1. Volver a procesar la notificación con la opción Volver a procesar una API de notificaciones

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 proporciona la siguiente información de diagnóstico.

Los usuarios de nube pública y privada 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 acerca de las secciones de esta Guía que se han probado y cualquier otra información que nos ayude a resolver este problema rápidamente.

Además de la información anterior, los usuarios de 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