Couchbase 통합 은 Couchbase 클러스터에서 인벤토리 및 메트릭 데이터를 수집하여 New Relic 플랫폼으로 전송하여 Couchbase 환경의 상태를 빠르게 확인할 수 있습니다. 클러스터, 노드, 쿼리 엔진 및 버킷 수준에서 데이터를 수집하므로 문제의 원인을 추적할 수 있습니다.
통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.
호환성 및 요구 사항
우리의 통합은 Couchbase 버전 4.0 이상과 호환됩니다.
통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
Couchbase가 Kubernetes에서 실행되고 있지 않다면 Couchbase를 실행하는 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:
빠른 시작
Couchbase 클러스터를 신속하게 계측하고 설치 안내를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 맞춤형 CLI 명령을 생성합니다.
시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.
가이드 설치는 인프라 에이전트를 사용하여 Couchbase 통합을 설정합니다. 뿐만 아니라 사용자 환경에서 실행 중인 다른 애플리케이션 및 로그 소스를 검색한 다음 계측해야 하는 것을 추천합니다.
안내 설치는 대부분의 설정에서 작동합니다. 그러나 귀하의 요구 사항에 적합하지 않은 경우 아래에서 다른 방법을 찾아 Couchbase 클러스터 모니터링을 시작할 수 있습니다.
설치 및 활성화
Couchbase 통합을 설치하려면 환경에 대한 지침을 따르십시오.
' '
추가 참고 사항:
- 고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
- 호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.
구성
통합 구성
설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.
- Kubernetes를 통해 활성화된 경우: Kubernetes에서 실행 중인 서비스 모니터링을 참조하십시오.
- Amazon ECS를 통해 활성화된 경우: ECS에서 실행 중인 서비스 모니터링을 참조하십시오.
- 호스트에 설치된 경우: 통합의 YAML 구성 파일
couchbase-config.yml
에서 구성을 편집합니다.
통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다.
구성 파일에는 interval
, timeout
, inventory_source
와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 보려면 구성 형식 문서를 참조하십시오.
중요
레거시 구성/정의 파일을 계속 사용하고 있다면 이 문서 에서 도움을 받으십시오.
Couchbase와 관련된 특정 설정은 구성 파일의 env
섹션을 사용하여 정의됩니다. 이러한 설정은 Couchbase 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다. 유효한 설정 목록은 이 문서의 다음 섹션에 설명되어 있습니다.
카우치베이스 인스턴스 설정
Couchbase 통합은 메트릭( M ) 및 인벤토리( I ) 정보를 모두 수집합니다. 표에서 각 컬렉션에 사용할 수 있는 설정에 대해 적용 대상 열을 사용합니다.
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
환경 | 설명 | 기본값 | 에 적용 |
---|---|---|---|
호스트 이름 | Couchbase가 실행되는 호스트 이름 또는 IP입니다. | 로컬 호스트 | 미 |
포트 | Couchbase API가 수신하는 포트입니다. | 8091 | 미 |
QUERY_PORT | Couchbase N1QL 서비스가 수신하는 포트입니다. | 8093 | 미 |
사용자 이름 | Couchbase API에 액세스하기 위한 사용자 이름입니다. | 해당 없음 | 미 |
비밀번호 | 지정된 사용자의 비밀번호입니다. | 해당 없음 | 미 |
USE_SSL | Couchbase와 통신할 때 SSL을 사용하십시오. | 잘못된 | 미 |
CA_BUNDLE_FILE | 호스트에서 SSL 인증서의 위치입니다. | 해당 없음 | 미 |
CA_BUNDLE_DIR | 대체 인증 기관 번들 디렉토리. | 해당 없음 | 미 |
시간 초과 | API 요청에 대한 제한 시간(초)입니다. | 30 | 미 |
ENABLE_BUCKETS | true인 경우 버킷 리소스를 수집합니다. | 진정한 | 중 |
ENABLE_BUCKET_STATS | true인 경우 추가 버킷 통계를 수집합니다. | 진정한 | 중 |
ENABLE_CLUSTER_AND_NODES | true인 경우 클러스터 및 노드 리소스를 수집합니다. | 진정한 | 중 |
측정항목 | 측정항목 전용 수집을 활성화하려면 | 잘못된 | |
목록 | 인벤토리 전용 컬렉션을 활성화하려면 | 잘못된 |
이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.
- 구성 파일에 직접 값을 추가합니다. 이것은 가장 일반적인 방법입니다.
{{}}
표기법을 사용하여 환경 변수의 값 바꾸기. 이를 위해서는 인프라 에이전트 v1.14.0 이상이 필요합니다. 여기에서 자세한 내용을 읽거나 아래 의 예를 참조하십시오.- 비밀 관리를 사용합니다. 이를 사용하여 구성 파일에서 일반 텍스트로 노출될 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.
라벨/맞춤 속성
레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키/값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 샘플 구성 파일에는 레이블의 예가 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.
labels: env: production role: load_balancer
구성 예
데이터 찾기 및 사용
통합 데이터는 통합 대시보드 에 보고됩니다.
Couchbase 데이터는 다음 이벤트 유형 에 첨부됩니다.
CouchbaseBucketSample
CouchbaseClusterSample
CouchbaseNodeSample
CouchbaseQueryEngineSample
문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.
데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
측정항목 데이터
Couchbase 통합은 다음 메트릭 데이터 속성을 수집합니다. 일부 측정항목 이름은 cluster.
또는 node.
과 같이 카테고리 표시기와 마침표가 접두사로 붙습니다.
Couchbase 버킷 샘플 메트릭
이러한 속성은 CouchbaseBucketSample
이벤트 유형에 연결됩니다.
미터법 | 설명 |
---|---|
| 이 버킷의 RAM에 캐시된 활성 항목의 비율입니다. |
| 버킷의 평균 디스크 커밋 시간(밀리초)입니다. |
| 버킷의 평균 디스크 업데이트 시간(밀리초)입니다. |
| RAM이 아닌 디스크에서 이 버킷에 대한 초당 읽기 비율입니다. |
| 외부 클라이언트 SDK, 프록시, TAP 요청 및 내부 통계 수집의 연결을 포함하여 이 서버에 대한 연결 수입니다. |
| 이 버킷에서 사용하는 데이터의 양(바이트)입니다. |
| 버킷의 초당 감소 히트 수입니다. |
| 버킷의 초당 감소 누락 횟수입니다. |
| 이 버킷의 초당 삭제 적중 수입니다. |
| 이 버킷의 초당 삭제 누락 횟수입니다. |
| 이 버킷에 대해 초당 디스크에 생성된 새 항목 수입니다. |
| 버킷의 디스크에서 항목을 가져오는 데 필요한 초당 작업 수입니다. |
| 이 버킷에 대해 초당 디스크에서 업데이트되는 항목 수입니다. |
| 버킷에 사용 중인 디스크 공간의 양(바이트)입니다. |
| 버킷의 디스크에 쓰기를 대기 중인 항목 수입니다. |
| 이 버킷의 디스크로 배출되는 초당 총 항목 수 |
| 버킷의 제거 정책입니다. |
| 버킷에서 제거된 초당 항목 수입니다. |
| 이 버킷에 포함된 데이터의 초당 가져오기 작업 수입니다. |
| 이 버킷에 포함되지 않은 데이터에 대한 초당 가져오기 작업 수입니다. |
| 이 버킷의 데이터와 함께 제공된 요청 가져오기의 비율입니다. |
| 버킷의 초당 증분 적중 횟수입니다. |
| 버킷의 초당 증분 누락 수입니다. |
| 버킷에 저장된 객체의 수입니다. |
| 버킷의 자동 제거에 대한 상위 워터마크(바이트)입니다. |
| 버킷의 자동 제거에 대한 하위 워터마크(바이트)입니다. |
| 버킷에 사용된 RAM의 양(바이트)입니다. |
| 이 버킷의 메타데이터에 사용된 RAM의 양(바이트)입니다. |
| 버킷의 초당 누락 수입니다. |
| 노드 로케이터의 유형입니다. |
| 이 버킷에 대한 하드 메모리 부족 오류 수입니다. |
| 버킷의 임시 데이터(지속성 대기열, 복제 대기열, 체크포인트 등)에서 사용하는 추가 메모리(바이트)입니다. |
| 이 버킷의 RAM에 캐시된 보류 중인 항목의 비율입니다. |
| 버킷에서 현재 사용 중인 RAM 할당량의 백분율입니다. |
| 이 버킷의 초당 읽기(가져오기 작업) 수입니다. |
| 버킷의 초당 읽은 바이트 수입니다. |
| 버킷에 복제본 인덱스가 활성화되어 있는지 정의합니다. |
| 이 버킷의 복제본 수입니다. |
| 이 버킷의 RAM에 캐시된 복제본 항목의 비율입니다. |
| 이 버킷의 RAM에 캐시된 모든 항목의 비율입니다. |
| 이 버킷의 메모리 부족 상황으로 인해 클라이언트 SDK에 초당 전송된 백오프 수입니다. |
| 데이터 버킷의 동시 판독기 및 작성기 수입니다. |
| 버킷의 초당 총 작업입니다. |
| 이 버킷에 대한 초당 쓰기(설정 작업) 수입니다. |
| 버킷에 기록된 바이트입니다. |
Couchbase 클러스터 샘플 메트릭
이러한 속성은 CouchbaseClusterSample
이벤트 유형에 연결됩니다.
미터법 | 설명 |
---|---|
| 클러스터의 자동 장애 조치 수입니다. |
| 클러스터에서 장애 조치가 활성화되었는지 여부를 나타냅니다. |
| 압축이 발생하는 데이터베이스 내의 백분율 수준입니다. |
| 이 클러스터의 여유 디스크 공간(바이트)입니다. |
| Couchbase에서 사용할 수 있는 총 디스크 공간(바이트)입니다. |
| 사용 가능한 총 디스크 공간(바이트)입니다. |
| 이 클러스터의 버킷 데이터에서 사용하는 디스크(바이트)입니다. |
| 이 클러스터에서 사용된 디스크 공간(바이트)입니다. |
| 압축이 발생하는 인덱스 내의 백분율 수준입니다. |
| 이 클러스터가 지원하는 최대 버킷 수입니다. |
| Couchbase에서 사용할 수 있는 총 RAM(바이트)입니다. |
| 노드당 Couchbase에서 사용할 수 있는 총 RAM(바이트)입니다. |
| Couchbase에서 사용하는 총 RAM(바이트)입니다. |
| 노드당 Couchbase에서 사용하는 총 RAM(바이트)입니다. |
| 이 클러스터의 총 RAM(바이트)입니다. |
| 이 클러스터의 버킷 데이터가 사용한 총 RAM(바이트)입니다. |
| 이 클러스터에서 사용된 총 RAM(바이트)입니다. |
| 압축이 트리거되는 모든 보기 인덱스 파일 내의 조각화 비율입니다. |
Couchbase 노드 샘플 메트릭
이러한 속성은 CouchbaseNodeSample
이벤트 유형에 연결됩니다.
미터법 | 설명 |
---|---|
| 노드의 CPU 사용률입니다. |
| 노드의 여유 메모리(바이트)입니다. |
| 노드에 할당된 총 메모리(바이트)입니다. |
| 노드의 복구 유형입니다. |
| 노드의 서비스. |
| 노드의 상태입니다. ( |
| 노드의 총 스왑 공간(바이트)입니다. |
| 노드의 사용된 스왑 공간(바이트)입니다. |
| 노드의 가동 시간(밀리초)입니다. |
Couchbase 쿼리 엔진 샘플 메트릭
이러한 속성은 CouchbaseQueryEngineSample
이벤트 유형에 연결됩니다.
미터법 | 설명 |
---|---|
| 현재 활성 요청 수입니다. |
| 이 쿼리 엔진의 평균 요청 시간(밀리초)입니다. |
| Couchbase가 쿼리 로그에 보관할 쿼리 수입니다. |
| 현재 완료된 요청 수입니다. |
| 쿼리가 Couchbase 쿼리 로그에 기록되는 데 걸리는 최소 시간(밀리초)입니다. |
| 이 쿼리 엔진에 사용할 수 있는 코어 수입니다. |
| 마지막 가비지 컬렉션의 번호입니다. |
| 가비지 수집이 일시 중지된 시간의 백분율입니다. |
| 가비지 수집이 일시 중지된 시간(밀리초)입니다. |
| 이 쿼리 엔진의 중간 요청 시간(밀리초)입니다. |
| 준비된 명령문인 요청의 비율입니다. |
| 지난 15분 동안의 평균 초당 요청 수입니다. |
| 지난 1분 동안의 평균 초당 요청 수입니다. |
| 지난 5분 동안의 평균 초당 요청 수입니다. |
| 이 쿼리 엔진 요청 시간의 80번째 백분위수(밀리초)입니다. |
| 이 쿼리 엔진 요청 시간의 95번째 백분위수(밀리초)입니다. |
| 이 쿼리 엔진 요청 시간의 99번째 백분위수(밀리초)입니다. |
| 이 쿼리 엔진의 CPU 사용률 |
| 이 쿼리 엔진이 예약한 가상 주소 공간(바이트)입니다. |
| 이 쿼리 엔진이 힙 개체에 할당한 메모리의 누적 양(바이트)입니다. |
| 이 쿼리 엔진에서 사용한 총 스레드입니다. |
| 이 쿼리 엔진의 가동 시간(밀리초) |
| 이 쿼리 엔진의 힙 개체에 할당된 메모리 양(바이트)입니다. |
| 이 쿼리 엔진의 사용자 CPU 사용률입니다. |
인벤토리 데이터
Couchbase 통합은 Couchbase 데이터베이스의 구성 매개변수를 캡처합니다. 데이터는 config/couchbase 소스 아래의 인프라 인벤토리 페이지 에서 사용할 수 있습니다. 인벤토리 데이터에 대한 자세한 내용은 데이터 이해 를 참조하십시오.
통합은 다음 Couchbase 구성 매개변수에 대한 데이터를 캡처합니다.
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 고유한 포크를 만들어 빌드할 수 있습니다.