/ /

/ /

Retrieve Telemetry Data

Ops Manager 설치에 대한 원격 분석 컬렉션 상태 및 구성 세부 정보를 검색합니다.

필수 역할

이 엔드포인트에는 역할 있는 API 키가 Global Owner 필요합니다.

엔드포인트

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/private/v1.0/telemetry

GET /collection/details

요청

경로 매개변수

이 엔드포인트는 HTTP 요청 경로 매개변수를 사용하지 않습니다.

쿼리 매개변수

이 엔드포인트는 HTTP 요청 쿼리 매개변수를 사용하지 않습니다.

본문 매개변수

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답

응답 문서

응답 JSON 문서 다음 필드가 포함되어 있습니다.

이름	유형	설명
활성화됨	부울	시스템이 원격 분석을 수집하고 전송하는지 여부를 나타냅니다.
last_successful_send	datetime	마지막으로 성공적인 원격 분석 전송의 날짜 및 시간입니다.
Next_job	datetime	다음 원격 분석 전송이 예약된 날짜 및 시간입니다.
데이터	배열	원격 분석 데이터 내장된 객체 에 정의된 객체의 배열입니다.

원격 분석 데이터 내장된 객체

data 배열 의 각 요소는 Ops Manager 설치에 대한 원격 분석 세부 정보를 설명합니다.

이름	유형	설명
app_db_nodes	integer	이 Ops Manager 설치에서 사용하는 AppDB 노드의 수입니다.
uuid	문자열	이 Ops Manager 설치에 대한 정적 고유 식별자입니다.
os	문자열 배열	Ops Manager 호스트에서 실행 운영 체제입니다.
버전	문자열	현재 Ops Manager 버전입니다.
인스턴스	integer	이 설치에 있는 Ops Manager 인스턴스의 수입니다.
backup_daimons	integer	이 설치에서 실행 백업 데몬의 수입니다.
auth_method	문자열	Ops Manager 사용하는 인증 방법입니다. 가능한 값: `DB`, `LDAP` 또는 `SAML`.
중앙처리장치	정수 배열	각 Ops Manager 호스팅하다 에 프로비저닝된 CPU 코어 수입니다.
메모리	정수 배열	각 Ops Manager 호스팅하다 에 프로비저닝된 메모리의 양입니다.
인프라	문자열	Ops Manager 호스팅하는 인프라 유형입니다. 가능한 값: `Kubernetes`, `VM` 또는 `Bare Metal`.
프로젝트	integer	현재 존재하는 프로젝트의 총 개수입니다.
조직	integer	현재 존재하는 조직의 총 개수입니다.
배포서버	배열	원격 분석 배포 포함된 객체에 정의된 객체의 배열입니다.

원격 분석 배포 포함된 객체

deployments 배열 의 각 요소는 Ops Manager 관리하는 MongoDB deployment 설명합니다.

이름	유형	설명
버전	문자열 배열	배포서버 에서 사용하는 MongoDB 버전입니다.
uuid	문자열	배포서버 에 대한 정적 고유 식별자입니다.
tls_enabled	부울	배포서버 에TLS가 활성화되어 있는지 여부를 나타냅니다.
auth_method	문자열	배포서버 에서 사용하는 인증 방법입니다. 가능한 값은 `MONGODB-CR`, `GSSAPI`, `PLAIN` 또는 `MONGODB-X509`입니다.
유형	문자열	배포 유형. 가능한 값: `SC`, `RS` 또는 `SA`.
노드	integer	복제본 세트 인 경우 배포서버 의 노드 수입니다.
shards	integer	배포 샤딩된 클러스터 인 경우 배포서버 의 샤드 수입니다.
data_size	integer	로컬 메타데이터 포함하지 않은 배포서버 의 총 데이터 크기입니다.
판	객체	두 개의 키 `community` 및 `enterprise`를 포함하는 객체입니다. 각 키에는 배포서버 에서 해당 에디션의 노드 수를 나타내는 정수 값이 있습니다.

요청 예시

curl --user "{publicApiKey}:{privateApiKey}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request GET "https://<OpsManagerHost>:<Port>/api/private/v1.0/telemetry/collection/details"

응답 예시

응답 헤더

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

응답 본문

{
  "data": {
    "app_db_nodes": 1,
    "auth_method": "DB",
    "backup_daemons": 3,
    "cpu": [
      14,12
    ],
    "infrastructure": "Bare Metal",
    "instances": 2,
    "memory": [
      "3221225472","221225472"
    ],
    "os": [
      "RHEL 8.10 aarch64","RHEL 8.11 aarch64"
    ],
    "orgs": 3,
    "projects": 12,
    "uuid": "84248c7e-94df-4a0c-942a-dfb1fa987edd",
    "version": "8.0.13",
    "deployments": [
      {
        "auth_method": "MONGODB-CR",
        "data_size": 3221225472,
        "edition": {
          "community": 3,
          "enterprise": 0
       },
        "nodes": 3,
        "tls_enabled": true,
        "type": "RS",
        "uuid": "6907dd45d61b992049366140",
        "version": [
          "8.15","7.11"
        ]
       },
       {
         "auth_method": "MONGODB-CR",
           "data_size": 221225472,
           "edition": {
             "community": 1,
             "enterprise": 2
             },
             "shards": 3,
             "tls_enabled": false,
             "type": "SC",
             "uuid": "6907de15d61b9920493664ca",
             "version": [
               "8.15"
             ]
         }
     ],
  },
  "enabled": true,
  "last_successful_send": "2025-10-02T22:26:10Z",
  "next_job": "2025-10-09T22:26:10Z"
}

돌아가기

텔레메트리

원격 분석 상태 전환