공개 미리보기
이 기능은 현재 공개 미리 보기입니다.
IBM MQ 통합 은 IBM MQ 에서 차원 메트릭을 수집하고 보냅니다.
사전 구축된 대시보드에서 이 메트릭 데이터 를 보고, 경고 정책을 만들고, 사용자 지정 쿼리 및 차트를 만들 수 있습니다.
New Relic IBM MQ Monitor 빠른 시작 을 통해 설치된 대시보드.
IBM MQ 인프라에서 데이터를 가져오기 위해 IBM MQ 통합은 구성에 지정된 포트에서 Prometheus 메트릭을 노출하는 타사 Prometheus 내보내기를사용합니다. 통합은 이러한 메트릭을 수집하고 엔터티로 변환하고 필터링한 다음 New Relic으로 보냅니다.
중요
IBM MQ 통합은 ARM64 아키텍처를 지원하지 않습니다.
IBM MQ 모니터링 통합을 설치하려면 다음 단계를 실행하십시오.
호환성 및 요구 사항
IBM MQ 버전
통합은 IBM MQ 9.0 이상과 호환됩니다.
지원되는 운영 체제
- 리눅스
- 윈도우
특정 Linux 및 Windows 버전의 전체 목록은 호환되는 운영 체제 표를 확인하십시오.
중요
ARM64 아키텍처는 지원되지 않습니다.
시스템 요구 사항
- 인프라 에이전트(최소 버전 1.24.0)를 설치합니다 .
- 인프라 에이전트와 호환되는 Linux 배포판 또는 Windows 버전.
- 에이전트 상자의 IBM MQ 재배포 가능 클라이언트 라이브러리 .
- Linux의
LD_LIBRARY_PATH
환경 변수에서 라이브러리 경로를 확인 또는 추가하거나 Windows에서 다음 단계 를 따르세요. - MQ에서 큐 통계 모니터링 이 사용 가능한지 확인하십시오.
- 읽기 전용 권한이 있는 MQ 에서 사용자를 작성하십시오 .
설치 및 활성화
통합을 설치하려면 환경에 대한 지침을 따르세요.
기타 환경
이 문서가 설치하는데 도움이 되셨나요?
통합 구성
통합을 구성하려면 통합의 YAML 구성 파일 ibmmq-config.yml
에서 구성을 편집합니다. 통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다. 구성 파일에는 모든 통합에 적용할 수 있는 공통 설정이 있습니다.
이러한 공통 설정에 대한 모든 내용을 읽으려면 구성 형식 문서를 참조하십시오.
IBM MQ 인스턴스 설정
다음 구성 옵션을 사용할 수 있습니다.
환경 | 설명 | 기본값 |
---|---|---|
hostname | IBM MQ 서비스의 호스트 이름 | 해당 없음 |
포트 | IBM MQ 서비스의 포트 | 해당 없음 |
queue_manager | 큐 관리자 이름 | 해당 없음 |
채널 | 큐 관리자에 연결하는 데 사용되는 채널 이름입니다. 일반적으로 다음을 사용할 수 있습니다. | 해당 없음 |
사용자 이름 | IBM MQ 서비스에 인증할 사용자 이름입니다. 비밀번호를 지정하지 않으면 사용자/비밀번호 인증이 비활성화되며 구성에서 사용자 이름을 지정하면 안 됩니다. 내보내기는 통합을 실행하는 사용자를 | 해당 없음 |
비밀번호 | IBM MQ 서비스에 인증하기 위한 비밀번호 | 해당 없음 |
모니터링된 대기열 | 모니터링할 대기열(와일드카드 및 ! 제외) | 해당 없음 |
모니터링 채널 | 모니터링할 채널(와일드카드 및 제외할 ! 허용) | 해당 없음 |
모니터링된_주제 | 모니터링할 주제(와일드카드 및 제외할 ! 허용) | 해당 없음 |
모니터링된_구독 | 모니터링할 구독(와일드카드 및 제외할 ! 허용) | 해당 없음 |
exporter_port | 스크레이프 엔드포인트를 노출할 포트, 이것이 제공되지 않으면 임의의 포트가 내보내기를 시작하는 데 사용됩니다. | 랜덤 포트 |
scrape_timeout | 스크랩 요청이 시간 초과될 때까지의 시간 | 5초 |
mqsslkeyr | TLS 구성에 필요 MQSSLKEYR은 사용자 또는 서버에 속한 디지털 인증서를 보유하는 키 저장소의 위치를 지정합니다. | 해당 없음 |
ccdt_url | ccdt 파일에 대한 TLS 경로를 구성하는 데 필요합니다. MQCCDTURL 및 IBMMQ_CONNECTION_CCDTURL이라는 두 가지 다른 환경 변수가 자동으로 설정됩니다. | 해당 없음 |
집 | IBMMQ 클라이언트는 HOME 환경 변수에 지정된 디렉토리에 쓰기 권한이 필요합니다. | 해당 없음 |
ld_library_path | 내보내기에서 사용하는 IBMMQ 클라이언트의 LD_LIBRARY_PATH 환경 변수입니다. | 해당 없음 |
ibmmq-config.yml 샘플 파일
데이터 찾기 및 사용
- New Relic IBM MQ Monitor 빠른 시작 은 I/O(Instant Observability) 를 통해 사용할 수 있습니다. 데이터를 쉽게 탐색하고 컨텍스트를 이해하며 문제를 더 빠르게 해결할 수 있는 대시보드를 제공합니다.
- 데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
- 측정항목은 항목
IBMMQ_MANAGER
및IBMMQ_QUEUE
의 측정항목 샘플 및 이벤트 유형 에 연결됩니다. - 문제 해결을 위해 또는 맞춤형 차트 및 대시보드 를 생성하기 위해 New Relic의 데이터를 쿼리 할 수 있습니다.
측정항목 데이터
IBMMQ_MANAGER
및 IBMMQ_QUEUE
의 두 항목이 생성됩니다.
다음 차원 측정항목은 내보내기를 스크랩하여 캡처되고 엔티티 IBMMQ_MANAGER
에 연결됩니다.
이름 | 설명 | 치수 |
---|---|---|
| 버퍼 rcvd |
|
| 보낸 버퍼 |
|
| 바이트 rcvd |
|
| 전송된 바이트 |
|
| 채널 인스턴스 유형 |
|
| 메시지(SVRCONN용 API 호출) |
|
|
| |
| 채널 상태 - 단순화 |
|
| 채널 하위 상태 |
|
| 메시지 이후 시간 |
|
| 채널 유형 |
|
| 영구 구독 수 변경 |
|
| 채널 이니시에이터 상태 |
|
| 명령 서버 상태 |
|
| 커밋 수 |
|
| 동시 연결 - 상위 워터 마크 |
|
| 연결 수 |
|
| CPU 로드 - 평균 15분 |
|
| CPU 로드 - 평균 5분 |
|
| CPU 부하 - 평균 1분 |
|
| 영구 구독 수 생성 |
|
| 비영구 구독 수 생성 |
|
| 영구 구독 수 삭제 |
|
| 비영구 구독 수 삭제 |
|
| 영구 가입자 - 최고 수위 표시 |
|
| 내구성 있는 가입자 - 낮은 워터마크 |
|
| 만료된 메시지 수 |
|
| 처리된 리소스 발행 수 |
|
| 실패한 찾아보기 수 |
|
| 구독 수 생성/변경/재개 실패 |
|
| 실패한 MQCB 수 |
|
| 실패한 MQCLOSE 수 |
|
| 실패한 MQCONN/MQCONNX 수 |
|
| 실패한 MQGET - 개수 |
|
| 실패한 MQINQ 수 |
|
| 실패한 MQOPEN 수 |
|
| 실패한 MQPUT 수 |
|
| 실패한 MQPUT1 수 |
|
| 실패한 MQSET 수 |
|
| 실패한 MQSUBRQ 수 |
|
| 실패한 주제 MQPUT/MQPUT1 개수 |
|
| 지속되지 않는 메시지가 있음 - 바이트 수 |
|
| 지속적인 메시지 수신 - 바이트 수 |
|
| 간격 총 소멸 가져오기 - 바이트 수 |
|
| 간격 총 파괴 get-count |
|
| 간격 총 MQPUT/MQPUT1 바이트 수 |
|
| 간격 총 MQPUT/MQPUT1 개수 |
|
| 간격 총 토픽 바이트 넣기 |
|
| 로그 - 현재 사용 중인 기본 공간 |
|
| 로그 파일 시스템 - 사용 중인 바이트 |
|
| 로그 파일 시스템 - 최대 바이트 수 |
|
| 로그 - 사용 중인 바이트 |
|
| 로그 - 기록된 논리적 바이트 |
|
| 로그 - 최대 바이트 |
|
| 로그 - 기록된 물리적 바이트 |
|
| 로그 - 워크로드 기본 공간 활용도 |
|
| 로그 - 쓰기 지연 시간 |
|
| 로그 - 쓰기 크기 |
|
| MQ 오류 파일 시스템 - 여유 공간 |
|
| MQ 오류 파일 시스템 - 사용 중인 바이트 |
|
| MQ FDC 파일 수 |
|
| MQ 추적 파일 시스템 - 여유 공간 |
|
| MQ 추적 파일 시스템 - 사용 중인 바이트 |
|
| MQCB 수 |
|
| MQCLOSE 수 |
|
| MQCONN/MQCONNX 수 |
|
| MQCTL 수 |
|
| MQDISC 수 |
|
| MQINQ 수 |
|
| MQOPEN 수 |
|
| MQSET 수 |
|
| MQSTAT 수 |
|
| MQSUBRQ 수 |
|
| 비영구 가입자 - 상위 워터마크 |
|
| 비영구 가입자 - 로우 워터마크 |
|
| 비지속적 메시지 찾아보기 - 바이트 수 |
|
| 비지속적 메시지 찾아보기 - 개수 |
|
| 비지속적 메시지 파괴적 get - count |
|
| 비지속 메시지 MQPUT 수 |
|
| 비지속 메시지 MQPUT1 개수 |
|
| 비지속적 - 주제 MQPUT/MQPUT1 개수 |
|
| 영구 메시지 찾아보기 - 바이트 수 |
|
| 영구 메시지 찾아보기 - 개수 |
|
| 영구 메시지 파괴적인 get - count |
|
| 지속 메시지 MQPUT 수 |
|
| 지속 메시지 MQPUT1 수 |
|
| 지속적 - 주제 MQPUT/MQPUT1 수 |
|
| 구독자에게 게시됨 - 바이트 수 |
|
| 구독자에게 게시됨 - 메시지 수 |
|
| 제거된 대기열 수 |
|
| 비지속적 메시지 넣기 - 바이트 수 |
|
| 영구 메시지 넣기 - 바이트 수 |
|
| 큐 관리자 파일 시스템 - 여유 공간 |
|
| 큐 관리자 파일 시스템 - 사용 중인 바이트 |
|
| RAM 여유 비율 |
|
| RAM 총 바이트 |
|
| RAM 총 바이트 - 큐 관리자에 대한 추정치 |
|
| 지속 구독 수 재개 |
|
| 롤백 횟수 |
|
| 대기열 관리자 상태 |
|
| 구독 삭제 실패 횟수 |
|
| 시스템 CPU 시간 - 큐 관리자의 예상 백분율 |
|
| 시스템 CPU 시간 백분율 |
|
| 주제 MQPUT/MQPUT1 간격 합계 |
|
| 가동 시간 |
|
| 사용자 CPU 시간 - 큐 관리자의 예상 백분율 |
|
| 사용자 CPU 시간 백분율 |
|
| 받은 메시지 |
|
| 메시지 수신 이후 시간 |
|
| 구독 유형 |
|
| 받은 메시지 |
|
| 게시자 수 |
|
| 가입자 수 |
|
| 메시지 이후 시간 |
|
다음 차원 측정항목은 내보내기를 스크랩하여 캡처되고 엔티티 IBMMQ_QUEUE
에 연결됩니다.
이름 | 설명 | 치수 |
---|---|---|
| 대기열 최대 깊이 |
|
| 대기열 사용량 |
|
| 평균 대기열 시간 |
|
| 대기열 회피 바이트 |
|
| 큐 회피 풋 |
|
| 대기열 깊이 |
|
| 파괴적 MQGET 실패 |
|
| 파괴적 MQGET이 MQRC_NO_MSG_AVAILABLE로 실패함 |
|
| 파괴적 MQGET이 MQRC_TRUNCATED_MSG_FAILED로 실패함 |
|
| 파괴적 MQGET 비영구적 바이트 수 |
|
| 파괴적인 MQGET 비지속적 메시지 수 |
|
| 파괴적 MQGET 영구 바이트 수 |
|
| 파괴적인 MQGET 지속 메시지 수 |
|
| 만료된 메시지 |
|
| 입력 핸들 |
|
| 잠금 경합 |
|
| MQCLOSE 수 |
|
| MQGET 찾아보기 실패 |
|
| MQRC_NO_MSG_AVAILABLE로 MQGET 찾아보기가 실패함 |
|
| MQRC_TRUNCATED_MSG_FAILED로 MQGET 찾아보기가 실패함 |
|
| MQGET 찾아보기 비영구 바이트 수 |
|
| MQGET 찾아보기 비영구 메시지 수 |
|
| MQGET 찾아보기 영구 바이트 수 |
|
| MQGET 찾아보기 지속 메시지 수 |
|
| MQGET 바이트 수 |
|
| MQGET 수 |
|
| MQINQ 수 |
|
| MQOPEN 수 |
|
| MQPUT 바이트 수 |
|
| MQPUT/MQPUT1 카운트 |
|
| MQPUT 비지속적 메시지 수 |
|
| MQPUT 지속 메시지 수 |
|
| MQPUT1 비지속적 메시지 수 |
|
| MQPUT1 지속 메시지 수 |
|
| MQSET 수 |
|
| 비영구적 바이트 수 |
|
| 가장 오래된 메시지 |
|
| 입력 핸들 |
|
| 영구 바이트 수 |
|
| 대기열 제거 횟수 |
|
| 대기열 파일 현재 크기 |
|
| 대기열 파일 최대 크기 |
|
| 긴 대기열 |
|
| 대기열 시간이 짧음 |
|
| 롤백된 MQGET 수 |
|
| 롤백된 MQPUT 수 |
|
| 가져오기 이후 시간 |
|
| 넣기 이후 시간 |
|
| 커밋되지 않은 메시지(수) |
|
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.
또한 이 통합은 커뮤니티에서 만든 오픈 소스 내보내기를 활용합니다.