• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

문제 신고

MongoDB 모니터링 통합(레거시)

중요한!

이 레거시 통합은 2024년에 단종될 예정입니다. 특정 EOL 날짜를 알게 되면 추가하겠습니다. 최신 MongoDB 통합을 사용하는 것이 좋습니다. 레거시 통합에서 새 통합으로 전환하는 방법에 대한 자세한 내용은 마이그레이션 문서를 참조하세요.

레거시 MongoDB 통합은 MongoDB 클러스터에서 인벤토리 및 메트릭을 수집하여 플랫폼으로 전송하여 주요 성능 메트릭을 집계하고 시각화할 수 있습니다. mongosmongod 인스턴스, 구성 서버, 데이터베이스 및 컬렉션에서 데이터를 수집하여 성능 병목 현상을 정확히 찾아냅니다.

호환성 및 요구 사항

이 레거시 통합은 MongoDB v3 및 v4와 호환됩니다. 최신 MongoDB 통합은 최신 버전을 지원합니다.

이 레거시 통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.

설치 및 활성화

레거시 MongoDB 통합을 설치하려면 환경에 대한 지침을 따르십시오.

' '

추가 참고 사항:

  • 고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
  • 호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지인프라 에이전트 를 정기적으로 업데이트하십시오.

구성

MongoDB 서버 활성화

MongoDB 셸에서 다음 명령을 실행하여 listCollections 역할과 새 사용자를 만듭니다. 그런 다음 새 사용자에게 clusterMonitorlistCollections 역할을 할당합니다. 참고: 사용자 이름, 암호 및 유사한 사용자별 값을 바꾸십시오.

사용자역할 생성에 대한 자세한 내용은 MongoDB 설명서를 참조하십시오.

모니터링할 mongo에서 다음 단계를 완료하십시오. 호스트 또는 복제본 세트 통계와 같은 mongod 수준 메트릭을 수집해야 하는 경우 각 mongod에 대한 역할과 사용자도 생성합니다.

  1. MongoDB 셸에서 use admin 을 입력합니다.

  2. 다음 명령어를 사용하여 listCollections 역할을 만듭니다.

    db.createRole({
    role: "listCollections",
    privileges: [{
    resource: {db:"",collection:""},
    actions: ["listCollections"]
    }],
    roles: []
    })
  3. 다음 명령어를 사용하여 새 사용자를 만들고 사용자에게 clusterMonitorlistCollections 역할을 할당합니다.

    db.createUser({
    user: "username",
    pwd: "password",
    roles: [
    "clusterMonitor",
    "listCollections"
    ]
    })

이 문서가 설치하는데 도움이 되셨나요?

통합 구성

설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.

통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다.

구성 파일에는 interval , timeout , inventory_source 와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 보려면 구성 형식 문서를 참조하십시오.

중요

여전히 레거시 구성/정의 파일을 사용하고 있다면 표준 구성 형식을 참조하십시오.

MongoDB와 관련된 특정 설정은 구성 파일의 env 섹션을 사용하여 정의됩니다. 이러한 설정은 MongoDB 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다. 유효한 설정 목록은 이 문서의 다음 섹션에 설명되어 있습니다.

전체 MongoDB 클러스터 또는 독립 실행형 MongoDB 인스턴스를 모니터링하도록 MongoDB 통합을 구성할 수 있습니다. 클러스터를 모니터링하려면 hostport 인수 가 클러스터의 mongos 인스턴스 중 하나를 가리켜야 합니다. 독립 실행형 인스턴스를 모니터링하려면 hostport 가 데이터베이스를 실행하는 mongod 를 가리켜야 합니다.

SCRAM 인증은 지원되지 않습니다.

MongoDB 인스턴스 설정

MongoDB 통합은 메트릭과 인벤토리 정보를 모두 수집합니다. 다음 표에서 각 컬렉션에 사용할 수 있는 설정에 대한 적용 대상 열을 참조하십시오.

이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.

  • 구성 파일에 직접 값을 추가합니다. 이것은 가장 일반적인 방법입니다.
  • {{}} 표기법을 사용하여 환경 변수의 값 바꾸기. 이를 위해서는 인프라 에이전트 v1.14.0 이상이 필요합니다. 자세한 내용은 통과 에 대한 설명서를 참조하거나 대체 예를 참조하십시오.
  • 비밀 관리를 사용합니다. 이를 사용하여 구성 파일에서 일반 텍스트로 노출될 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

환경

설명

에 적용

MONGODB_CLUSTER_NAME

모니터링 중인 클러스터를 고유하게 식별하기 위한 사용자 정의 이름입니다. 필수 .

측정항목/인벤토리

주최자

MongoDB가 실행 중인 호스트 이름 또는 IP입니다. 기본값은 localhost 입니다.

측정항목/인벤토리

포트

MongoDB가 수신 대기하는 포트입니다. 기본값은 27017입니다.

측정항목/인벤토리

사용자 이름

MongoDB 서버에 액세스하기 위한 사용자 이름입니다.

측정항목/인벤토리

비밀번호

지정된 사용자의 비밀번호입니다.

측정항목/인벤토리

AUTH_SOURCE

인증할 데이터베이스입니다. 기본값은 admin 입니다.

측정항목/인벤토리

SSL

MongoDB 서버와 통신할 때 SSL을 사용하십시오. 기본값은 false 입니다.

측정항목/인벤토리

SSL_CA_CERTS

호스트에서 SSL 인증서의 위치입니다. SSLtrue 경우에만 필요합니다.

측정항목/인벤토리

SSL_INSECURE_SKIP_VERIFY

서버의 인증서 체인 및 호스트 이름 확인을 건너뜁니다. 기본값은 false 입니다.

측정항목/인벤토리

PEM_KEY_FILE

개인 키 및 클라이언트 인증서가 포함된 PEM 파일의 위치입니다.

측정항목/인벤토리

암호

PEMKeyFile 파일을 해독하기 위한 암호입니다.

측정항목/인벤토리

CONCURRENT_COLLECTIONS

메트릭을 동시에 수집할 엔터티 수입니다. 기본값은 50입니다.

메트릭

필터

컬렉션 이름 배열에 대한 데이터베이스 이름의 JSON 맵. 비어 있으면 모든 데이터베이스 및 컬렉션이 기본값입니다.

메트릭

측정항목

측정항목 전용 수집을 활성화하려면 true 으로 설정합니다. 기본값은 false 입니다.

목록

인벤토리 전용 컬렉션을 활성화하려면 true 으로 설정합니다. 기본값은 false 입니다.

라벨 및 사용자 정의 속성

레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키/값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.

기본 샘플 구성 파일에는 레이블의 예가 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.

labels:
env: production
role: load_balancer

구성 예

데이터 찾기 및 사용

이 서비스의 데이터는 통합 대시보드 에 보고됩니다.

메트릭은 다음 이벤트 유형 에 연결됩니다.

  • MongoCollectionSample
  • MongoConfigServerSample
  • MongoDatabaseSample
  • MongodTopSample
  • MongoSample
  • MongodSample
  • MongosSample

문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.

데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

측정항목 데이터

MongoDB 통합은 다음 메트릭 데이터 속성을 수집합니다. 일부 측정항목 이름에는 asserts. 또는 collection. 과 같이 카테고리 표시기와 마침표가 접두사로 붙습니다.

클러스터 또는 독립 실행형 인스턴스가 모니터링되는지 여부에 따라 다른 메트릭을 사용할 수 있습니다. 독립 실행형 인스턴스의 경우 MongodSample , MongoDatabaseSample , MongodTopSampleMongoCollectionSample 만 수집됩니다. 클러스터의 경우 모든 이벤트 유형이 수집됩니다.

인벤토리 데이터

MongoDB 통합은 클러스터의 각 호스트에서 모든 명령줄 옵션과 런타임 구성 매개변수를 캡처합니다.

데이터는 config/mongodb 소스 아래의 인벤토리 페이지 에서 사용할 수 있습니다. 인벤토리 데이터에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

소스 코드 확인

이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.

Copyright © 2024 New Relic Inc.

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