MarkLogic

Supported OS Linux Mac OS

통합 버전6.1.1

개요

이 점검은 Datadog 에이전트로 MarkLogic을 모니터링합니다. MarkLogic 서버는 운영 및 분석 데이터를 위한 데이터 허브로 설계된 다중 모델 데이터베이스입니다.

설정

아래 지침을 따라 호스트에서 실행되는 에이전트에 대해 이 점검을 설치하고 설정하세요. 컨테이너화된 환경의 경우 이러한 지침을 적용하는 데 가이드가 필요하면 자동탐지 통합 템플릿을 참조하세요.

설치

MarkLogic 점검은 Datadog 에이전트 패키지에 포함되어 있습니다. 서버에 추가 설치가 필요하지 않습니다.

MarkLogic 준비

API 또는 관리자 인터페이스를 사용하여 최소 manage-user 역할 권한이 있는 Datadog 에이전트 사용자를 생성합니다. enable_health_service_checks 설정을 사용하려는 경우 Datadog MarkLogic 사용자에게 manage-admin 이상의 역할을 부여하세요.

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 에이전트에서 사용하는 사용자 아이디와 비밀번호로 바꿉니다. 자세한 내용은 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. 에이전트의 설정 디렉토리 루트에 있는 conf.d/ 폴더에서 marklogic.d/conf.yaml 파일을 편집하여 MarkLogic 성능 데이터 수집을 시작하세요.사용 가능한 모든 설정 옵션은 marklogic.d/conf.yaml 샘플 파일에서 확인하세요. 설정 파일의 사용자 관련 설정의 경우 생성한 Datadog 에이전트 사용자를 사용합니다.

  2. [에이전트를 재시작합니다] 9.

로그 수집

에이전트 버전 > 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. [에이전트를 재시작합니다] 9.

검증

에이전트의 상태 하위 명령을 실행하고 점검 섹션에서 marklogic를 찾습니다.

수집한 데이터

메트릭

이벤트

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

서비스 점검

트러블슈팅

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

PREVIEWING: may/embedded-workflows