CockroachDB

Supported OS Linux Windows Mac OS

통합 버전3.3.0

개요

CockroachDB는 CockroachDB 클러스터의 전반적인 서비스 상태 및 성능 모니터링을 점검합니다.

설정

설치

CockroachDB 점검은 Datadog 에이전트 패키지에 포함되어 있기 때문에 서버에 추가로 설치할 필요가 없습니다.

버전 1.9.0부터 본 개방형 메트릭 기반 통합에는 최신 모드( openmetrics_endpoint가 대상 엔드포인트를 가리키도록 설정하여 활성화됨)와 레거시 모드(prometheus_url를 대신 설정하여 활성화됨)가 존재합니다. 최신 기능을 모두 사용하려면 Datadog은 최신 모드를 활성화할 것을 권장합니다. 최신 모드를 사용하려면 파이썬(Python) 3이 필요합니다. 자세한 내용을 확인하려면 개방형 메트릭 기반 통합의 최신 및 레거시 버전 관리를 참조하세요.

호스트에서 파이썬(Python) 3을 사용할 수 없거나 레거시 모드를 사용하려면 다음 설정을 참조하세요.

설정

호스트

호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면:

메트릭 수집
  1. Agent의 설정 디렉터리 루트에서 conf.d/ 폴더에 있는 cockroachdb.d/conf.yaml 파일을 편집하여 CockroachDB 성능 데이터 수집을 시작하세요. 멀티 노드 클러스터의 경우 각 노드당 따로 독립 점검 인스턴트를 설정해야 합니다. 사용 가능한 모든 설정 옵션은 cockroachdb.d/conf.yaml 샘플을 참조하세요.

    init_config:
    
    instances:
        ## @param openmetrics_endpoint - string - required
        ## The URL exposing metrics in the OpenMetrics format.
        #
      - openmetrics_endpoint: http://localhost:8080/_status/vars
    
  2. 에이전트를 재시작합니다.

로그 수집

에이전트 버전 6.0 이상에서 사용 가능

  1. 로그 수집은 기본적으로 Datadog 에이전트에서 비활성화되어 있습니다. datadog.yaml에서 활성화하세요.

    logs_enabled: true
    
  2. 이 설정 블록을 cockroachdb.d/conf.yaml 파일에 추가하여 CockroachDB 로그 수집을 시작합니다.

    logs:
     - type: file
       path: /var/lib/cockroach/logs/cockroach.log
       source: cockroachdb
       service: cockroachdb
       log_processing_rules:
       - type: multi_line
         name: new_log_start_with_status_and_date
         pattern: [A-Z]\d{6}\s\d+\:\d+\:\d+\.\d+
    

    path, service 파라미터 값을 변경하고 환경에 맞게 설정합니다. 사용 가능한 모든 설정 옵션은 cockroachdb.d/conf.yaml 샘플을 참조하세요.

  3. 에이전트를 재시작합니다.

컨테이너화된 환경

컨테이너화된 환경의 경우 자동탐지 통합 템플릿에 다음 파라미터를 적용하는 방법이 안내되어 있습니다.

파라미터
<INTEGRATION_NAME>cockroachdb
<INIT_CONFIG>비워두거나 {}
<INSTANCE_CONFIG>{"openmetrics_endpoint":"http://%%host%%:8080/_status/vars"}
로그 수집

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 도커(Docker) 로그 수집을 참조하세요.

그런 다음 도커(Docker) 레이블로 로그 통합을 설정하세요.

LABEL "com.datadoghq.ad.logs"='[{"source": "cockroachdb", "service": "<SERVICE_NAME>"}]'

검증

에이전트 status 상태 하위 명령을 실행하고 점검 섹션에서 cockroachdb를 찾으세요.

수집한 데이터

메트릭

서비스 점검

CockroachDB 점검은 서비스 점검을 포함하지 않습니다.

이벤트

CockroachDB 점검은 이벤트를 포함하지 않습니다.

트러블슈팅

도움이 필요하신가요? Datadog 지원 팀에 문의하세요.

참고 자료

기타 유용한 문서, 링크 및 기사:

PREVIEWING: may/embedded-workflows