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 통합은 측정항목과 인벤토리 정보를 모두 수집합니다. 이 표에서는 각 구성 옵션이 적용되는 항목을 보여줍니다.
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
환경 | 설명 | 기본값 | 에 적용 |
|---|---|---|---|
HOSTNAME | Couchbase가 실행되는 호스트 이름 또는 IP입니다. | 로컬 호스트 | 미 |
PORT | Couchbase API가 수신하는 포트입니다. | 8091 | 미 |
QUERY_PORT | Couchbase N1QL 서비스가 수신하는 포트입니다. | 8093 | 미 |
USERNAME | Couchbase API에 액세스하기 위한 사용자 이름입니다. | 해당 없음 | 미 |
PASSWORD | 지정된 사용자의 비밀번호입니다. | 해당 없음 | 미 |
USE_SSL | Couchbase와 통신할 때 SSL을 사용하십시오. | 잘못된 | 미 |
CA_BUNDLE_FILE | 호스트에서 SSL 인증서의 위치입니다. | 해당 없음 | 미 |
CA_BUNDLE_DIR | 대체 인증 기관 번들 디렉토리. | 해당 없음 | 미 |
TIMEOUT | API 요청에 대한 제한 시간(초)입니다. | 30 | 미 |
ENABLE_BUCKETS | true인 경우 버킷 리소스를 수집합니다. | 진정한 | 중 |
ENABLE_BUCKET_STATS | true인 경우 추가 버킷 통계를 수집합니다. | 진정한 | 중 |
ENABLE_CLUSTER_AND_NODES | true인 경우 클러스터 및 노드 리소스를 수집합니다. | 진정한 | 중 |
METRICS | 측정항목 전용 수집을 활성화하려면 | 잘못된 | |
INVENTORY | 인벤토리 전용 컬렉션을 활성화하려면 | 잘못된 |
이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.
- 구성 파일에 직접 값을 추가합니다(가장 일반적인 방법).
{{}}표기법을 사용하여 환경 변수의 값을 바꿉니다. 이를 위해서는 인프라 에이전트 버전 1.14.0 이상이 필요합니다. 자세한 정보는 인프라 구성을 참조하거나 환경 변수 예제를 참조하십시오.- 비밀 관리 사용. 이를 사용하여 구성 파일에서 일반 텍스트로 노출되는 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 암호 관리를 참조하세요.
라벨
레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 라벨을 사용하면 측정항목에 속성(키/값 쌍)을 추가할 수 있으며 이를 사용하여 측정항목을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 샘플 구성 파일에는 레이블의 예가 포함되어 있지만 필수가 아니므로 선택한 레이블을 제거, 수정 또는 추가할 수 있습니다.
labels: env: production role: load_balancer구성 예
데이터 찾기 및 사용
통합 데이터는 통합 대시보드 에 보고됩니다.
Couchbase 데이터는 다음 이벤트 유형 에 첨부됩니다.
CouchbaseBucketSampleCouchbaseClusterSampleCouchbaseNodeSampleCouchbaseQueryEngineSample
문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.
데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
측정항목 데이터
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 소스 아래 인프라 UI의 인벤토리 페이지 에서 사용할 수 있습니다. 인벤토리 데이터에 대한 자세한 내용은 데이터 이해를 참조하세요.
통합은 다음 Couchbase 구성 매개변수에 대한 데이터를 캡처합니다.
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.