Cassandra 통합은 성능 메트릭 및 인벤토리 데이터 를 Cassandra 데이터베이스에서 New Relic 플랫폼으로 보냅니다. Cassandra 지표 데이터의 사전 구축된 대시보드를 보고, 경고 정책을 생성하고, 사용자 지정 쿼리 및 차트를 생성할 수 있습니다.
통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.
호환성 및 요구 사항
우리의 통합은 Apache Cassandra 버전 3.x 이상과 호환됩니다.
통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
자바 런타임 환경 7 이상.
Cassandra가 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않으면 Cassandra를 실행하는 Linux 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:
빠른 시작: 설치 안내 사용
Cassandra 데이터베이스를 신속하게 계측하고 설치 안내를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 맞춤형 CLI 명령을 생성합니다.
시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.
가이드 설치는 인프라 에이전트를 사용하여 Cassandra 통합을 설정합니다. 뿐만 아니라 사용자 환경에서 실행 중인 다른 애플리케이션 및 로그 소스를 검색한 다음 계측해야 하는 것을 추천합니다.
안내 설치는 대부분의 설정에서 작동합니다. 그러나 귀하의 요구 사항에 적합하지 않은 경우 아래에서 다른 방법을 찾아 Cassandra 데이터베이스 모니터링을 시작할 수 있습니다.
설치 및 활성화
Cassandra 통합을 설치하려면 환경에 대한 지침을 따르세요.
추가 참고 사항:
- 고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
- 호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.
' '
구성
통합 구성
설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.
- Kubernetes를 통해 활성화된 경우: Kubernetes에서 실행 중인 서비스 모니터링을 참조하십시오.
- Amazon ECS를 통해 활성화된 경우: ECS에서 실행 중인 서비스 모니터링을 참조하십시오.
- 호스트에 설치된 경우: 통합의 YAML 구성 파일
cassandra-config.yml
에서 구성을 편집합니다.
통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다.
구성 파일에는 interval
, timeout
, inventory_source
와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 보려면 구성 형식 문서를 참조하십시오.
중요
레거시 구성/정의 파일을 계속 사용하고 있다면 이 문서 에서 도움을 받으십시오.
Cassandra와 관련된 특정 설정은 구성 파일의 env
섹션을 사용하여 정의됩니다. 이러한 설정은 Cassandra 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다. 유효한 설정 목록은 이 문서의 다음 섹션에 설명되어 있습니다.
카산드라 인스턴스 설정
Cassandra 통합은 메트릭( M ) 및 인벤토리( I ) 정보를 모두 수집합니다. 표에서 각 컬렉션에 사용할 수 있는 설정에 대해 적용 대상 열을 사용합니다.
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
환경 | 설명 | 기본값 | 에 적용 |
---|---|---|---|
호스트 이름 | Cassandra가 실행 중인 호스트 이름 또는 IP입니다. | 로컬 호스트 | 미 |
포트 | Cassandra가 수신 대기 중인 포트입니다. | 7199 | 중 |
사용자 이름 | JMX에 액세스하기 위한 사용자 이름입니다. | 해당 없음 | 중 |
비밀번호 | 지정된 사용자의 비밀번호입니다. | 해당 없음 | 중 |
CONFIG_PATH | Cassandra 구성 파일의 경로입니다. | /etc/카산드라/ | 나 |
COLUMN_FAMILIES_LIMIT | Cassandra Column Family 수 제한. | 도면 1 | 중 |
시간 초과 | 요청 시간 초과(밀리초)입니다. | 2000 년 | 중 |
KEY_STORE | JMX 클라이언트의 SSL 인증서를 포함하는 키 저장소의 파일 경로. | 해당 없음 | 중 |
KEY_STORE_PASSWORD | JMX SSL 키 저장소의 비밀번호입니다. | 해당 없음 | 중 |
TRUST_STORE | JMX 클라이언트의 SSL 인증서가 포함된 신뢰 저장소의 파일 경로입니다. | 해당 없음 | 중 |
TRUST_STORE_PASSWORD | JMX SSL 신뢰 저장소의 비밀번호입니다. | 해당 없음 | 중 |
다중 테넌시 모니터링을 활성화합니다. | 잘못된 | 미 | |
측정항목 | 측정항목 전용 수집을 활성화하려면 | 잘못된 | |
목록 | 인벤토리 전용 컬렉션을 활성화하려면 | 잘못된 |
이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.
- 구성 파일에 직접 값을 추가합니다. 이것은 가장 일반적인 방법입니다.
{{}}
표기법을 사용하여 환경 변수의 값 바꾸기. 이를 위해서는 인프라 에이전트 v1.14.0 이상이 필요합니다. 여기에서 자세한 내용을 읽거나 아래 의 예를 참조하십시오.- 비밀 관리를 사용합니다. 이를 사용하여 구성 파일에서 일반 텍스트로 노출될 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.
라벨/맞춤 속성
레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키/값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 샘플 구성 파일에는 레이블의 예가 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.
labels: env: production role: load_balancer
구성 예
데이터 찾기 및 사용
이 서비스의 데이터는 통합 대시보드 에 보고됩니다.
Cassandra 데이터는 CassandraSample
및 CassandraColumnFamilySample
이벤트 유형 에 연결됩니다. 문제 해결을 위해 또는 차트 및 대시보드를 생성하기 위해 이 데이터를 쿼리 할 수 있습니다.
데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
측정항목 데이터
Cassandra 통합은 다음 메트릭을 수집합니다.
노드 측정항목
Cassandra 노드 측정항목은 CassandraSample
이벤트 유형 에 연결됩니다. Cassandra 통합은 다음 노드 메트릭을 수집합니다.
이름 | 설명 |
---|---|
| 힙에 있는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 양입니다. |
| 오프 힙에 있는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 양입니다. |
| 초당 작성된 커밋 로그 메시지 수입니다. |
| 작성되었지만 아직 fsync되지 않은 커밋 로그 메시지 수입니다. |
| 모든 커밋 로그 세그먼트에서 사용하는 현재 크기(바이트)입니다. |
| 이 유형의 요청에 대해 초당 삭제된 메시지입니다. |
| 키 캐시 용량(바이트)입니다. |
| 1분 키 캐시 적중률입니다. |
| 초당 키 캐시 적중 횟수입니다. |
| 초당 키 캐시에 대한 요청 수입니다. |
| 점유된 캐시의 크기(바이트)입니다. |
| 이 열 패밀리에 대한 디스크의 SSTable 수입니다. |
| 이 노드가 관리하는 온디스크 데이터 크기의 크기(바이트)입니다. |
| 행 캐시 용량(바이트)입니다. |
| 1분 행 캐시 적중률입니다. |
| 초당 행 캐시 적중 수입니다. |
| 초당 행 캐시에 대한 요청 수입니다. |
| 점유된 행 캐시의 총 크기(바이트)입니다. |
| 이 풀에서 활발하게 작업 중인 작업 수입니다.
|
| 이 풀에서 활발하게 작업 중인 작업 수입니다. |
| 현재 전송을 시도하는 힌트의 수입니다. |
| 이 노드에 기록된 초당 힌트 메시지 수입니다. 힌트당 힌트될 각 호스트에 대해 하나의 항목을 포함합니다. |
| 초당 요청의 트랜잭션 읽기 대기 시간입니다. |
| 초당 요청의 트랜잭션 쓰기 대기 시간입니다. |
| 초당 범위 슬라이스 요청 수입니다. |
| 토큰 범위 읽기 요청을 처리할 때 발생한 초당 시간 초과 횟수입니다. |
| 토큰 범위 읽기 요청을 처리할 때 발생한 초당 사용할 수 없는 예외 수입니다. |
| 읽기 지연 시간(밀리초), 50번째 백분위수. |
| 읽기 지연 시간(밀리초), 75번째 백분위수. |
| 읽기 지연 시간(밀리초), 95번째 백분위수. |
| 읽기 지연 시간(밀리초), 98번째 백분위수. |
| 읽기 지연 시간(밀리초), 999번째 백분위수. |
| 읽기 지연 시간(밀리초), 99번째 백분위수. |
| 초당 읽기 요청 수입니다. |
| 표준 읽기 요청을 처리할 때 발생한 초당 시간 초과 횟수입니다. |
| 표준 읽기 요청을 처리할 때 발생한 초당 사용할 수 없는 예외 수입니다. |
| 초당 보기 쓰기 요청 수입니다. |
| 쓰기 지연 시간(밀리초), 50번째 백분위수. |
| 쓰기 지연 시간(밀리초), 75번째 백분위수. |
| 쓰기 지연 시간(밀리초), 95번째 백분위수. |
| 쓰기 지연 시간(밀리초), 98번째 백분위수. |
| 쓰기 지연 시간(밀리초), 999번째 백분위수. |
| 쓰기 지연 시간(밀리초), 99번째 백분위수. |
| 초당 쓰기 요청 수입니다. |
| 일반 쓰기 요청을 처리할 때 발생한 초당 시간 초과 횟수입니다. |
| 일반 쓰기 요청을 처리할 때 발생한 초당 사용할 수 없는 예외 수입니다. |
Cassandra 컬럼 패밀리 메트릭 및 메타데이터
Cassandra 통합은 열 패밀리 메트릭을 검색합니다. Cassandra column family 데이터 는 CassandraColumnFamilySample
이벤트 유형에 연결됩니다. 시스템 키스페이스( system
, system_auth
, system_distributed
, system_schema
, system_traces
및 OpsCenter
)를 건너뜁니다. 성능 영향을 제한하기 위해 통합은 최대 20개의 열 패밀리에 대한 메트릭만 캡처합니다.
다음 메타데이터는 샘플 메트릭과 연결된 키스페이스 및 열 패밀리를 나타냅니다.
이름 | 설명 |
---|---|
| 이 메트릭이 참조하는 Cassandra 열 패밀리입니다. |
| 이 열 패밀리를 포함하는 Cassandra 키스페이스입니다. |
| 다음 형식의 단일 메타데이터 속성에 있는 키스페이스 및 열 패밀리: |
아래 메트릭 목록은 위의 메타데이터에 지정된 특정 키스페이스 및 열 패밀리를 참조합니다.
이름 | 설명 |
---|---|
| 오프 힙에 있는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 수입니다. |
| 힙에 상주하는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 수입니다. |
| 이 열 패밀리에 속하는 SSTable에서 사용하는 디스크 공간(바이트)입니다. |
| 이 열 패밀리에 대한 디스크의 SSTable 수입니다. |
| 이 열 패밀리에 대해 보류 중인 압축 수의 추정치입니다. |
| 읽기당 액세스한 안정적인 데이터 파일 수, 50번째 백분위수. |
| 읽기당 액세스한 안정적인 데이터 파일 수, 75번째 백분위수. |
| 읽기당 액세스한 안정적인 데이터 파일 수, 95번째 백분위수. |
| 읽기당 액세스한 안정적인 데이터 파일 수, 98번째 백분위수. |
| 읽기당 액세스한 안정적인 데이터 파일 수, 999번째 백분위수. |
| 읽기당 액세스한 안정적인 데이터 파일 수, 99번째 백분위수. |
| 이 column family, 50번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다. |
| 이 column family, 75번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다. |
| 이 column family, 95번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다. |
| 이 column family, 98번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다. |
| 이 column family, 999번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다. |
| 이 column family, 99번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다. |
| 이 column family에 대한 초당 읽기 요청 수입니다. |
| 이 column family, 50번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다. |
| 이 column family, 75번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다. |
| 이 column family, 95번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다. |
| 이 column family, 98번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다. |
| 이 column family, 999번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다. |
| 이 column family, 99번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다. |
| 이 column family에 대한 초당 쓰기 요청 수입니다. |
목록
통합은 Cassandra 구성에 정의된 구성 옵션을 캡처하고 이를 New Relic UI에 인벤토리 데이터 로 보고합니다.
시스템 메타데이터
Cassandra 통합은 서비스 및 해당 구성에 대한 다음 속성 도 수집합니다.
이름 | 설명 |
---|---|
| 카산드라 버전. |
| 이 Cassandra 노드가 속한 클러스터의 이름입니다. |
문제점 해결
jmxterm을 통한 문제 해결
JMXTerm 은 통합 패키지에 번들로 제공되는 명령줄 대화형 도구입니다.
JMXTerm용 문서는 GitHub의 nrjmx 페이지 에서 찾을 수 있습니다.
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 고유한 포크를 만들어 빌드할 수 있습니다.