지역 집계 및 지역 지도 사용 설정

Private Cloud용 Edge v4.19.01

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

지역 집계는 제3자 데이터베이스에서 지리 데이터를 추출하고 에지에서 수집한 분석 데이터로 변환할 수 있습니다 지리 정보에는 도시, API 프록시로 전송된 요청의 국가, 대륙, 시간대, 리전

지역 집계를 사용하려면 이 제공합니다. https://www.maxmind.com/en/geoip2-databases를 참고하세요. 를 참조하세요.

지역 집계 사용 설정

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

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

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

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

  1. Maxmind GeoIp2 데이터베이스를 가져옵니다.
  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

    Maxmind GeoIp2 데이터베이스를 다른 위치에 저장한 경우 path 속성을 수정합니다. 변경할 수 있습니다

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

    예를 들어 'GeoIP2-City-current.mmdb' 심볼릭 링크를 만듭니다. 'GeoIP2-City_20160127.mmdb'로 설정합니다. 만약 나중에 다른 파일 이름으로 새 데이터베이스를 받는 경우 Qpid 서버를 다시 구성하고 다시 시작할 필요 없이 symlink를 사용합니다.

  7. qpid-server.properties 파일의 소유권을 'Apigee'로 변경하세요. 사용자: 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Qpid 서버를 다시 시작합니다. 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. 모든 Qpid 노드에서 이 프로세스를 반복합니다.
  10. 지역 집계가 작동하는지 확인하려면 다음 단계를 따르세요. <ph type="x-smartling-placeholder">
      </ph>
    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 쿼리를 실행하여 지리적 속성: 
      select * from analytics.agg_geo;

      쿼리 결과에서 추출된 다음 열이 쿼리 결과에 표시됩니다. Maxmind GeoIp2 데이터베이스: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

      agg_geo 테이블이 채워지지 않으면 잠재적인 위험을 감지하는 /opt/apigee/var/log/edge-qpid-server/logs/ 있습니다.

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-service edge-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-service edge-qpid-server restart
  7. 모든 Qpid 노드에서 이 프로세스를 반복합니다.