ActiveMQ

Supported OS Linux Windows Mac OS

Integration version3.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을 사용할 것을 권장합니다.

설정

호스트

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

ActiveMQ 서버에 JMX Remote가 활성화되어 있는지 확인합니다.
에이전트를 설정하여 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
```
에이전트 재시작

로그 수집

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

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

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>"

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

컨테이너화된 환경

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

메트릭 수집

파라미터	값
`<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.address.bytes_per_page (gauge)	(Artemis only) Number of bytes used by each page for this address. Shown as byte
activemq.artemis.address.number_of_messages (rate)	(Artemis only) The sum of messages on queue(s), including messages in delivery. Shown as message
activemq.artemis.address.pages_count (gauge)	(Artemis only) Number of pages used by this address. Shown as page
activemq.artemis.address.routed_messages (rate)	(Artemis only) Number of messages routed to one or more bindings, as a rate. Shown as message
activemq.artemis.address.size (gauge)	(Artemis only) Number of estimated bytes being used by all the queue(s) bound to this address; used to control paging and blocking. Shown as byte
activemq.artemis.address.unrouted_messages (rate)	(Artemis only) Number of messages not routed to any bindings, as a rate. Shown as message
activemq.artemis.address_memory_usage (gauge)	(Artemis only) Memory used by all the addresses on broker for in-memory messages. Shown as byte
activemq.artemis.address_memory_usage_pct (gauge)	(Artemis only) Memory used by all the addresses on broker as a percentage of the global-max-size. Shown as percent
activemq.artemis.connection_count (gauge)	(Artemis only) Number of clients connected to this server. Shown as connection
activemq.artemis.disk_store_usage_pct (gauge)	(Artemis only) Percentage of total disk store used. Shown as percent
activemq.artemis.max_disk_usage (gauge)	(Artemis only) Maximum limit for disk use in percentage. Shown as percent
activemq.artemis.queue.consumer_count (gauge)	(Artemis only) Number of consumers consuming messages from this queue.
activemq.artemis.queue.max_consumers (gauge)	(Artemis only) Maximum number of consumers allowed on this queue at any one time.
activemq.artemis.queue.message_count (gauge)	(Artemis only) Number of messages currently in this queue (includes scheduled, paged, and in-delivery messages), as a rate. Shown as message
activemq.artemis.queue.messages_acknowledged (rate)	(Artemis only) Number of messages acknowledged from this queue since it was created, as a rate. Shown as message
activemq.artemis.queue.messages_added (rate)	(Artemis only) Number of messages added to this queue since it was created, as a rate. Shown as message
activemq.artemis.queue.messages_expired (rate)	(Artemis only) Number of messages expired from this queue since it was created, as a rate. Shown as message
activemq.artemis.queue.messages_killed (rate)	(Artemis only) Number of messages removed from this queue since it was created due to exceeding the max delivery attempts, as a rate. Shown as message
activemq.artemis.total_connection_count (rate)	(Artemis only) Number of clients which have connected to this server since it was started, as a rate. Shown as connection
activemq.artemis.total_consumer_count (rate)	(Artemis only) Number of consumers consuming messages from all the queues on this server, as a rate.
activemq.artemis.total_message_count (rate)	(Artemis only) Number of messages in all queues on the server, as a rate. Shown as connection
activemq.artemis.total_messages_acknowledged (rate)	(Artemis only) Number of messages acknowledged from all the queues on this server since it was started, as a rate. Shown as connection
activemq.artemis.total_messages_added (rate)	(Artemis only) Number of messages sent to this server since it was started, as a rate. Shown as connection
activemq.broker.memory_pct (gauge)	The percentage of memory in use. Shown as percent
activemq.broker.store_pct (gauge)	The percentage of store in use. Shown as percent
activemq.broker.temp_pct (gauge)	The percentage of temporary in use. Shown as percent
activemq.queue.avg_enqueue_time (gauge)	On average the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.consumer_count (gauge)	The number of consumers connected.
activemq.queue.dequeue_count (gauge)	The amount of messages that remained dequeued. Shown as message
activemq.queue.dispatch_count (gauge)	The amount of messages that have been dispatched. Shown as message
activemq.queue.enqueue_count (gauge)	The amount of messages that have been enqueued. Shown as message
activemq.queue.expired_count (gauge)	The amount of messages that have been expired. Shown as message
activemq.queue.in_flight_count (gauge)	The amount of messages that have been in flight. Shown as message
activemq.queue.max_enqueue_time (gauge)	The max the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.memory_pct (gauge)	The percentage of memory currently in use. Shown as percent
activemq.queue.min_enqueue_time (gauge)	The min the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.producer_count (gauge)	The number of producers connected.
activemq.queue.size (gauge)	The amount of messages that remained queued. Shown as message

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

이벤트

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

서비스 점검

activemq.can_connect
Returns CRITICAL if the Agent is unable to connect to and collect metrics from the monitored ActiveMQ instance, WARNING if no metrics are collected, and OK otherwise.
Statuses: ok, critical, warning

트러블슈팅

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

참고 자료

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

ActiveMQ XML 통합

개요

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

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

설정

설치

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

설정

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

호스트

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

url 통계 에이전트 구성 디렉터리 루트에 있는 conf.d/ 폴더에서 activemq_xml.d/conf.yaml 파일을 편집합니다. 사용할 수 있는 설정 옵션 전체를 확인하려면 activemq_xml.d/conf.yaml 샘플을 참고하세요.
참고: ActiveMQ XML 통합 설정은 커스텀 메트릭을 내보낼 가능성이 있으며, 빌링에 영향을 미칠 수도 있습니다. 이는 350 메트릭의 기본값으로 제한되어 있습니다. 메트릭이 추가로 필요한 경우 Datadog 지원 팀에 문의하세요.
에이전트를 다시 시작합니다.

로그 수집

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

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>"

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

컨테이너화된 환경

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

검증

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

수집한 데이터

메트릭

activemq.queue.consumer_count (gauge)	The number of consumers of a queue.
activemq.queue.count (gauge)	The number of queues.
activemq.queue.dequeue_count (gauge)	The total number of messages sent to a queue since the last restart. Shown as message
activemq.queue.enqueue_count (gauge)	The total number of messages removed from a queue (acknowledged by consumer) since the last restart. Shown as message
activemq.queue.size (gauge)	The size of a queue.
activemq.subscriber.count (gauge)	The number of subscribers.
activemq.subscriber.dequeue_counter (gauge)	The number of messages sent to and acknowledged by the client. Shown as message
activemq.subscriber.dispatched_counter (gauge)	The number of messages sent to the client. Shown as message
activemq.subscriber.dispatched_queue_size (gauge)	The number of messages dispatched that are awaiting acknowledgement. Shown as message
activemq.subscriber.enqueue_counter (gauge)	The number of messages that matched the subscription. Shown as message
activemq.subscriber.pending_queue_size (gauge)	The number of messages pending delivery. Shown as message
activemq.topic.consumer_count (gauge)	The number of consumers of a topic.
activemq.topic.count (gauge)	The number of topics.
activemq.topic.dequeue_count (gauge)	The total number of messages sent to a topic since the last restart. Shown as message
activemq.topic.enqueue_count (gauge)	The total number of messages removed from a topic (acknowledged by consumer) since the last restart. Shown as message
activemq.topic.size (gauge)	The size of a topic.

이벤트

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

서비스 검사

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

트러블슈팅

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

참고 자료

ActiveMQ 메트릭 및 성능 모니터링