Google Cloud Run 모니터링

GCP 에이전트의 구성 파일에 다음 구성을 추가하여 GCP 에이전트가 API 메트릭을 초 단위로 폴링하는 빈도를 설정할 수 있습니다:

com.instana.plugin.gcp.run:
  enabled: tru
  poll_rate: 60  # How often Google's metrics API will be polled
  credentials_path: '/opt/instana/credentials/cred-gcp.json'  # Path to Service Account credentials
  include_tags:
    ...
  exclude_tags:
    ...
 

여러 태그를 쉼표로 구분하여 정의할 수 있습니다. 태그는 문자로 : 구분된 키-값 쌍으로 제공되어야 합니다. 설정을 더 쉽게 하기 위해, 검색 과정에 포함(또는 제외)할 태그를 정의할 수 있습니다. 두 목록(포함 및 제외)에 동일한 태그가 존재하는 경우, 제외 목록이 우선순위가 높습니다. 서비스 필터링이 필요하지 않은 경우, 및 include_tags 속성은 exclude_tags 생략해야 합니다.

태그를 사용하여 Cloud Run 서비스 리비전을 포함하거나 제외하려면 다음 구성을 사용하십시오:

com.instana.plugin.gcp.run:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
 

마지막 ` FROM ` 절 뒤에 다음 Dockerfile 줄을 추가하십시오:

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN /instana/setup.sh
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"
 

마지막 `FROM 절 뒤에 다음 Dockerfile 줄을 추가하십시오 ( Node.js18.19 및 이후 버전):

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN /instana/setup.sh
ENV NODE_OPTIONS="--import=/instana/node_modules/@instana/google-cloud-run/esm-register.mjs"

컨테이너를 빌드하고 원하는 이미지 저장소로 푸시하세요.

마지막으로, '클라우드 런 서비스 구성' 섹션에 설명된 구성 단계를 따르십시오.

다음 명령어를 실행하면 사용 가능한 모든 버전을 확인할 수 있습니다:

curl -s https://icr.io/v2/instana/google-cloud-run-nodejs/tags/list | jq .

자세한 내용은 Node.js 버전 관리 문서를 참조하십시오.

Node.js 컨테이너에 필요한 패키지가 포함되지 않은 최소한의 기본 이미지를 사용하는 경우, Node.js Docker 과정에서 다음과 같은 경고가 표시될 수 있습니다.

gyp ERR! ...some error message from trying to rebuild native add-ons, for example:
gyp ERR! stack Error: Could not find any Python installation to use
...
Warning: Rebuilding native add-ons for @instana/google-cloud-run failed. Monitoring the Cloud Run service revision instance will work nonetheless, but you will miss some Node.js metrics (GC metrics, event loop metrics, ...). See https://www.instana.com/docs/ecosystem/google-cloud-run/#build-dependencies-and-native-add-ons for details.
 

로그 메시지가 시사하듯, Instana 을 통해 Node.js Cloud Run 서비스 리비전 인스턴스를 모니터링하는 것은 작동합니다. 그러나 특정 지표가 누락되어 있습니다. Instana 빌드 중에는 최소한 일시적으로라도 누락된 운영 체제 패키지를 설치할 것을 권장합니다. 그것들은 최종 이미지에 포함될 필요가 없습니다. 설치할 패키지와 설치 방법은 사용 중인 배포판에 따라 다릅니다.

Linux® 에 대한 다음 Dockerfile 예제 스니펫을 참조하십시오: Alpine :

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN apk add --no-cache --virtual .gyp \
        build-base \
        python \
    && /instana/setup.sh \
    && apk del .gyp python
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"
 

Debian 기반 배포판( Ubuntu 포함)의 경우 다음 예시를 참조하십시오:

COPY --from=icr.io/instana/google-cloud-run-nodejs:latest /instana /instana
RUN apt-get update \
    && apt-get install build-essential \
    && /instana/setup.sh \
    && apt-get remove -y build-essential
ENV NODE_OPTIONS="--require /instana/node_modules/@instana/google-cloud-run"
 

( CentOS,RHEL, yum ...)를 사용하는 배포판의 경우, 필요한 패키지를 설치하는 명령어는 다음과 같습니다:

RUN yum groupinstall "Development Tools"
 

Docker 이미지 빌드 시점에 Instana 의 NuGet 패키지를 추가하도록 Dockerfile을 수정하는 방법은 다음 예시를 참조하십시오:

# If running on Alpine or muslc-based images
RUN dotnet add Instana.Tracing.Core.Rewriter.Alpine
# Glibc-based images like RHEL and Debian derivatives
RUN dotnet add Instana.Tracing.Core.Rewriter.Linux

# set CoreCLR tracing environment variables
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
ENV CORECLR_PROFILER_PATH=/app/instana_tracing/CoreProfiler.so
ENV DOTNET_STARTUP_HOOKS=/app/Instana.Tracing.Core.dll
 

• 컨테이너가 사용하는 lib의 버전에 따라 두 가지 패키지가 제공됩니다:

  • muslcAlpine 기반 컨테이너에서 사용되는 Instana.Tracing.Core.Rewriter.Alpine 패키지가 필요합니다.

  • glibcAlpine 를 제외한 거의 모든 배포판에서 사용하는,. Instana.Tracing.Core.Rewriter.Linux가 필요합니다.

• 의 실제 경로를 애플리케이션 /app/ 루트 경로로 대체하십시오.

• 클라우드 런 서비스 구성 섹션에 설명된 환경 변수를 설정하는 것을 잊지 마십시오.