ActiveMQ

Supported OS Linux Windows Mac OS

통합 버전3.1.0

개요

ActiveMQ 점검으로 브로커와 큐, 프로듀서, 컨슈머 등을 위해 메트릭을 수집합니다.

참고: 본 점검은 ActiveMQ Artemis(향후 ActiveMQ 버전 6) 또한 지원하며, activemq.artemis 네임스페이스에서 메트릭을 보고합니다. 본 통합이 제공하는 메트릭 목록을 확인하려면 metadata.csv를 참조하세요.

참고: ActiveMQ 5.8.0 이전 버전을 실행 중이라면 에이전트 5.10.x 릴리스 샘플 파일을 참조하세요.

설정

설치

에이전트의 ActiveMQ 점검은 Datadog 에이전트 패키지에 포함되어 있으므로 ActiveMQ 노드에 추가로 설치할 필요가 없습니다.

본 점검 기능으로 JMXFetch를 활용하여 JMX에서 메트릭 을 수집합니다. 에이전트에서 JMXFetch를 실행하려면 각 노드에 JVM이 필요합니다. Datadog은 오라클 제공 JVM을 사용할 것을 권장합니다.

설정

    호스트

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

    1. ActiveMQ 서버에 JMX Remote가 활성화되어 있는지 확인합니다.

    2. 에이전트를 설정하여 ActiveMQ에 연결합니다. Agent 설정 디렉터리 루트의 conf.d/ 폴더에서 activemq.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 설정 옵션을 확인하려면 sample mysql.d/conf.yaml을 참조합니다. 기본 수집 메트릭 목록을 보려면 metrics.yaml 파일을 확인하세요.

      init_config:
  is_jmx: true
  collect_default_metrics: true

instances:
  - host: localhost
    port: 1616
    user: username
    password: password
    name: activemq_instance

    3. 에이전트 재시작

    로그 수집

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

    1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml 파일에서 로그 수집을 사용하도록 설정합니다.

      logs_enabled: true

    2. ActiveMQ 로그 수집을 시작하려면 다음 설정 블록을 activemq.d/conf.yaml 파일에 추가합니다.

      logs:
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
    source: activemq
    service: "<SERVICE_NAME>"
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
    source: activemq
    service: "<SERVICE_NAME>"

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

    컨테이너화된 환경

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

    메트릭 수집
    파라미터값
    <INTEGRATION_NAME>activemq
    <INIT_CONFIG>"is_jmx": true
    <INSTANCE_CONFIG>{"host": "%%host%%","port":"1099"}
    로그 수집

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

    Datadog 에이전트에서 로그 수집은 기본값으로 비활성화되어 있습니다. 이를 활성화하려면 쿠버네티스(Kubernetes) 로그 수집을 참조하세요.

    파라미터값
    <LOG_CONFIG>{"source": "activemq", "service": "<YOUR_APP_NAME>"}

    검증

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

    수집한 데이터

    메트릭

    ActiveMQ Artemis flavor와 연관된 메트릭 이름에는 artemis 이 들어가고, 그 외에는 모두 ActiveMQ “클래식"으로 보고됩니다.

    이벤트

    ActiveMQ 점검에는 이벤트가 포함되지 않습니다.

    서비스 점검

    트러블슈팅

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

    참고 자료

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

    ActiveMQ XML 통합

    개요

    ActiveMQ XML에서 다음 목적으로 메트릭을 실시간으로 가져옵니다:

    • ActiveMQ XML 상태 시각화 및 모니터링.
    • ActiveMQ XML 장애 및 이벤트에 대한 알림 수신.

    설정

    설치

    ActiveMQ XML 점검은 Datadog 에이전트 패키지에 포함되어 있으므로 서버에 설치할 필요가 없습니다.

    설정

    호스트에서 실행되는 에이전트의 경우 하단의 지침에 따라 점검을 설정합니다. 컨테이너화된 환경이라면 컨테이너화 섹션을 참조하세요.

    호스트

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

    1. url 통계 에이전트 구성 디렉터리 루트에 있는 conf.d/ 폴더에서 activemq_xml.d/conf.yaml 파일을 편집합니다. 사용할 수 있는 설정 옵션 전체를 확인하려면 activemq_xml.d/conf.yaml 샘플을 참고하세요.

      참고: ActiveMQ XML 통합 설정은 커스텀 메트릭을 내보낼 가능성이 있으며, 빌링에 영향을 미칠 수도 있습니다. 이는 350 메트릭의 기본값으로 제한되어 있습니다. 메트릭이 추가로 필요한 경우 Datadog 지원 팀에 문의하세요.

    2. 에이전트를 다시 시작합니다.

    로그 수집

    1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml 파일에서 로그 수집을 사용하도록 설정합니다.

      logs_enabled: true

    2. ActiveMQ 로그 수집을 시작하려면 다음 설정 블록을 activemq_xml.d/conf.yaml 또는 activemq.d/conf.yaml 파일에 추가합니다.

      logs:
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
    source: activemq
    service: "<SERVICE_NAME>"
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
    source: activemq
    service: "<SERVICE_NAME>"

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

    컨테이너화된 환경

    컨테이너화된 환경이라면 JMX 자동탐지 지침을 참조하세요.

    검증

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

    수집한 데이터

    메트릭

    이벤트

    ActiveMQ XML 점검에는 이벤트가 포함되지 않습니다.

    서비스 검사

    ActiveMQ XML 점검에는 서비스 점검이 포함되지 않습니다.

    트러블슈팅

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

    참고 자료

    PREVIEWING: may/embedded-workflows