카산드라 모니터링 통합

Cassandra 통합은 성능 메트릭 및 인벤토리 데이터 를 Cassandra 데이터베이스에서 New Relic 플랫폼으로 보냅니다. Cassandra 지표 데이터의 사전 구축된 대시보드를 보고, 경고 정책을 생성하고, 사용자 지정 쿼리 및 차트를 생성할 수 있습니다.

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

호환성 및 요구 사항

우리의 통합은 Apache Cassandra 버전 3.x 이상과 호환됩니다.

통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.

자바 런타임 환경 7 이상.
Cassandra가 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않으면 Cassandra를 실행하는 Linux 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:
- Kubernetes에서 실행 중인 경우 다음 요구 사항 을 참조하십시오.
- ECS에서 실행하는 경우 다음 요구 사항 을 참조하십시오.

빠른 시작: 설치 안내 사용

Cassandra 데이터베이스를 신속하게 계측하고 설치 안내를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 맞춤형 CLI 명령을 생성합니다.

시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.

안내 설치

EU 가이드 설치

가이드 설치는 인프라 에이전트를 사용하여 Cassandra 통합을 설정합니다. 뿐만 아니라 사용자 환경에서 실행 중인 다른 애플리케이션 및 로그 소스를 검색한 다음 계측해야 하는 것을 추천합니다.

안내 설치는 대부분의 설정에서 작동합니다. 그러나 귀하의 요구 사항에 적합하지 않은 경우 아래에서 다른 방법을 찾아 Cassandra 데이터베이스 모니터링을 시작할 수 있습니다.

설치 및 활성화

Cassandra 통합을 설치하려면 환경에 대한 지침을 따르세요.

추가 참고 사항:

고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.

' '

Linux에 Cassandra 통합을 설치하려면:

파일 이름 nri-cassandra 을(를) 사용하여 통합 설치 지침을 따르십시오.
디렉터리를 integration 폴더로 변경합니다.
```
cd /etc/newrelic-infra/integrations.d
```

샘플 구성 파일을 복사합니다.

sudo cp cassandra-config.yml.sample cassandra-config.yml

구성 설정 에 설명된 대로 cassandra-config.yml 파일을 편집합니다.
인프라 에이전트를 다시 시작 하십시오.
자동 Cassandra 오류 로그 구문 분석 및 전달을 활성화하려면 cassandra-log.yml.example 파일을 cassandra-log.yml 에 복사(또는 이름 변경)하세요.에이전트를 다시 시작할 필요가 없습니다.
예시:
```
sudo cp /etc/newrelic-infra/logging.d/casssandra-log.yml.example /etc/newrelic-infra/logging.d/cassandra-log.yml
```

구성

통합 구성

설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.

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/카산드라/ 카산드라.yaml	나
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 신뢰 저장소의 비밀번호입니다.	해당 없음	중
원격 모니터링	다중 테넌시 모니터링을 활성화합니다.	잘못된	미
측정항목	측정항목 전용 수집을 활성화하려면 `true` 으로 설정합니다.	잘못된
목록	인벤토리 전용 컬렉션을 활성화하려면 `true` 으로 설정합니다.	잘못된

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

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

라벨/맞춤 속성

레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키/값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 샘플 구성 파일에는 레이블의 예가 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.

labels:
   env: production
   role: load_balancer

구성 예

다음은 localhost에서 메트릭 및 인벤토리를 수집하는 데 사용되는 기본 구성입니다.

integrations:
  - name: nri-cassandra
    env:
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      CONFIG_PATH: /etc/cassandra/cassandra.yml
    interval: 30s
    labels:
      environment: production
    inventory_source: config/cassandra

이 구성은 30초마다 메트릭을 수집하고 60초마다 인벤토리를 수집합니다.

integrations:
  - name: nri-cassandra
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      REMOTE_MONITORING: true
    interval: 30s
    labels:
      environment: production

  - name: nri-cassandra
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      CONFIG_PATH: /etc/cassandra/cassandra.yml
    interval: 60s
    labels:
      environment: production
    inventory_source: config/cassandra

이 구성에서는 환경 변수 CASSANDRA_HOST 를 사용하여 통합의 HOSTNAME 설정을 채웁니다.

integrations:
  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: {{CASSANDRA_HOST}}
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성에서는 동일한 통합에서 여러 Cassandra 서버를 모니터링하고 있습니다. 첫 번째 인스턴스( HOSTNAME: 1st_cassandra_host )의 경우 측정항목과 인벤토리를 수집하는 반면 두 번째 인스턴스( HOSTNAME: 2nd_cassandra_host )의 경우 측정항목만 수집합니다.

integrations:
  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: 1st_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 30s
    labels:
      env: production
      role: load_balancer
  - name: nri-cassandra
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/cassandra

  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: 2nd_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 30s
    labels:
      env: production
      role: load_balancer

데이터 찾기 및 사용

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

Cassandra 데이터는 CassandraSample 및 CassandraColumnFamilySample 이벤트 유형 에 연결됩니다. 문제 해결을 위해 또는 차트 및 대시보드를 생성하기 위해 이 데이터를 쿼리 할 수 있습니다.

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

측정항목 데이터

Cassandra 통합은 다음 메트릭을 수집합니다.

노드 측정항목

Cassandra 노드 측정항목은 CassandraSample 이벤트 유형 에 연결됩니다. Cassandra 통합은 다음 노드 메트릭을 수집합니다.

이름	설명
`db.allMemtablesOffHeapSizeBytes`	힙에 있는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 양입니다.
`db.allMemtablesOnHeapSizeBytes`	오프 힙에 있는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 양입니다.
`db.commitLogCompletedTasksPerSecond`	초당 작성된 커밋 로그 메시지 수입니다.
`db.commitLogPendindTasks`	작성되었지만 아직 fsync되지 않은 커밋 로그 메시지 수입니다.
`db.commitLogTotalSizeBytes`	모든 커밋 로그 세그먼트에서 사용하는 현재 크기(바이트)입니다.
`db.droppedRequestTypeMessagesPerSecond`	이 유형의 요청에 대해 초당 삭제된 메시지입니다. `RequestType` 은 BatchRemove, BatchStore, CounterMutation, Hint, Mutation, PagedRange, RangeSlice, Read, ReadRepair, RequestResponse 또는 Trace 중 하나일 수 있습니다.
`db.keyCacheCapacityBytes`	키 캐시 용량(바이트)입니다.
`db.keyCacheHitRate`	1분 키 캐시 적중률입니다.
`db.keyCacheHitsPerSecond`	초당 키 캐시 적중 횟수입니다.
`db.keyCacheRequestsPerSecond`	초당 키 캐시에 대한 요청 수입니다.
`db.keyCacheSizeBytes`	점유된 캐시의 크기(바이트)입니다.
`db.liveSSTableCount`	이 열 패밀리에 대한 디스크의 SSTable 수입니다.
`db.loadBytes`	이 노드가 관리하는 온디스크 데이터 크기의 크기(바이트)입니다.
`db.rowCacheCapacityBytes`	행 캐시 용량(바이트)입니다.
`db.rowCacheHitRate`	1분 행 캐시 적중률입니다.
`db.rowCacheHitsPerSecond`	초당 행 캐시 적중 수입니다.
`db.rowCacheRequestsPerSecond`	초당 행 캐시에 대한 요청 수입니다.
`db.rowCacheSizeBytes`	점유된 행 캐시의 총 크기(바이트)입니다.
`db.threadpool.poolActiveTasks`	이 풀에서 활발하게 작업 중인 작업 수입니다. `pool` 은 다음 중 하나일 수 있습니다. 내부AntiEntropyStage 내부 캐시 정리 실행기 내부 압축 실행기 내부가십스테이지 internalHintsDispatcher 내부내부응답단계 내부MemtableFlushWriter 내부MemtablePostFlush 내부MemtableReclaimMemory 내부 마이그레이션 단계 내부 기타 단계 내부 보류 범위 계산기 내부샘플러 내부SecondaryIndex관리 내부 유효성 검사 실행기 요청 카운터 돌연변이 단계 요청 돌연변이 단계 요청읽기수리단계 요청 읽기 단계 요청요청응답 requestViewMutation단계
`db.threadpool.pool.PendingTasks`	이 풀에서 활발하게 작업 중인 작업 수입니다. `pool` 은 `db.threadpool.poolActiveTasks` 의 설명에 제공된 목록의 항목일 수 있습니다.
`db.totalHintsInProgress`	현재 전송을 시도하는 힌트의 수입니다.
`db.totalHintsPerSecond`	이 노드에 기록된 초당 힌트 메시지 수입니다. 힌트당 힌트될 각 호스트에 대해 하나의 항목을 포함합니다.
`query.CASReadRequestsPerSecond`	초당 요청의 트랜잭션 읽기 대기 시간입니다.
`query.CASWriteRequestsPerSecond`	초당 요청의 트랜잭션 쓰기 대기 시간입니다.
`query.rangeSliceRequestsPerSecond`	초당 범위 슬라이스 요청 수입니다.
`query.rangeSliceTimeoutsPerSecond`	토큰 범위 읽기 요청을 처리할 때 발생한 초당 시간 초과 횟수입니다.
`query.rangeSliceUnavailablesPerSecond`	토큰 범위 읽기 요청을 처리할 때 발생한 초당 사용할 수 없는 예외 수입니다.
`query.readLatency50thPercentileMilliseconds`	읽기 지연 시간(밀리초), 50번째 백분위수.
`query.readLatency75thPercentileMilliseconds`	읽기 지연 시간(밀리초), 75번째 백분위수.
`query.readLatency95thPercentileMilliseconds`	읽기 지연 시간(밀리초), 95번째 백분위수.
`query.readLatency98thPercentileMilliseconds`	읽기 지연 시간(밀리초), 98번째 백분위수.
`query.readLatency999thPercentileMilliseconds`	읽기 지연 시간(밀리초), 999번째 백분위수.
`query.readLatency99thPercentileMilliseconds`	읽기 지연 시간(밀리초), 99번째 백분위수.
`query.readRequestsPerSecond`	초당 읽기 요청 수입니다.
`query.readTimeoutsPerSecond`	표준 읽기 요청을 처리할 때 발생한 초당 시간 초과 횟수입니다.
`query.readUnavailablesPerSecond`	표준 읽기 요청을 처리할 때 발생한 초당 사용할 수 없는 예외 수입니다.
`query.viewWriteRequestsPerSecond`	초당 보기 쓰기 요청 수입니다.
`query.writeLatency50thPercentileMilliseconds`	쓰기 지연 시간(밀리초), 50번째 백분위수.
`query.writeLatency75thPercentileMilliseconds`	쓰기 지연 시간(밀리초), 75번째 백분위수.
`query.writeLatency95thPercentileMilliseconds`	쓰기 지연 시간(밀리초), 95번째 백분위수.
`query.writeLatency98thPercentileMilliseconds`	쓰기 지연 시간(밀리초), 98번째 백분위수.
`query.writeLatency999thPercentileMilliseconds`	쓰기 지연 시간(밀리초), 999번째 백분위수.
`query.writeLatency99thPercentileMilliseconds`	쓰기 지연 시간(밀리초), 99번째 백분위수.
`query.writeRequestsPerSecond`	초당 쓰기 요청 수입니다.
`query.writeTimeoutsPerSecond`	일반 쓰기 요청을 처리할 때 발생한 초당 시간 초과 횟수입니다.
`query.writeUnavailablesPerSecond`	일반 쓰기 요청을 처리할 때 발생한 초당 사용할 수 없는 예외 수입니다.

Cassandra 컬럼 패밀리 메트릭 및 메타데이터

Cassandra 통합은 열 패밀리 메트릭을 검색합니다. Cassandra column family 데이터 는 CassandraColumnFamilySample 이벤트 유형에 연결됩니다. 시스템 키스페이스( system , system_auth , system_distributed , system_schema , system_traces 및 OpsCenter )를 건너뜁니다. 성능 영향을 제한하기 위해 통합은 최대 20개의 열 패밀리에 대한 메트릭만 캡처합니다.

다음 메타데이터는 샘플 메트릭과 연결된 키스페이스 및 열 패밀리를 나타냅니다.

이름	설명
`db.columnFamily`	이 메트릭이 참조하는 Cassandra 열 패밀리입니다.
`db.keyspace`	이 열 패밀리를 포함하는 Cassandra 키스페이스입니다.
`db.keyspaceAndColumnFamily`	다음 형식의 단일 메타데이터 속성에 있는 키스페이스 및 열 패밀리: `keyspace` . `columnFamily` .

아래 메트릭 목록은 위의 메타데이터에 지정된 특정 키스페이스 및 열 패밀리를 참조합니다.

이름	설명
`db.allMemtablesOffHeapSizeBytes`	오프 힙에 있는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 수입니다.
`db.allMemtablesOnHeapSizeBytes`	힙에 상주하는 memtables(2i 및 보류 중인 플러시 memtables 포함)에 저장된 총 바이트 수입니다.
`db.liveDiskSpaceUsedBytes`	이 열 패밀리에 속하는 SSTable에서 사용하는 디스크 공간(바이트)입니다.
`db.liveSSTableCount`	이 열 패밀리에 대한 디스크의 SSTable 수입니다.
`db.pendingCompactions`	이 열 패밀리에 대해 보류 중인 압축 수의 추정치입니다.
`db.SSTablesPerRead50thPercentileMilliseconds`	읽기당 액세스한 안정적인 데이터 파일 수, 50번째 백분위수.
`db.SSTablesPerRead75thPercentileMilliseconds`	읽기당 액세스한 안정적인 데이터 파일 수, 75번째 백분위수.
`db.SSTablesPerRead95thPercentileMilliseconds`	읽기당 액세스한 안정적인 데이터 파일 수, 95번째 백분위수.
`db.SSTablesPerRead98thPercentileMilliseconds`	읽기당 액세스한 안정적인 데이터 파일 수, 98번째 백분위수.
`db.SSTablesPerRead999thPercentileMilliseconds`	읽기당 액세스한 안정적인 데이터 파일 수, 999번째 백분위수.
`db.SSTablesPerRead99thPercentileMilliseconds`	읽기당 액세스한 안정적인 데이터 파일 수, 99번째 백분위수.
`query.readLatency50thPercentileMilliseconds`	이 column family, 50번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다.
`query.readLatency75thPercentileMilliseconds`	이 column family, 75번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다.
`query.readLatency95thPercentileMilliseconds`	이 column family, 95번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다.
`query.readLatency98thPercentileMilliseconds`	이 column family, 98번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다.
`query.readLatency999thPercentileMilliseconds`	이 column family, 999번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다.
`query.readLatency99thPercentileMilliseconds`	이 column family, 99번째 백분위수에 대한 로컬 읽기 지연 시간(밀리초)입니다.
`query.readRequestsPerSecond`	이 column family에 대한 초당 읽기 요청 수입니다.
`query.writeLatency50thPercentileMilliseconds`	이 column family, 50번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다.
`query.writeLatency75thPercentileMilliseconds`	이 column family, 75번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다.
`query.writeLatency95thPercentileMilliseconds`	이 column family, 95번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다.
`query.writeLatency98thPercentileMilliseconds`	이 column family, 98번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다.
`query.writeLatency999thPercentileMilliseconds`	이 column family, 999번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다.
`query.writeLatency99thPercentileMilliseconds`	이 column family, 99번째 백분위수에 대한 로컬 쓰기 지연 시간(밀리초)입니다.
`query.writeRequestsPerSecond`	이 column family에 대한 초당 쓰기 요청 수입니다.

통합은 Cassandra 구성에 정의된 구성 옵션을 캡처하고 이를 New Relic UI에 인벤토리 데이터 로 보고합니다.

시스템 메타데이터

Cassandra 통합은 서비스 및 해당 구성에 대한 다음 속성 도 수집합니다.

이름	설명
`software.version`	카산드라 버전.
`cluster.name`	이 Cassandra 노드가 속한 클러스터의 이름입니다.

문제점 해결

jmxterm을 통한 문제 해결

JMXTerm 은 통합 패키지에 번들로 제공되는 명령줄 대화형 도구입니다.

JMXTerm용 문서는 GitHub의 nrjmx 페이지 에서 찾을 수 있습니다.

소스 코드 확인

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

사용자의 편의를 위해 제공되는 기계 번역입니다.