Private Cloud용 Edge v. 4.17.05
지역 집계를 사용하면 지역, 대륙, 국가, 도시와 같은 지리적 속성을 기반으로 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 데이터베이스를 설치합니다.
- Maxmind GeoIp2 데이터베이스를 가져옵니다.
참고: 지역 집계는 서드 파티 데이터베이스의 지리 데이터를 Edge에서 수집한 분석 데이터에 추가하는 방식으로 작동합니다. 지역 집계를 사용하려면 이 정보가 포함된 Maxmind GeoIp2 데이터베이스를 구매해야 합니다. 자세한 내용은 https://www.maxmind.com/en/geoip2-databases를 참조하세요. - Qpid 서버 노드에 다음 폴더를 만듭니다.
/opt/apigee/maxmind - Maxmind GeoIp2 데이터베이스를 /opt/apigee/maxmind에 다운로드합니다.
- 데이터베이스 파일의 소유권을 'apigee' 사용자로 변경합니다.
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - 데이터베이스의 권한을 744로 설정합니다.
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - /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 서버를 다시 구성하고 다시 시작할 필요 없이 심볼릭 링크만 업데이트하면 됩니다. - qpid-server.properties 파일의 소유권을 'apigee' 사용자로 변경합니다.
> chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties - Qpid 서버를 다시 시작합니다.
> /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-qpid-server restart - 모든 Qpid 노드에서 이 프로세스를 반복합니다.
- 지역 집계가 작동하는지 확인하려면 다음 단계를 따르세요.
- 샘플 API 프록시에서 여러 API 프록시 호출을 트리거합니다.
- 집계가 완료될 때까지 5~10분 정도 기다립니다.
- 콘솔을 열고 Edge Postgres 서버에 연결합니다.
> psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee - 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에서 지역 지도를 사용 설정하려면 다음 절차를 따르세요.
- 지역 지도를 사용 설정하려면 /opt/apigee/customer/application/ui.properties에 다음 토큰을 설정합니다. 이 파일이 없으면 만듭니다.
conf_apigee_apigee.feature.disablegeomap=false - ui.properties 파일의 소유권을 'apigee' 사용자로 변경합니다.
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Edge UI를 다시 시작합니다.
> /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-ui restart - Edge UI에서 애널리틱스 > GeoMap을 선택하여 지역 집계 데이터를 표시합니다.
MaxMind GeoIp2 데이터베이스 업데이트
MaxMind는 Maxmind GeoIp2 데이터베이스를 정기적으로 업데이트합니다. 업데이트된 데이터베이스를 받으면 다음 절차에 따라 Edge에 설치합니다.
- 업데이트된 Maxmind GeoIp2 데이터베이스를 가져옵니다.
- Maxmind GeoIp2 데이터베이스를 /opt/apigee/maxmind에 다운로드합니다.
- 데이터베이스 파일의 이름을 확인합니다. /opt/apigee/customer/application/qpid-server.properties에 정의된 대로 이전 파일과 동일하면 다음 단계로 진행합니다. 그러나 파일 이름이 다른 경우에는 qpid-server.properties 파일을 수정하여 새 데이터베이스 파일의 이름을 지정한 다음 위에서 설명한 대로 Qpid 서버를 다시 시작해야 합니다.
파일 심볼릭 링크를 만드는 방법도 있습니다. 예를 들어 'GeoIP2-City-current.mmdb'에 대한 심볼릭 링크를 'GeoIP2-City_20160127.mmdb'로 만듭니다. 나중에 파일 이름이 다른 새 데이터베이스를 받으면 Qpid 서버를 다시 구성할 필요 없이 심볼릭 링크만 업데이트하면 됩니다. - 데이터베이스 파일의 소유권을 'apigee' 사용자로 변경합니다.
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - 데이터베이스의 권한을 744로 설정합니다.
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Qpid 서버를 다시 시작합니다.
> /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-qpid-server restart - 모든 Qpid 노드에서 이 프로세스를 반복합니다.