수익 창출 알림이 작동하지 않음

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

증상

수익 창출 알림이 작동하지 않아 구독한 사용자에게 이메일이 전송되지 않습니다.

오류 메시지

구독한 사용자에게 수익 창출 알림에 대한 이메일이 전송되지 않습니다. 오류 메시지는 관찰되지 않습니다.

수익 창출 이벤트 알림 정보

수익 창출에서는 다음과 같은 이벤트 알림을 지원합니다.

  1. 모든 개발자에게 신제품, 이용약관의 새 버전, 새로운 요금제와 같은 이벤트를 알립니다.
  2. 청구 서류 게시 등의 이벤트 또는 목표 거래 수의 일정 비율에 도달했을 때 (조정 가능한 알림 요금제를 구매한 경우) 특정 개발자에게 알립니다.
  3. 개발자가 계정에 등록하는 경우 또는 개발자가 요금제에 가입하는 경우와 같은 개발자 관련 이벤트를 API 제공업체에 알립니다.
  4. 표시되는 알림 유형과 설정 방법에 관한 자세한 내용은 여기에서 확인할 수 있습니다.

기본 요건

다음 기본 요건을 충족하는지 확인하세요.

  1. 요금제 수락

    다음 수익 창출 알림의 경우 개발자가 해당 요금제에 동의했는지 확인하세요.

    1. 새 요금제
    2. 수정된 요금제
    3. 만료된 요금제
    4. 갱신된 요금제
    5. 비율 제한 초과
    6. 고립된 부분 유료화(Freemium) 요금제

      개발자가 요금제에 동의하지 않으면 해당 개발자에게 이러한 알림이 트리거되지 않습니다.

  2. 특정 알림에 대해 작업 스케줄러를 실행해야 함

    수익 창출은 작업 스케줄러와 사전에 지정된 시간에 실행되도록 사전 예약된 작업 세트를 제공합니다. 특정 알림을 위해 작업 스케줄러를 실행해야 합니다. 실행되지 않으면 알림이 트리거되지 않습니다.

    1. 다음 문서에 제공된 안내에 따라 특정 알림에 대해 예약된 작업이 실행되었는지 확인합니다.

      수익 창출 작업 예약

      참고: 언제든지 사용 사례에 따라 일정을 변경할 수 있습니다.

    2. 특정 알림에 대해 예약된 작업이 이미 실행되었는데도 알림이 수신되지 않으면 가능한 원인 섹션으로 이동하여 문제를 계속 해결합니다.
    3. 그렇지 않은 경우 특정 알림에 대해 예약된 작업이 실행될 때까지 기다립니다.

가능한 원인

이 문제의 가능한 원인은 다음과 같습니다.

원인 설명 해당 문제 해결 지침
SMTP 구성이 잘못됨 제공된 SMTP 구성이 올바르지 않습니다. Edge 프라이빗 클라우드 사용자

알림 작업 일정

알림 작업이 시작되지 않았습니다. Edge 퍼블릭 클라우드 및 프라이빗 클라우드 사용자

원인 1: SMTP 구성이 잘못됨

진단

  1. /opt/apigee/edge-mint-management-server/conf/apix-mint.properties 파일을 확인하고 다음 SMTP 속성이 올바르게 설정되었는지 확인합니다.
    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. SMTP 서버 및 사용자 설정이 올바른지 확인합니다. 설정이 잘못되었거나 설정되지 않은 경우 3단계로 진행합니다. 올바른 경우 4단계로 진행합니다.
  3. 다음 문서의 안내에 따라 SMTP 서버 및 사용자 설정을 올바르게 업데이트합니다.

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

  4. 이제 수익 창출 알림이 제대로 작동하는지 다시 확인하세요. 그렇지 않은 경우 5단계로 진행합니다.
  5. SMTP 설정이 올바르면 전송된 알림 보기 API 호출을 실행하여 전송된 알림의 상태를 확인합니다.
    1. 이 API는 실행된 모든 알림과 각 알림의 상태가 포함된 JSON을 반환합니다.
    2. 샘플 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" : "..."
      }
      

      JSON을 선택하면 상태가 'FAILED'로 표시됩니다. 위의 특정 알림 '개발자 업데이트'에 대해 자세히 알아보세요.

  6. 관리 서버에서 SMTP 서버 및 포트에 연결할 수 없기 때문일 수 있습니다. telnet 명령어를 사용하여 지정된 포트에서 지정된 SMTP 서버에 연결할 수 있는지 확인합니다.
    telnet <SMTP-server-IP-address> <SMTP-Port#>
    

    '연결 시간 초과' 오류가 표시되는 경우 또는 '연결 거부됨' Telnet 출력을 선택한 다음 Resolution으로 진행합니다.

해상도

  1. 네트워크 관리자와 협력하여 SMTP 서버가 다른 시스템의 연결을 수락할 수 있고 특정 포트가 통신을 위해 외부에 공개되어 있는지 확인합니다.
  2. 문제가 계속되면

원인 2: 알림 작업 일정

알림 작업이 시작되지 않았습니다.

진단

  1. 현재 예약된 모든 수익 창출 작업을 보려면 다음 API 호출을 실행하세요.

    /monetize/apis/get/triggers

  2. 알림 조건이 있고 작동하지 않는 알림에 사용 설정되어 있는지 확인합니다. 조건이 없으면 3단계로 진행하여 알림 조건을 만들고 나머지 단계를 건너뜁니다.
    1. 해당하는 경우 사용 설정되어 있는지 true로 확인합니다. 그렇지 않은 경우 알림 조건 및 작업 API 업데이트를 실행하여 알림 조건을 업데이트합니다.

      또는

    2. 아래 문서에 제공된 절차에 따라 UI를 사용하여 알림 조건을 업데이트합니다.

      이벤트 UI

    3. 알림 조건 및 작업 API 만들기 호출을 실행하여 적절한 알림 조건과 해당 작업을 만듭니다.
      1. 알림 조건이 생성되면 List notification terms and actions API 호출을 실행하여 알림 조건이 만들어졌는지 확인합니다.
      2. Reprocess a notification API를 사용하여 알림을 다시 처리할 수도 있습니다.
    4. 이 단계는 Private Cloud 사용자에게만 적용됩니다. 1단계의 알림 조건이 있고 여전히 알림 이메일이 오지 않는 경우 관리 서버 로그(/opt/apigee/var/log/edge-management-server/logs/system.log)를 확인하고 알림 조건이 트리거되었는지 확인합니다.
      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. 알림 조건이 트리거되었는데도 알림이 수신되지 않으면 위의 단계에서 캡처한 정보 및 출력과 함께 진단 정보를 수집해야 함을 진행합니다.

해결 방법

  1. Reprocess a notification API를 사용하여 알림을 다시 처리합니다.

진단 정보 수집 필요

위의 안내를 따랐는데도 문제가 계속되면 Apigee Edge 지원팀에 문의하세요. 다음 진단 정보를 제공합니다.

퍼블릭 및 프라이빗 클라우드 사용자는 아래 정보를 제공해야 합니다.

  1. 조직 이름
  2. 환경 이름
  3. 수익 창출 알림 조건이 작동하지 않음
  4. 이 플레이북에서 시도한 섹션에 대한 세부정보 및 이 문제를 빠르게 해결하는 데 도움이 되는 다른 유용한 정보입니다.

위의 정보 외에도 Private Cloud 사용자는 다음 정보도 제공해야 합니다.

  • 관리 서버 로그

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