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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

Couchbase 모니터링 통합

Couchbase 통합 은 Couchbase 클러스터에서 인벤토리 및 메트릭 데이터를 수집하여 New Relic 플랫폼으로 전송하여 Couchbase 환경의 상태를 빠르게 확인할 수 있습니다. 클러스터, 노드, 쿼리 엔진 및 버킷 수준에서 데이터를 수집하므로 문제의 원인을 추적할 수 있습니다.

통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.

호환성 및 요구 사항

우리의 통합은 Couchbase 버전 4.0 이상과 호환됩니다.

빠른 시작

Kubernetes 또는 ECS 환경에서 Couchbase를 실행하지 않는 경우 안내 설치를 권장합니다. 안내식 설치에서는 인프라 에이전트와 CLI를 사용하여 Couchbase 통합을 설정하고, 귀하의 환경에서 실행 중인 다른 애플리케이션과 로그 소스를 검색한 다음 어떤 항목을 계측해야 하는지 추천합니다.

가이드 설치는 대부분의 설정에서 작동합니다. 그러나 필요에 맞지 않으면 아래에 다른 설치 옵션이 있습니다.

시작할 준비가 되셨습니까? 사용하는 데이터 센터 지역 에 따라 관련 버튼을 클릭합니다. 설치가 완료되면 이 설명서로 돌아와서 구성 옵션을 검토하십시오.

안내 설치, 미국 지역

설치

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

' '

통합 업데이트

이 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으려면 통합 패키지인프라 에이전트를 정기적으로 업데이트하십시오.

설치 후 작업

설치가 완료되면 구성 옵션을 설정할 수 있습니다. 통합이 작동하려면 일부 구성이 필요하고 일부는 선택 사항입니다.

통합 구성

ECS 또는 Kubernetes 통합을 통해 이 통합을 활성화한 경우 해당 문서를 참조하십시오.

표준 온호스트 설치의 경우 이 통합은 YAML 구성 파일 apache-config.yml 과 함께 제공됩니다. 이 구성에서 필요한 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있습니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다. 복사 및 편집할 수 있는 샘플 구성 파일 apache-config.yml.sample 과 함께 제공됩니다.

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

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

Couchbase 구성 옵션

Couchbase 통합은 측정항목과 인벤토리 정보를 모두 수집합니다. 이 표에서는 각 구성 옵션이 적용되는 항목을 보여줍니다.

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

환경

설명

기본값

에 적용

호스트 이름

Couchbase가 실행되는 호스트 이름 또는 IP입니다.

로컬 호스트

포트

Couchbase API가 수신하는 포트입니다.

8091

QUERY_PORT

Couchbase N1QL 서비스가 수신하는 포트입니다.

8093

사용자 이름

Couchbase API에 액세스하기 위한 사용자 이름입니다.

해당 없음

비밀번호

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

해당 없음

USE_SSL

Couchbase와 통신할 때 SSL을 사용하십시오.

잘못된

CA_BUNDLE_FILE

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

해당 없음

CA_BUNDLE_DIR

대체 인증 기관 번들 디렉토리.

해당 없음

시간 초과

API 요청에 대한 제한 시간(초)입니다.

30

ENABLE_BUCKETS

true인 경우 버킷 리소스를 수집합니다.

진정한

ENABLE_BUCKET_STATS

true인 경우 추가 버킷 통계를 수집합니다.

진정한

ENABLE_CLUSTER_AND_NODES

true인 경우 클러스터 및 노드 리소스를 수집합니다.

진정한

측정항목

측정항목 전용 수집을 활성화하려면 true 으로 설정합니다.

잘못된

목록

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

잘못된

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

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

라벨

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

기본 샘플 구성 파일에는 레이블의 예가 포함되어 있지만 필수가 아니므로 선택한 레이블을 제거, 수정 또는 추가할 수 있습니다.

labels:
env: production
role: load_balancer

구성 예

데이터 찾기 및 사용

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

Couchbase 데이터는 다음 이벤트 유형 에 첨부됩니다.

  • CouchbaseBucketSample
  • CouchbaseClusterSample
  • CouchbaseNodeSample
  • CouchbaseQueryEngineSample

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

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

측정항목 데이터

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

Couchbase 버킷 샘플 메트릭

이러한 속성은 CouchbaseBucketSample 이벤트 유형에 연결됩니다.

미터법

설명

bucket.activeResidentItemsRatio

이 버킷의 RAM에 캐시된 활성 항목의 비율입니다.

bucket.averageDiskCommitTimeInMilliseconds

버킷의 평균 디스크 커밋 시간(밀리초)입니다.

bucket.averageDiskUpdateTimeInMilliseconds

버킷의 평균 디스크 업데이트 시간(밀리초)입니다.

bucket.cacheMissRatio

RAM이 아닌 디스크에서 이 버킷에 대한 초당 읽기 비율입니다.

bucket.currentConnections

외부 클라이언트 SDK, 프록시, TAP 요청 및 내부 통계 수집의 연결을 포함하여 이 서버에 대한 연결 수입니다.

bucket.dataUsedInBytes

이 버킷에서 사용하는 데이터의 양(바이트)입니다.

bucket.decrementHitsPerSecond

버킷의 초당 감소 히트 수입니다.

bucket.decrementMissesPerSecond

버킷의 초당 감소 누락 횟수입니다.

bucket.deleteHitsPerSecond

이 버킷의 초당 삭제 적중 수입니다.

bucket.deleteMissesPerSecond

이 버킷의 초당 삭제 누락 횟수입니다.

bucket.diskCreateOperationsPerSecond

이 버킷에 대해 초당 디스크에 생성된 새 항목 수입니다.

bucket.diskFetchesPerSecond

버킷의 디스크에서 항목을 가져오는 데 필요한 초당 작업 수입니다.

bucket.diskUpdateOperationsPerSecond

이 버킷에 대해 초당 디스크에서 업데이트되는 항목 수입니다.

bucket.diskUsedInBytes

버킷에 사용 중인 디스크 공간의 양(바이트)입니다.

bucket.diskWriteQueue

버킷의 디스크에 쓰기를 대기 중인 항목 수입니다.

bucket.ejectionsPerSecond

이 버킷의 디스크로 배출되는 초당 총 항목 수

bucket.evictionPolicy

버킷의 제거 정책입니다.

bucket.evictionsPerSecond

버킷에서 제거된 초당 항목 수입니다.

bucket.getHitsPerSecond

이 버킷에 포함된 데이터의 초당 가져오기 작업 수입니다.

bucket.getMissesPerSecond

이 버킷에 포함되지 않은 데이터에 대한 초당 가져오기 작업 수입니다.

bucket.hitRatio

이 버킷의 데이터와 함께 제공된 요청 가져오기의 비율입니다.

bucket.incrementHitsPerSecond

버킷의 초당 증분 적중 횟수입니다.

bucket.incrementMissesPerSecond

버킷의 초당 증분 누락 수입니다.

bucket.itemCount

버킷에 저장된 객체의 수입니다.

bucket.memoryHighWaterMarkInBytes

버킷의 자동 제거에 대한 상위 워터마크(바이트)입니다.

bucket.memoryLowWaterMarkInBytes

버킷의 자동 제거에 대한 하위 워터마크(바이트)입니다.

bucket.memoryUsedInBytes

버킷에 사용된 RAM의 양(바이트)입니다.

bucket.metadataInRAMInBytes

이 버킷의 메타데이터에 사용된 RAM의 양(바이트)입니다.

bucket.missesPerSecond

버킷의 초당 누락 수입니다.

bucket.nodeLocator

노드 로케이터의 유형입니다.

bucket.outOfMemoryErrorsPerSecond

이 버킷에 대한 하드 메모리 부족 오류 수입니다.

bucket.OverheadInBytes

버킷의 임시 데이터(지속성 대기열, 복제 대기열, 체크포인트 등)에서 사용하는 추가 메모리(바이트)입니다.

bucket.pendingResidentItemsRatio

이 버킷의 RAM에 캐시된 보류 중인 항목의 비율입니다.

bucket.quotaUtilization

버킷에서 현재 사용 중인 RAM 할당량의 백분율입니다.

bucket.readOperationsPerSecond

이 버킷의 초당 읽기(가져오기 작업) 수입니다.

bucket.readRatePerSecond

버킷의 초당 읽은 바이트 수입니다.

bucket.replicaIndex

버킷에 복제본 인덱스가 활성화되어 있는지 정의합니다.

bucket.replicaNumber

이 버킷의 복제본 수입니다.

bucket.replicaResidentItemsRatio

이 버킷의 RAM에 캐시된 복제본 항목의 비율입니다.

bucket.residentItemsRatio

이 버킷의 RAM에 캐시된 모든 항목의 비율입니다.

bucket.temporaryOutOfMemoryErrorsPerSecond

이 버킷의 메모리 부족 상황으로 인해 클라이언트 SDK에 초당 전송된 백오프 수입니다.

bucket.threadsNumber

데이터 버킷의 동시 판독기 및 작성기 수입니다.

bucket.totalOperationsPerSecond

버킷의 초당 총 작업입니다.

bucket.writeOperationsPerSecond

이 버킷에 대한 초당 쓰기(설정 작업) 수입니다.

bucket.writeRatePerSecond

버킷에 기록된 바이트입니다.

Couchbase 클러스터 샘플 메트릭

이러한 속성은 CouchbaseClusterSample 이벤트 유형에 연결됩니다.

미터법

설명

cluster.autoFailoverCount

클러스터의 자동 장애 조치 수입니다.

cluster.autoFailoverEnabled

클러스터에서 장애 조치가 활성화되었는지 여부를 나타냅니다.

cluster.databaseFragmentationThreshold

압축이 발생하는 데이터베이스 내의 백분율 수준입니다.

cluster.diskFreeInBytes

이 클러스터의 여유 디스크 공간(바이트)입니다.

cluster.diskQuotaTotalInBytes

Couchbase에서 사용할 수 있는 총 디스크 공간(바이트)입니다.

cluster.diskTotalInBytes

사용 가능한 총 디스크 공간(바이트)입니다.

cluster.diskUsedbyDataInBytes

이 클러스터의 버킷 데이터에서 사용하는 디스크(바이트)입니다.

cluster.diskUsedInBytes

이 클러스터에서 사용된 디스크 공간(바이트)입니다.

cluster.indexFragmentationThreshold

압축이 발생하는 인덱스 내의 백분율 수준입니다.

cluster.maximumBucketCount

이 클러스터가 지원하는 최대 버킷 수입니다.

cluster.memoryQuotaTotalInBytes

Couchbase에서 사용할 수 있는 총 RAM(바이트)입니다.

cluster.memoryQuotaTotalPerNodeInBytes

노드당 Couchbase에서 사용할 수 있는 총 RAM(바이트)입니다.

cluster.memoryQuotaUsedInBytes

Couchbase에서 사용하는 총 RAM(바이트)입니다.

cluster.memoryQuotaUsedPerNodeInBytes

노드당 Couchbase에서 사용하는 총 RAM(바이트)입니다.

cluster.memoryTotalInBytes

이 클러스터의 총 RAM(바이트)입니다.

cluster.memoryUsedByDataInBytes

이 클러스터의 버킷 데이터가 사용한 총 RAM(바이트)입니다.

cluster.memoryUsedInBytes

이 클러스터에서 사용된 총 RAM(바이트)입니다.

cluster.viewFragmentationThreshold

압축이 트리거되는 모든 보기 인덱스 파일 내의 조각화 비율입니다.

Couchbase 노드 샘플 메트릭

이러한 속성은 CouchbaseNodeSample 이벤트 유형에 연결됩니다.

미터법

설명

node.cpuUtilization

노드의 CPU 사용률입니다.

node.memoryFreeInBytes

노드의 여유 메모리(바이트)입니다.

node.memoryTotalInBytes

노드에 할당된 총 메모리(바이트)입니다.

node.recoveryType

노드의 복구 유형입니다.

node.services

노드의 서비스.

node.status

노드의 상태입니다. ( 0 = 비정상, 1 = 정상)

node.swapTotalInBytes

노드의 총 스왑 공간(바이트)입니다.

node.swapUsedInBytes

노드의 사용된 스왑 공간(바이트)입니다.

node.uptimeInMilliseconds

노드의 가동 시간(밀리초)입니다.

Couchbase 쿼리 엔진 샘플 메트릭

이러한 속성은 CouchbaseQueryEngineSample 이벤트 유형에 연결됩니다.

미터법

설명

queryengine.activeRequests

현재 활성 요청 수입니다.

queryengine.averageRequestTimeInMilliseconds

이 쿼리 엔진의 평균 요청 시간(밀리초)입니다.

queryengine.completedLimit

Couchbase가 쿼리 로그에 보관할 쿼리 수입니다.

queryengine.completedRequests

현재 완료된 요청 수입니다.

queryengine.completedThresholdInMilliseconds

쿼리가 Couchbase 쿼리 로그에 기록되는 데 걸리는 최소 시간(밀리초)입니다.

queryengine.cores

이 쿼리 엔진에 사용할 수 있는 코어 수입니다.

queryengine.garbageCollectionNumber

마지막 가비지 컬렉션의 번호입니다.

queryengine.garbageCollectionPaused

가비지 수집이 일시 중지된 시간의 백분율입니다.

queryengine.garbageCollectionTimePausedInMilliseconds

가비지 수집이 일시 중지된 시간(밀리초)입니다.

queryengine.medianRequestTimeInMilliseconds

이 쿼리 엔진의 중간 요청 시간(밀리초)입니다.

queryengine.preparedStatementUtilization

준비된 명령문인 요청의 비율입니다.

queryengine.requestsLast15MinutesPerSecond

지난 15분 동안의 평균 초당 요청 수입니다.

queryengine.requestsLast1MinutesPerSecond

지난 1분 동안의 평균 초당 요청 수입니다.

queryengine.requestsLast5MinutesPerSecond

지난 5분 동안의 평균 초당 요청 수입니다.

queryengine.requestTime80thPercentileInMilliseconds

이 쿼리 엔진 요청 시간의 80번째 백분위수(밀리초)입니다.

queryengine.requestTime95thPercentileInMilliseconds

이 쿼리 엔진 요청 시간의 95번째 백분위수(밀리초)입니다.

queryengine.requestTime99thPercentileInMilliseconds

이 쿼리 엔진 요청 시간의 99번째 백분위수(밀리초)입니다.

queryengine.systemCPUUtilization

이 쿼리 엔진의 CPU 사용률

queryengine.systemMemoryInBytes

이 쿼리 엔진이 예약한 가상 주소 공간(바이트)입니다.

queryengine.totalMemoryInBytes

이 쿼리 엔진이 힙 개체에 할당한 메모리의 누적 양(바이트)입니다.

queryengine.totalThreads

이 쿼리 엔진에서 사용한 총 스레드입니다.

queryengine.uptimeInMilliseconds

이 쿼리 엔진의 가동 시간(밀리초)

queryengine.usedMemoryInBytes

이 쿼리 엔진의 힙 개체에 할당된 메모리 양(바이트)입니다.

queryengine.userCPUUtilization

이 쿼리 엔진의 사용자 CPU 사용률입니다.

인벤토리 데이터

Couchbase 통합은 Couchbase 데이터베이스의 구성 매개변수를 캡처합니다. 데이터는 config/couchbase 소스 아래 인프라 UI의 Inventory 페이지 에서 사용할 수 있습니다. 재고 데이터에 대한 자세한 내용은 데이터 이해를 참조하십시오.

통합은 다음 Couchbase 구성 매개변수에 대한 데이터를 캡처합니다.

소스 코드 확인

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

Copyright © 2024 New Relic Inc.

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