Apigee Microgateway 모니터링

일반적인 Node.js 애플리케이션에서는 코드베이스의 메인 엔트리 파일에 다음 줄을 추가하여 Instana Node.js 수집기를 활성화합니다:

require('@instana/collector')();
 

Apigee Microgateway를 전역으로 edgemicro 설치하고 명령줄 edgemicro 인터페이스를 사용하여 시작하는 경우, 이 줄을 추가하기 위한 별도의 코드는 필요하지 않습니다.

이 시나리오의 경우, Instana 수집기 패키지는 기존 edgemicro 설치 환경에 정적 계측을 적용하여 해당 환경을 Instana 와 호환되도록 만드는 실행 파일을 제공합니다.

모니터링하려는 edgemicro 인스턴스가 실행되는 머신에서 계측을 수행해야 합니다. 컨테이너에서 edgemicro 실행 중인 경우, 해당 컨테이너 내에서 다음 단계를 수행하십시오. 해당 머신이나 컨테이너에 패키지를 edgemicro 설치한 후에는 한 번만 수행하면 되며, 시작할 때마다 할 edgemicro필요는 없습니다. 다음 단계는 Instana 모니터링 및 추적을 위한 설치 edgemicro 환경을 준비하는 것입니다:

• Instana Node.js 수집기를 설치 edgemicro 환경과 동일한 머신이나 컨테이너에 전역적으로 설치하십시오. 수집기가 설치 edgemicro 환경에서 액세스할 수 있는 파일 시스템에 설치되어 있는지 확인하십시오.
• 설치가 @instana/collector 완료되었으므로, 이제 Instanaedgemicro 설치를 준비할 수 있습니다. 다음 명령을 실행하십시오.

  instana-instrument-edgemicro-cli
   

• 이 실행 파일은 에서 @instana/collector 제공하며, 패키지를 전역으로 설치한 경우 경로에 포함되어 있어야 합니다. 셸이 전역적으로 설치된 npm 패키지의 실행 파일을 찾을 수 있도록 설정되어 있지 않은 경우, 대신 다음 명령을 실행할 수도 있습니다 $(npm root -g)/../../bin/instana-instrument-edgemicro-cli.
• 이 명령은 실행이 완료되면 출력되어야 합니다.

  Done: The edgemicro module has been statically instrumented for Instana tracing and metrics collection.
   

참고: 이 절차(특히 호출 instana-instrument-edgemicro-cli)는 를 다시 설치하거나 최신 edgemicro 버전으로 업데이트할 때 반복해야 합니다. 동일한 edgemicro 설치에 대해 이 작업을 여러 번 수행해도 문제가 되지 않습니다. 이 실행 파일은 설치에 이미 계측 기능이 적용되었음을 인식할 수 있을 만큼 지능적이며, 필요한 경우 기존 계측 기능을 업데이트합니다. 패키지의 @instana/collector 위치가 변경될 경우에도 이 절차를 반복해야 하지만, 해당 패키지가 현장에서 최신 버전으로 업데이트될 때는 반복할 필요가 없습니다.

이 실행 파일은 전역적으로 설치된 edgemicro 설치 경로를 자동으로 찾아낼 수 있으므로, 일반적으로 인수가 필요하지 않습니다. 하지만 원한다면 (그리고 또한 edgegateway ) @instana/collector의 위치를 인수로 지정할 수도 있습니다:

instana-instrument-edgemicro-cli [edgemicro_path [instana-collector-path]]
 

예:

# let Instana figure out the paths
instana-instrument-edgemicro-cli
 

# specify the edgemicro path
instana-instrument-edgemicro-cli /path/to/edgemicro
 

# also specify the @instana/collector path`
instana-instrument-edgemicro-cli /path/to/edgemicro /path/to/@instana/collector
 

패키지가 edgemicro 어디에 설치되어 있는지 확인하려면:

• 다음 명령을 실행하여 global node_modulesnpm root -g 폴더가 어디에 있는지 확인하십시오. 이것이 출력된다고 가정해 /usr/local/lib/node_modules봅시다. 패키지가 edgemicro 전역으로 설치된 경우, 해당 패키지는 우리가 찾고 있는 설치 위치인 디렉터리에 있어야 /usr/local/lib/node_modules/edgemicro합니다.
• 또한, 명령줄에서 명령을 edgemicro 사용할 때 실제로 어떤 실행 파일이 사용되는지 확인하려면 다음 ls -l $(which edgemicro) 명령을 실행하십시오. 출력 결과는 다음과 같을 수 있습니다:

  ls -l $(which edgemicro)
   

     lrwxrwxrwx 1 user group 01 Jan 19 01:23 /usr/local/bin/edgemicro -> ../lib/node_modules/edgemicro/cli/edgemicro
   

• 이를 통해 에 설치된 패키지가 edgemicro 명령을 edgemicro 사용할 때 /usr/local/lib/node_modules/edgemicro 실제로 사용되는 패키지인지 확인할 수 있습니다.

이러한 설정의 부작용으로, 등과 edgemicro version edgemicro reloadedgemicro stop같은 다른 edgemicro 명령어를 실행할 때도 로그 @instana/collector 출력이 표시될 수 있습니다. 이는 예상되는 현상이므로 안심하고 무시해도 됩니다.

• Node.js 개요
• Node.js 수집기 설치
• Node.js 컬렉터 API
• Node.js Collector GitHub 저장소