온프레미스 애플리케이션용 Python 데이터 콜렉터 사용자 정의

데이터 콜렉터 패키지의 파일을 수정하여 Python 애플리케이션에 대한 모니터링을 사용자 정의하도록 환경 변수를 설정할 수 있습니다.

데이터 콜렉터 설정을 사용자 정의하기 위한 두 개의 파일 global.environment 및 config.properties가 제공됩니다. 이러한 파일의 설정을 변경하고 나면 변경사항이 적용되도록 Python 애플리케이션을 다시 시작하십시오.

global.environment 파일을 수정하여 데이터 콜렉터와 Cloud APM 서버 간의 연결을 사용자 정의할 수 있습니다. 기본값 대신 다른 Cloud APM 서버를 사용하려고 하거나 키 파일 또는 해당 비밀번호가 변경된 경우, Cloud APM 서버를 수정하여 데이터 콜렉터를 Cloud APM 서버에 다시 연결하십시오.

config.properties 파일을 수정하여 메소드 추적 사용 또는 사용 안함과 같이 필요에 따라 데이터 콜렉터 동작을 사용자 정의할 수 있습니다.

global.environment 구성 파일

표 1에서는 global.environment 구성 파일에서 설정할 수 있는 환경 변수 및 상관된 설명을 보여줍니다. global.environment 파일은 Python 데이터 콜렉터가 설치된 etc 폴더(예: /root/.pyenv/versions/3.5.2/lib/python3.5/site-packages/ibm_python_dc/etc 디렉토리)에서 찾을 수 있습니다.

표 1. global.environment 파일에서 지원되는 환경 변수
변수 이름 중요도 값 설명
APM_BM_GATEWAY_URL 선택사항
  • https:
    //<server ip or hostname>:
    443
  • http:
    //<server ip or hostname>:80
 대상 온프레미스 서버 게이트웨이 URL입니다.
APM_KEYFILE_PSWD 선택사항 키 파일의 비밀번호 키 파일과 쌍을 이루는 키 파일 비밀번호입니다.
참고: HTTPS를 사용하도록 게이트웨이를 구성한 경우에만 이 변수를 설정하십시오.
APM_KEYFILE_URL 선택사항 http://<hosted http server>:<port>/keyfile.p12 키 파일을 다운로드할 URL입니다.
참고: HTTPS를 사용하도록 게이트웨이를 구성한 경우에만 이 변수를 설정하십시오.

config.properties 파일

표 2에서는 config.properties 구성 파일에서 설정할 수 있는 환경 변수 및 상관된 설명을 보여줍니다. Python 데이터 콜렉터의 설치 디렉토리(예: /root/.pyenv/versions/3.5.2/lib/python3.5/site-packages/ibm_python_dc 디렉토리)에서 config.properties 파일을 찾을 수 있습니다.

표 2. config.properties 파일에서 지원되는 환경 변수
변수 이름 중요도 값 설명
KPG_ENABLE_DEEPDIVE 선택사항
  • False
  • True
  • False: 기본값입니다. 이 변수를 False로 설정하면 진단 데이터가 수집되지 않습니다.
  • True: 이 변수를 True로 설정하면 진단 데이터가 수집됩니다.

기본 레벨은 True입니다.

이 변수를 설정하지 않으면 진단 데이터가 수집되지 않습니다.

KPG_DD_CONFIG_FILE 선택사항 진단 모니터링 구성 파일의 파일 이름입니다. 진단 모니터링 구성 파일의 파일 이름입니다. 기본 파일 이름은 kpg_dd_config.xml입니다.
참고: 이 파일의 설정을 사용자 정의하고 나면 애플리케이션 루트 디렉토리에 이를 넣어야 합니다.

이 변수를 설정하지 않을 경우, 데이터 콜렉터 패키지의 기본 구성 파일 kpg_dd_config.xml이 사용됩니다.
KPG_DD_APP_PATH 선택사항 Python 애플리케이션에 대한 경로입니다. 데이터 콜렉터가 진단 데이터를 수집하는 Python 애플리케이션 또는 모듈에 대한 경로입니다. 모니터할 다른 Python 애플리케이션 및 모듈의 경로를 세미콜론 ;으로 구분하십시오.

이 변수를 설정하지 않을 경우 데이터 콜렉터가 애플리케이션이 사용하는 모듈 및 요청에 대한 데이터를 수집합니다. Python lib의 요청 데이터는 수집되지 않습니다.
KPG_DD_SECURITY_FILTER 선택사항
  • True
  • False
  • True: 기본값입니다. 이 변수를 True로 설정하면 값(예: 비밀번호)이 SQL문으로 표시되며 매개변수는 그룹 위젯 요청 컨텍스트에 표시되지 않습니다.
  • False: 이 변수를 False로 설정하면 SQL문의 값이 마스크되지 않으며 매개변수가 그룹 위젯 요청 컨텍스트에 표시됩니다.

이 변수를 설정하지 않으면 값(예: 비밀번호)이 SQL문으로 표시되며 매개변수는 그룹 위젯 요청 컨텍스트에 표시되지 않습니다.
KPG_GC_STATS 선택사항 True Python 가비지 콜렉션의 모든 통계 함수를 사용할 수 있습니다. 이 값을 True로 설정할 경우 이는 다음 명령을 실행하는 것과 같습니다. 

gc.set_debug(gc.DEBUG_STATS |
gc.DEBUG_COLLECTABLE |
gc.DEBUG_UNCOLLECTABLE | 
gc.DEBUG_INSTANCES | 
gc.DEBUG_OBJECTS )

KPG_GC_STATS를 사용하지 않도록 설정하려면 이 환경 변수를 삭제하십시오. 이를 False로 설정하지 마십시오.

기본값은 True입니다.

참고: 정식 제품 환경에서 KPG_GC_STATS=True를 설정하지 마십시오. 이는 디버그 모드 전용입니다. 그리고 충분한 메모리가 애플리케이션에 지정되었는지 확인하십시오.
KPG_LOG_LEVEL 선택사항
  • DEBUG
  • ERROR
  • INFO
  • DEBUG: 유용한 디버그 정보만 로그에 인쇄됩니다(예: 수집된 데이터, 서버에 전송되는 데이터, 서버 응답).
  • ERROR: 예외 및 예상치 않은 상황에 대한 정보만 로그에 인쇄됩니다.
  • INFO: 사용자가 현재 수행 중인 작업을 알도록 데이터 콜렉터에 대한 요약 정보가 로그에 인쇄됩니다.

기본값은 ERROR입니다.
KPG_LOG_TOCONSOLE 선택사항
  • Y
  • True
  • False가 아닌 다른 값
 로그는 콘솔에 인쇄되며 사용자는 cf logs <appname> 명령을 실행하여 로그를 볼 수 있습니다.

기본값은 True입니다.
KPG_SAVE_ALL 선택사항 True 참조되지 않은 모든 오브젝트는 gc.garbage에 저장되며 1분마다 gc.garbage를 지워야 합니다(데이터 콜렉터가 이를 수행함). 값이 True로 설정된 경우, 이는 다음 명령을 실행하는 것과 같습니다. 
gc.set_debug(gc.SAVE_ALL)
KPG_SAVE_ALL을 사용하지 않도록 설정하려면 이 환경 변수를 삭제하십시오. 이를 False로 설정하지 마십시오.

기본값은 True입니다.

참고:
정식 제품 환경에서 KPG_SAVE_ALL=True를 설정하지 마십시오. 이는 디버그 모드 전용입니다. 그리고 충분한 메모리가 애플리케이션에 지정되었는지 확인하십시오.
APM_GW_PROXY_CONNECTION 선택사항 http://<server ip or hostname>:port Python 데이터 콜렉터가 모니터링 데이터를 전송하는 데 사용하는 HTTP 또는 HTTPS 프록시입니다.