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

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

증상

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

오류 메시지

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

수익 창출 이벤트 알림 정보

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

  1. 모든 개발자에게 신제품, 새 이용약관, 새 요금제 등의 이벤트를 알립니다.
  2. 결제 문서가 게시되거나 목표 거래 수에 도달한 경우 (조정 가능한 알림 요금제를 구매한 경우) 등의 이벤트를 특정 개발자에게 알립니다.
  3. 개발자가 계정에 등록하는 경우 또는 개발자가 요금제에 가입하는 경우와 같은 개발자 관련 이벤트에 대해 API 제공업체에 알립니다.
  4. 표시되는 알림 유형과 설정 방법에 관한 자세한 내용은 여기를 참고하세요.

기본 요건

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

  1. 요금제 수락

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

    1. 새 요금제
    2. 수정된 요금제
    3. 만료된 요금제
    4. 요금제 갱신
    5. 속도 제한 초과
    6. 부분 유료 모델 요금제 소진됨

      개발자가 요금제를 수락하지 않은 경우 해당 개발자에게는 이러한 알림이 트리거되지 않습니다.

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

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

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

      수익 창출 작업 예약

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

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

가능한 원인

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

원인 설명 해당 문제 해결 지침
SMTP 구성이 잘못됨 입력한 SMTP 구성이 올바르지 않습니다. Edge Private Cloud 사용자

알림 작업 일정

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

원인 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을 확인하면 위의 특정 알림인 'Update Developer'에 대해 상태가'FAILED'로 표시됩니다.

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

    Telnet 출력에 '연결 시간이 초과되었습니다' 또는 '연결이 거부됨' 오류가 표시되면 해결 방법을 진행합니다.

해상도

  1. 네트워크 관리자와 협력하여 SMTP 서버가 다른 컴퓨터의 연결을 수락할 수 있는지 그리고 특정 포트가 통신을 위해 외부에 공개되어 있는지 확인하세요.
  2. 그래도 문제가 해결되지 않으면 진단 정보 수집 필요

원인 2: 알림 작업 일정

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

진단

  1. 다음 API 호출을 실행하여 현재 예약된 모든 수익 창출 작업을 확인합니다.

    /monetize/apis/get/triggers

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

      또는

    2. UI를 통해 아래 문서에 제공된 프로세스에 따라 알림 조건을 업데이트합니다.

      이벤트 UI

    3. 알림 조건 및 작업 API 만들기 호출을 실행하여 적절한 알림 조건과 해당 작업을 만듭니다.
      1. 알림 조건이 생성되면 알림 조건 및 작업 API 나열 호출을 실행하여 알림 조건이 생성되었는지 확인합니다.
      2. 알림 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. 알림 API 재처리를 사용하여 알림을 다시 처리합니다.

진단 정보 수집 필수

위의 안내를 따른 후에도 문제가 지속되면 Apigee Edge 지원팀에 문의하고 다음 진단 정보를 제공해 주세요.

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

  1. 조직 이름
  2. 환경 이름
  3. 유효하지 않은 수익 창출 알림 조건
  4. 이 플레이북에서 시도해 본 섹션 및 이 문제를 빠르게 해결하는 데 도움이 될 기타 정보에 관한 세부정보

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

  • 관리 서버 로그

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