이 참조는 OpenTelemetry를 통해 수집된 IBM MQ 메트릭 및 속성을 다룹니다: mq-metric-samples 익스포터가 게시하고 수집기가 뉴렐릭으로 전달하는 메트릭입니다. 이는 Linux 호스트 및 Kubernetes 배포 모두에 적용되며, 메트릭 형태는 동일합니다.
메트릭 수집
모든 메트릭은 익스포터가 내보내는 원시 Prometheus 형태를 유지합니다: 밑줄 이름 (ibmmq_*)과 원시 qmgr, queue 및 channel 레이블, 그리고 수집기가 첨부하는 target.name ID 속성 및 선택적 cluster.name 태그. 뉴렐릭의 IBM MQ 엔티티 합성은 이 형태에 의존하므로, 수집기는 이름과 레이블을 변경하지 않고 전달합니다.
중요
각 큐 관리자에서 MQI 통계를 활성화하지 않으면 처리량 및 타이밍 메트릭이 비어 있게 됩니다. 큐 관리자 상태, 큐 깊이 및 채널 상태는 기본적으로 보고되지만, MQI 활동 메트릭(큐 처리량 및 큐 관리자 MQI 활동 테이블 ― ibmmq_queue_mqput_count, ibmmq_queue_average_queue_time_seconds 등)은 통계 수집이 켜져 있어야 하며, 이는 기본적으로 꺼져 있습니다. MQSC를 사용하여 큐 관리자당 한 번씩 활성화합니다 ― 예를 들어 ALTER QMGR STATMQI(ON) STATQ(ON), 그런 다음 큐별 통계를 원하는 큐에 대해 ALTER QLOCAL(...) STATQ(ON) 을(를) 활성화합니다(또는 큐 관리자 STATQ 기본값에 의존). 이것이 없으면 익스포터는 정상이고 엔티티가 나타나지만 해당 패널은 비어 있게 렌더링됩니다. 각 메트릭이 의존하는 정확한 통계는 mq-metric-samples 문서 를 참조하십시오.
팁
상태 메트릭은 1/0 이(가) 아닌 숫자 enum 값을 보고합니다 ― 알림을 설정하기 전에 아래의 상태 코드 참조 를 확인하세요. 카운터는 수집기에서 델타 시간성으로 변환되므로, 차트를 작성할 때 latest() 대신 기간에 걸쳐 sum() / rate() 을(를) 사용하세요.
아래 표는 OpenTelemetry 메트릭을 영역별로 그룹화합니다. 계정에서 실제로 보고되는 모든 메트릭을 나열하려면 다음을 실행하세요:
FROM Metric SELECT uniques(metricName,2000)WHERE metricName LIKE'ibmmq_%' SINCE 1day ago
메트릭
미터법
설명
ibmmq_qmgr_status
큐 관리자 실행 상태(2 =running).
ibmmq_qmgr_command_server_status
명령 서버 실행 상태(2 =실행 중).
ibmmq_qmgr_channel_initiator_status
채널 이니시에이터(MQ 채널을 시작하고 관리하는 큐 관리자 프로세스) 실행 상태(2 =실행 중).
ibmmq_qmgr_connection_count
큐 관리자의 현재 연결 수.
ibmmq_qmgr_uptime
초 단위의 큐 관리자 업타임입니다.
ibmmq_qmgr_active_listeners
활성 수신기 수입니다.
ibmmq_qmgr_active_services
활성화된 서비스의 수입니다.
ibmmq_qmgr_concurrent_connections_high_water_mark
최대 동시 연결 수.
미터법
설명
ibmmq_qmgr_cpu_load_one_minute_average_percentage
큐 관리자의 1분 CPU 로드 평균입니다(또한 _five_ 및 _fifteen_minute_).
IBM MQ 상태 메트릭은 1/0 이(가) 아닌 숫자 열거형 값을 보고하며 ― 정상("실행 중") 값은 메트릭에 따라 다릅니다(큐 관리자 수준 상태의 경우 2, 채널 상태의 경우 3). 실행 중인 값과 같지 않음 에 대한 공지(예: ibmmq_qmgr_status != 2):
미터법
정상 값
의미
ibmmq_qmgr_status
2
대기열 관리자가 실행 중입니다
ibmmq_qmgr_command_server_status
2
명령 서버가 실행 중입니다
ibmmq_qmgr_channel_initiator_status
2
채널 시작기가 실행 중입니다
ibmmq_channel_status
3
채널이 실행 중입니다
다른 값(또는 누락된 데이터 포인트)은 구성 요소가 실행 상태가 아님을 의미합니다.
리소스 속성
수집기는 모든 IBM MQ 메트릭에 ID 및 컨텍스트 속성을 추가합니다. 일부는 모든 배포에 공통적으로 적용되며, 다른 일부는 수집기가 Linux 호스트에서 실행되는지 아니면 Kubernetes에서 실행되는지에 따라 다릅니다.
기인하다
설명
예시
target.name
안정적인 ID 속성 ― 모든 IBM MQ 엔티티 GUID의 첫 번째 세그먼트입니다. targetName 스크랩 레이블로 주입된 다음 수집기에서 target.name (으)로 이름이 변경됩니다.
prod-mq-01, prod-mq-cluster
qmgr
큐 관리자 이름(원시 익스포터 레이블, 엔티티 합성이 이를 키로 사용함).
QM1
queue
큐 이름(큐 범위 메트릭).
APP.ORDERS.IN
channel
채널 이름(채널 범위 메트릭의 경우).
APP.SVRCONN
cluster.name
동일한 MQ 클러스터 내 큐 관리자를 위한 선택적 그룹화 태그입니다. 엔티티 GUID의 일부가 아니며, 설정하지 않은 상태로 두거나 나중에 변경해도 안전합니다.
prod-mq
instrumentation.provider
이 통합의 경우 항상 opentelemetry 이며, OpenTelemetry 경로로 쿼리 범위를 지정하는 데 사용합니다.
opentelemetry
기인하다
설명
예시
host.id
수집기를 실행하는 호스트의 식별자이며, resourcedetection 프로세서(system / ec2 탐지기)에서 가져옵니다. 큐 관리자를 기본 호스트 엔티티에 연결합니다.
i-1234567890abcdef0
기인하다
설명
예시
k8s_namespace
수집기의 레이블 재지정 규칙에 의해 스탬프 처리된 검색된 익스포터 파드의 네임스페이스입니다.
ibmmq
k8s_pod
검색된 익스포터 파드의 이름입니다.
qm1-0
host.id
resourcedetection에서 파드를 실행하는 노드의 식별자입니다.
ip-10-0-1-23
컬렉션 상세 정보
수집 빈도
기본 간격: 60초(수집기의 scrape_interval). mq-metric-samples 익스포터 자체의 pollInterval보다 크거나 같아야 합니다.
구성 가능: IBMMQ_SCRAPE_INTERVAL (Linux) 또는 Helm values.yaml (Kubernetes)에서 scrape_interval 을(를) 조정합니다.
데이터 소스
모든 메트릭은 PCF를 통해 각 큐 관리자를 폴링하고 HTTP /metrics 엔드포인트에서 Prometheus 메트릭으로 통계를 다시 게시하는 mq-metric-samples 익스포터에서 시작됩니다. 수집기의 prometheus 수신기가 해당 엔드포인트를 스크랩합니다.
측정항목 유형
게이지 — ibmmq_qmgr_status, ibmmq_queue_depth 및 ibmmq_channel_status와 같은 특정 시점의 값입니다. latest()이(가) 포함된 차트입니다.
카운터 ― ibmmq_queue_mqput_count 등과 같은 누적 합계입니다. 수집기의 cumulativetodelta 프로세서가 이를 델타 시간성으로 변환하므로 latest() 대신 sum() 또는 rate() 을(를) 사용하여 차트를 작성하세요.