• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

컨테이너화된 개인 미니언(CPM) 설치

New Relic의 컨테이너화된 프라이빗 미니언(CPM)을 사용할 수 있습니다. 이들은 개인 위치 에 대해 합성 모니터 를 수락하고 실행하는 Docker 컨테이너 기반 개인 미니언입니다.

CPM은 Docker 컨테이너 시스템 환경 또는 Kubernetes 컨테이너 오케스트레이션 시스템 환경에서 작동할 수 있습니다. CPM은 환경을 자동 감지하여 적절한 작동 모드를 선택합니다.

일반 개인 미니언 기능

CPM은 가상 머신 대신 컨테이너로 작동하기 때문에 다음과 같은 많은 기능을 제공합니다.

Kubernetes 관련 기능

또한 CPM은 Kubernetes 환경에서 다음 기능을 제공합니다.

  • Kubernetes API와 통합하여 런타임 수명 주기 관리를 Kubernetes에 위임합니다.
  • Docker 소켓에 대한 권한 있는 액세스가 필요하지 않습니다.
  • 호스팅 및 온프레미스 Kubernetes 클러스터 지원
  • Docker, Containerd 등 다양한 컨테이너 엔진 지원
  • Helm 차트 및 구성 YAML을 통해 배포 가능
  • 최적의 리소스 관리를 위한 작업 기반 리소스 할당(ping vs. non-ping 검사) 허용
  • New Relic Kubernetes 클러스터 탐색기를 통해 제공되는 관찰 가능성

시스템 요구 사항 및 호환성

CPM을 호스팅하려면 시스템이 선택한 시스템 환경에 대한 최소 요구 사항을 충족해야 합니다.

주의

CPM 파일을 수정하지 마십시오. New Relic은 귀하가 수정한 사항에 대해 책임을 지지 않습니다. 자세한 내용은 계정 담당자 또는 New Relic 기술 영업 담당자 에게 문의하십시오.

개인 위치 키

CPM을 시작하기 전에 개인 위치 키 가 있어야 합니다. CPM은 키를 사용하여 New Relic에 대해 인증하고 해당 개인 위치와 연결된 모니터를 실행합니다.

기존 개인 위치에 대한 키를 찾으려면:

  1. one.newrelic.com >Synthetic monitoring >Private locations 로 이동합니다.

  2. 비공개 위치 색인에서 CPM을 할당할 비공개 위치를 찾습니다.

  3. 키가 있는 개인 위치와 연결된 키를 확인합니다.

    상.

샌드박싱 및 Docker 종속성

샌드박싱 및 Docker 종속성은 Docker 컨테이너 시스템 환경의 CPM에 적용할 수 있습니다.

CPM 버전 설치 및 업데이트

CPM 설치 및 업데이트 모두 동일한 명령을 사용하여 CPM Docker 이미지가 호스팅되는 Quay.io 리포지토리에서 최신 Docker 이미지를 가져옵니다. 모든 릴리스 목록을 보려면 quay.io/repository/newrelic/synthetics-minion 으로 이동하십시오.

CPM 이미지는 Docker Hub 에서도 호스팅됩니다. 모든 릴리스 목록을 보려면 hub.docker.com/r/newrelic/synthetics-minion/tags 로 이동하십시오.

로컬 이미지 저장소에서 이미지를 호스팅하지 않는 한 Docker가 합성 미니언 및 합성 미니언 러너 이미지를 가져오려면 방화벽을 통해 quay.io 또는 docker.io 에 대한 연결을 허용해야 합니다. "runner" 이미지는 합성 미니언 컨테이너를 시작할 때 자동으로 가져옵니다. 로컬 리포지토리 및 러너 레지스트리 끝점을 설정하는 방법에 대한 자세한 내용은 Docker 환경 구성Kubernetes 환경 구성 을 참조하세요.

CPM 시작

CPM을 시작하려면 해당 Docker 또는 Kubernetes 지침을 따르십시오.

CPM 중지 또는 삭제

Docker 컨테이너 시스템 환경에서 Docker stop 절차를 사용하여 CPM 실행을 중지합니다. Kubernetes 컨테이너 조정 시스템 환경에서 Kubernetes delete 절차를 사용하여 CPM 실행을 중지합니다.

도움말 및 예 표시

해당하는 경우 다음 옵션을 사용하십시오.

  • 명령줄 인터페이스에서 직접 가장 일반적으로 사용되는 실행 옵션 목록을 가져오려면 show help 명령을 실행합니다.

  • CPM 사용 예와 사용 가능한 모든 실행 옵션 목록을 표시하려면 다음 명령을 실행하십시오.

    docker run quay.io/newrelic/synthetics-minion:latest help
  • Docker 로그를 추적하고 모니터의 상태를 확인하려면 Containerized private minion(CPM) 유지 관리 및 모니터링 을 참조하십시오.

  • Kubernetes 컨테이너 조정 시스템 환경의 CPM의 경우 다음 Helm show 명령을 사용하여 각각 chart.yamlvalues.yaml 를 볼 수 있습니다.

    helm show chart YOUR_REPO_NAME/synthetics-minion
    helm show values YOUR_REPO_NAME/synthetics-minion

라이선스 정보 표시

CPM에서 사용하는 오픈 소스 소프트웨어에 대한 라이선스 정보를 표시하려면 LICENSE 명령어를 실행하세요.

CPM 버전 2.2.27 이상에 대한 라이선스 정보를 보려면 이 명령을 실행하십시오.

docker run quay.io/newrelic/synthetics-minion:latest LICENSE

당사의 오픈 소스 소프트웨어 중 일부는 여러 소프트웨어 라이선스 아래에 나열되어 있으며, 이 경우 사용하기로 선택한 라이선스를 나열했습니다. 라이선스 정보는 라이선스 문서 에서도 확인할 수 있습니다.

CPM 구성

사용자 지정 npm 모듈로 컨테이너화된 비공개 미니언을 구성하고, 실행 사이에 데이터를 보존하고, 환경 변수를 사용하는 등의 작업을 수행할 수 있습니다. 자세한 내용은 CPM 구성 을 참조하십시오.

네트워크

Docker 및 Kubernetes 모두에서 CPM 및 해당 러너 컨테이너는 호스트에서 네트워크 설정을 상속합니다. Docker 컨테이너 시스템 환경에서의 이에 대한 예는 Docker 사이트 를 참조하십시오.

각 러너 컨테이너에 대해 새 브리지 네트워크가 생성됩니다. 즉, 시작 시 CPM 컨테이너에 전달된 --network--dns 과 같은 네트워킹 명령 옵션(예: Docker 컨테이너 시스템 환경에서 Docker 실행 명령을 통해)은 러너 컨테이너에서 상속되거나 사용되지 않습니다.

이러한 네트워크는 생성될 때 데몬에 대해 구성된 기본 IP 주소 풀에서 가져옵니다. Docker 컨테이너 시스템 환경에서의 이에 대한 예는 Docker 사이트 를 참조하십시오.

일반적으로 러너 네트워크는 검사가 완료된 후 제거됩니다. 그러나 검사가 계속 실행되는 동안 CPM이 종료되거나 다른 예기치 않은 상황에서 종료되면 이러한 네트워크가 분리될 수 있습니다. 이는 잠재적으로 Docker 데몬에서 사용할 수 있는 IP 주소 공간을 사용할 수 있습니다.

이 경우 새 러너 컨테이너를 만들려고 할 때 CPM 로깅에 INTERNAL ENGINE ERROR code: 31 항목이 표시될 수 있습니다. Docker 컨테이너 시스템 환경에서만 이를 정리하려면 docker network prune 을 실행합니다.

보안, 샌드박싱 및 루트가 아닌 사용자로 실행

기본적으로 CPM 내에서 실행되는 소프트웨어는 root 사용자 권한으로 실행됩니다. 실행이 샌드박스 처리되므로 대부분의 시나리오에 적합합니다.

Docker 컨테이너 시스템 환경에서: 모니터를 실행하기 위해 CPM이 생성하는 컨테이너에서 사용하는 기본 AppArmor 프로필을 변경하려면 환경 변수 MINION_RUNNER_APPARMOR (CPM 버전 3.0.3 이상) 또는 MINION_DOCKER_RUNNER_APPARMOR (CPM 버전 v3. 0.2).

루트가 아닌 사용자로 CPM을 실행하려면 추가 단계가 필요합니다.

도커 이미지 저장소

단일 CPM Docker 이미지는 Docker 컨테이너 시스템 환경과 Kubernetes 컨테이너 오케스트레이션 시스템 환경을 모두 제공합니다. Docker 이미지는 quay.io에서 호스팅됩니다. Docker 이미지가 최신 상태인지 확인하려면 quay.io newrelic/synthetics-minion 저장소 를 참조하십시오.

CPM 연결에 대한 추가 고려 사항

연결

설명

인터넷에 액세스할 수 없는 CPM

CPM은 인터넷에 액세스하지 않고도 작동할 수 있지만 몇 가지 예외가 있습니다. 공개 인터넷 상태 확인은 Docker 컨테이너 시스템 환경의 경우 MINION_NETWORK_HEALTHCHECK_DISABLED , Kubernetes 컨테이너 조정 시스템 환경의 경우 synthetics.minionNetworkHealthCheckDisabled 이라는 환경 변수 를 사용하여 비활성화할 수 있습니다. CPM은 "synthetics-horde.nr-data.net" 도메인에 연결할 수 있어야 합니다. 이것은 New Relic에 데이터를 보고하고 실행할 모니터를 수신하는 데 필요합니다. 이것이 문제인지 그리고 어떻게 예외를 설정하는지 네트워크 관리자에게 문의하십시오.

프록시를 통해 합성과 통신

프록시로 New Relic과 통신을 설정하려면 다음과 같은 환경 변수 를 사용하십시오. MINION_API_PROXY*.

실행 시 통과된 인수

이는 Docker 컨테이너 환경에만 적용됩니다. 시작 시 CPM 컨테이너에 전달된 인수는 CPM에 의해 생성된 컨테이너로 전달되지 않습니다. Docker에는 컨테이너의 "상속" 또는 "계층" 개념이 없으며 CPM에서 모니터 실행 컨테이너로 전달되는 구성을 복사하지 않습니다. 그들 사이의 유일한 공유 구성은 Docker 데몬 수준에서 설정된 구성입니다.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.