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

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

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

문제 신고

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

중요한!

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

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

호환성 및 요구 사항

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

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

설치 및 활성화

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

' '

추가 참고 사항:

구성

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 통합은 지표 정보와 인벤토리 정보를 모두 수집합니다. 다음 표에서 각 컬렉션에 사용할 수 있는 설정은 Applies To 열을 참조하세요.

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

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

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

환경

설명

에 적용

MONGODB_CLUSTER_NAME

모니터링 중인 클러스터를 고유하게 식별하는 사용자 정의 이름입니다. Required.

측정항목/인벤토리

HOST

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

측정항목/인벤토리

PORT

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

측정항목/인벤토리

USERNAME

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

측정항목/인벤토리

PASSWORD

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

측정항목/인벤토리

AUTH_SOURCE

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

측정항목/인벤토리

SSL

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

측정항목/인벤토리

SSL_CA_CERTS

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

측정항목/인벤토리

SSL_INSECURE_SKIP_VERIFY

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

측정항목/인벤토리

PEM_KEY_FILE

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

측정항목/인벤토리

PASSPHRASE

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

측정항목/인벤토리

CONCURRENT_COLLECTIONS

동시에 수집할 엔터티의 개수입니다. 기본값은 50 입니다.

메트릭

FILTERS

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

메트릭

METRICS

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

INVENTORY

인벤토리 전용 컬렉션을 활성화하려면 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.