개요

이 점검은 Datadog Agent를 통해 MarkLogic을 모니터링합니다. MarkLogic Server는 운영 및 분석 데이터의 데이터 허브 역할을 하도록 설계된 멀티 모델 데이터베이스입니다.

설정

아래 지침을 따라 호스트에서 실행 중인 Agent에 이 점검을 설치하고 구성하세요. 컨테이너 환경에서 구성하려면 Autodiscovery 통합 템플릿을 참고하세요.

설치

MarkLogic 점검은 Datadog Agent 패키지에 포함되어 있어 서버에 추가로 설치할 필요가 없습니다.

MarkLogic 준비

API 또는 Admin 인터페이스를 사용하여 Datadog Agent용 사용자를 생성하고 최소한 manage-user 역할 권한을 부여하세요. enable_health_service_checks 구성을 사용하려면 Datadog MarkLogic 사용자에게 최소한 [manage-admin(https://docs.marklogic.com/guide/admin/pre_def_roles#id_28243) 역할을 부여하세요.

API

1. 이 요청을 다음 특정 값으로 수정하여 Datadog 사용자를 생성합니다.

   curl -X POST --anyauth --user <ADMIN_USER>:<ADMIN_PASSWORD> -i -H "Content-Type: application/json" -d '{"user-name": "<USER>", "password": "<PASSWORD>", "roles": {"role": "manage-user"}}' http://<HOSTNAME>:8002/manage/v2/users
   

   올바른 <ADMIN_USER> 및 <ADMIN_PASSWORD>를 사용하고, <USER> 및 <PASSWORD>를 Datadog Agent가 사용하는 사용자 이름과 비밀번호로 바꿉니다. 자세한 내용은 MarkLogic 도움말 POST /manage/v2/users를 참고하세요.

2. 다음과 같이 충분한 권한이 있는 사용자를 생성했는지 확인합니다.

   curl -X GET --anyauth --user <USER>:<PASSWORD> -i http://<HOSTNAME>:8002/manage/v2
   

관리자 인터페이스

1. 관리자 계정으로 QConsole에 로그인합니다. 기본적으로 QConsole은 http://<HOSTNAME>:8000/qconsole에서 사용할 수 있습니다.

2. 데이터베이스로 Security, 쿼리 유형으로 XQuery을 선택합니다.

3. 쿼리를 실행하여 <USER> 및 <PASSWORD>을 Datadog 에이전트에서 사용하는 항목으로 변경합니다.

   xquery version "1.0-ml";
   import module namespace sec="http://marklogic.com/xdmp/security" at 
       "/MarkLogic/security.xqy";
   
   sec:create-user(
       "<USER>",
       "Datadog Agent user",
       "<PASSWORD>",
       "manage-user",
       (xdmp:permission("security", "read")),
       ("http://marklogic.com/dev_modules"))
   

   자세한 내용은 MarkLogic 도움말 sec:create-user을 참고하세요.

4. 충분한 권한이 있는 사용자를 생성했는지 확인하려면 <USER> 및 <PASSWORD>을 사용하여 http://<HOSTNAME>:8002(기본 포트)에서 인증합니다.

설정

호스트

1. MarkLogic 성능 데이터 수집을 시작하려면 Agent 구성 디렉터리의 루트에 있는 conf.d/ 폴더의marklogic.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 구성 옵션은 [샘플 marklogic.d/conf.yaml 파일]https://github.com/DataDog/integrations-core/blob/master/marklogic/datadog_checks/marklogic/data/conf.yaml.example)을 참고하세요. 구성 파일의 사용자 관련 설정에는 생성한 Datadog Agent 사용자를 사용하세요.

2. Agent를 다시 시작합니다.

로그 수집

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

1. Datadog 에이전트에서는 로그 수집이 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화해야 합니다.

   logs_enabled: true
   

2. marklogic.d/conf.yaml 파일에 이 설정 블록을 추가하여 MarkLogic 로그 수집을 시작하세요.

     logs:
       - type: file
         path: /var/opt/MarkLogic/Logs/ErrorLog.txt
         source: marklogic
       - type: file
         path: /var/opt/MarkLogic/Logs/80002_AccessLog.txt
         source: marklogic
   

   path 값을 변경하고 환경에 맞게 구성합니다. 사용 가능한 모든 구성 옵션은 샘플 marklogic.d/conf.yaml 파일을 참고하세요.

3. Agent를 다시 시작합니다.

검증

Agent 상태 하위 명령을 실행하고 Checks 섹션에서 marklogic을 찾습니다.

수집한 데이터

Metrics

이벤트

MarkLogic은 이벤트를 포함하지 않습니다.

서비스 점검

marklogic.can_connect

Agent가 쿼리 엔드포인트에 연결할 수 없는 경우 CRITICAL을 반환하고, 그렇지 않으면 OK를 반환합니다.

상태: ok, critical, unknown

marklogic.database.health

데이터베이스 상태가 critical이면, CRITICAL을, maintenance, offline, at-risk이면, WARNING을, 그렇지 않으면 OK를 반환합니다.

상태: ok, warning, critical, unknown

marklogic.forest.health

포레스트 상태가 critical이면 CRITICAL을, maintenance, offline, at-risk 상태이면 WARNING을, 그렇지 않으면 OK를 반환합니다.

상태: ok, warning, critical, unknown

트러블슈팅

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