지역 집계 및 지역 지도 사용

Private Cloud용 Edge v. 4.17.01

지역 집계를 사용하면 지역, 대륙, 국가, 도시와 같은 지리적 속성을 기반으로 API 호출의 분석 데이터를 수집할 수 있습니다. 이 분석 데이터의 Edge UI에서 API 요청의 위치를 보여주는 GeoMap을 볼 수 있습니다.

지역 집계는 서드 파티 데이터베이스에서 지리 데이터를 추출하여 Edge에서 수집한 분석 데이터에 추가하는 방식으로 작동합니다. 지리적 정보에는 API 프록시에 대한 요청의 도시, 국가, 대륙, 시간대, 리전이 포함될 수 있습니다.

지역 집계를 사용하려면 이 지리 정보가 포함된 Maxmind GeoIp2 데이터베이스를 구매해야 합니다. 자세한 내용은 https://www.maxmind.com/en/geoip2-databases를 참조하세요.

지역 집계 사용 설정

기본적으로 지역 집계는 사용 중지되어 있습니다. 지역 집계를 사용 설정하려면 다음을 실행해야 합니다.

  • 모든 Qpid 서버에서 MaxMind 데이터베이스를 설치하고 이를 사용하도록 Qpid 서버를 구성합니다.
  • Edge UI에서 지역 지도 표시를 사용 설정합니다.

모든 Edge Qpid 서버에 MaxMind 데이터베이스 설치

다음 절차에 따라 모든 Edge Qpid 서버에 MaxMind 데이터베이스를 설치합니다.

  1. Maxmind GeoIp2 데이터베이스를 가져옵니다.
    참고: 지역 집계는 서드 파티 데이터베이스의 지리 데이터를 Edge에서 수집한 분석 데이터에 추가하는 방식으로 작동합니다. 지역 집계를 사용하려면 이 정보가 포함된 Maxmind GeoIp2 데이터베이스를 구매해야 합니다. 자세한 내용은 https://www.maxmind.com/en/geoip2-databases를 참조하세요.
  2. Qpid 서버 노드에 다음 폴더를 만듭니다.
    /opt/apigee/maxmind
  3. Maxmind GeoIp2 데이터베이스를 /opt/apigee/maxmind에 다운로드합니다.
  4. 데이터베이스 파일의 소유권을 'apigee' 사용자로 변경합니다.
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. 데이터베이스의 권한을 744로 설정합니다.
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. /opt/apigee/customer/application/qpid-server.properties에 다음 토큰을 설정합니다. 해당 파일이 없으면 다음과 같이 만듭니다.
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
    conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb


    다른 위치에 데이터를 저장한 경우 Maxmin 위치 수정

    이 데이터베이스 파일에는 버전 번호가 포함되어 있습니다. 나중에 업데이트된 데이터베이스 파일을 받으면 버전 번호가 다를 수 있습니다. 또는 데이터베이스 파일에 심볼릭 링크를 만들고 qpid-server.properties에 심볼릭 링크를 사용합니다.

    예를 들어 'GeoIP2-City-current.mmdb'에 대해 'GeoIP2-City_20160127.mmdb'로 연결되는 심볼릭 링크를 만듭니다. 나중에 파일 이름이 다른 새 데이터베이스를 받으면 Qpid 서버를 다시 구성하고 다시 시작할 필요 없이 심볼릭 링크만 업데이트하면 됩니다.
  7. qpid-server.properties 파일의 소유권을 'apigee' 사용자로 변경합니다.
    > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Qpid 서버를 다시 시작합니다.
    > /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-qpid-server restart
  9. 모든 Qpid 노드에서 이 프로세스를 반복합니다.
  10. 지역 집계가 작동하는지 확인하려면 다음 단계를 따르세요.
    1. 샘플 API 프록시에서 여러 API 프록시 호출을 트리거합니다.
    2. 집계가 완료될 때까지 5~10분 정도 기다립니다.
    3. 콘솔을 열고 Edge Postgres 서버에 연결합니다.
      > psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. analytics.agg_geo 테이블에서 SELECT 쿼리를 실행하여 지리적 속성이 있는 행을 표시합니다.
      apigee=# select * from analytics.agg_geo;

      쿼리 결과에 Maxmind GeoIp2 데이터베이스에서 추출된 열(ax_geo_city, ax_geo_country, ax_geo_geo_region, ax_geo_region, ax_geo_region)이 표시됩니다.

      agg_geo 테이블이 채워지지 않으면 /opt/apigee/var/log/edge-qpid-server/logs/에서 Qpid 서버 로그를 확인하여 잠재적인 예외를 감지하세요.

Edge UI에서 지역 지도 사용 설정하기

Edge UI에서 지역 지도를 사용 설정하려면 다음 절차를 따르세요.

  1. 지역 지도를 사용 설정하려면 /opt/apigee/customer/application/ui.properties에 다음 토큰을 설정합니다. 이 파일이 없으면 만듭니다.
    conf_apigee_apigee.feature.disablegeomap=false
  2. ui.properties 파일의 소유권을 'apigee' 사용자로 변경합니다.
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Edge UI를 다시 시작합니다.
    > /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-ui restart
  4. Edge UI에서 애널리틱스 > GeoMap을 선택하여 지역 집계 데이터를 표시합니다.

MaxMind GeoIp2 데이터베이스 업데이트

MaxMind는 Maxmind GeoIp2 데이터베이스를 정기적으로 업데이트합니다. 업데이트된 데이터베이스를 받으면 다음 절차에 따라 Edge에 설치합니다.

  1. 업데이트된 Maxmind GeoIp2 데이터베이스를 가져옵니다.
  2. Maxmind GeoIp2 데이터베이스를 /opt/apigee/maxmind에 다운로드합니다.
  3. 데이터베이스 파일의 이름을 확인합니다. /opt/apigee/customer/application/qpid-server.properties에 정의된 대로 이전 파일과 동일하면 다음 단계로 진행합니다. 그러나 파일 이름이 다른 경우에는 qpid-server.properties 파일을 수정하여 새 데이터베이스 파일의 이름을 지정한 다음 위에서 설명한 대로 Qpid 서버를 다시 시작해야 합니다.

    파일 심볼릭 링크를 만드는 방법도 있습니다. 예를 들어 'GeoIP2-City-current.mmdb'에 대한 심볼릭 링크를 'GeoIP2-City_20160127.mmdb'로 만듭니다. 나중에 파일 이름이 다른 새 데이터베이스를 받으면 Qpid 서버를 다시 구성할 필요 없이 심볼릭 링크만 업데이트하면 됩니다.
  4. 데이터베이스 파일의 소유권을 'apigee' 사용자로 변경합니다.
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. 데이터베이스의 권한을 744로 설정합니다.
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Qpid 서버를 다시 시작합니다.
    > /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-qpid-server restart
  7. 모든 Qpid 노드에서 이 프로세스를 반복합니다.