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

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다.
info

증상

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

오류 메시지

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

수익 창출 이벤트 알림 정보

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

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

기본 요건

다음 기본 요건이 충족되었는지 확인합니다.

  1. 요금제 수락

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

    1. 새 요금제
    2. 수정된 요금제
    3. 만료된 요금제
    4. 갱신된 요금제
    5. 트래픽 제한 초과
    6. 소진된 프리미엄 요금제

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

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

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

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

      수익 창출 작업 예약

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

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

가능한 원인

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

원인 설명 문제 해결 안내 적용 대상
잘못된 SMTP 구성 제공된 SMTP 구성이 올바르지 않습니다. Edge Private Cloud 사용자

알림 작업 일정

알림 작업이 시작되지 않았습니다. Edge Public Cloud 및 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을 확인하면 위의 특정 알림 '개발자 업데이트'의 상태가 'FAILED'로 표시됩니다.

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

    telnet 출력에 'Connection timed out' 또는 'Connection refused' 오류가 표시되면 해결 방법으로 이동합니다.

해결 방법

  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 지원팀 에 문의하고 다음 진단 정보를 제공하세요.

Public Cloud 및 Private Cloud 사용자는 아래 정보를 제공해야 합니다.

  1. 조직 이름
  2. 환경 이름
  3. 작동하지 않은 수익 창출 알림 조건
  4. 이 플레이북에서 시도한 섹션에 관한 세부정보와 이 문제의 해결을 신속하게 처리하는 데 도움이 될 만한 기타 통찰력

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

  • 관리 서버 로그

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