공개 미리보기
이 기능은 현재 공개 미리 보기입니다.
IBM MQ 통합 은 IBM MQ 에서 차원 메트릭을 수집하고 보냅니다.
사전 구축된 대시보드에서 이 메트릭 데이터 를 보고, 경고 정책을 만들고, 사용자 지정 쿼리 및 차트를 만들 수 있습니다.
New Relic IBM MQ Monitor 빠른 시작 을 통해 설치된 대시보드.
통합은 Prometheus 내보내기를 통해 IBM MQ API를 스크랩하여 데이터를 얻습니다.
중요
IBM MQ 통합은 ARM64 아키텍처를 지원하지 않습니다.
IBM MQ 모니터링 통합을 설치하려면 다음 단계를 실행하십시오.
호환성 및 요구 사항
IBM MQ 버전
통합은 IBM MQ 9.0 이상과 호환됩니다.
지원되는 운영 체제
리눅스
특정 Linux 버전의 전체 목록은 호환되는 운영 체제 표를 확인하세요.
시스템 요구 사항
- 인프라 에이전트(최소 버전 1.24.0)를 설치합니다 .
- 인프라 에이전트와 호환되는 Linux 배포판.
- 에이전트 상자의 IBM MQ 재배포 가능 클라이언트 라이브러리 .
LD_LIBRARY_PATH
환경 변수에서 라이브러리 경로를 확인하거나 추가하세요.- MQ에서 큐 통계 모니터링 이 사용 가능한지 확인하십시오.
- 읽기 전용 권한이 있는 MQ 에서 사용자를 작성하십시오 .
설치 및 활성화
통합을 설치하려면 환경에 대한 지침을 따르세요.
리눅스 설치
통합 설치 지침을 따르고
nri-ibmmq
을 파일 이름으로 사용합니다.다음을 실행하여 디렉토리를 통합 구성 폴더로 변경하십시오.
bash$cd /etc/newrelic-infra/integrations.d다음을 실행하여 샘플 구성 파일을 복사합니다.
bash$sudo cp ibmmq-config.yml.sample ibmmq-config.yml즐겨 사용하는 편집기로
ibmmq-config.yml
구성 파일을 편집합니다. 몇 가지 훌륭한 구성 파일 예제 를 확인하십시오.인프라 에이전트를 다시 시작하십시오. 다양한 Linux 환경에서 인프라 에이전트를 다시 시작하는 방법을 참조하십시오.
기타 환경
ibmmq-config.yml 샘플 파일
통합 구성
통합을 구성하려면 통합의 YAML 구성 파일 ibmmq-config.yml
에서 구성을 편집합니다. 통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다. 구성 파일에는 모든 통합에 적용할 수 있는 공통 설정이 있습니다.
이러한 공통 설정에 대한 모든 내용을 읽으려면 구성 형식 문서를 참조하십시오.
데이터 찾기 및 사용
- New Relic IBM MQ Monitor 빠른 시작 은 I/O(Instant Observability) 를 통해 사용할 수 있습니다. 데이터를 쉽게 탐색하고 컨텍스트를 이해하며 문제를 더 빠르게 해결할 수 있는 대시보드를 제공합니다.
- 데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
- 측정항목은 항목
IBMMQ_MANAGER
및IBMMQ_QUEUE
의 측정항목 샘플 및 이벤트 유형 에 연결됩니다. - 문제 해결을 위해 또는 맞춤형 차트 및 대시보드 를 생성하기 위해 New Relic의 데이터를 쿼리 할 수 있습니다.
IBM MQ 인스턴스 설정
IBM MQ 통합은 다음 차원 메트릭을 수집합니다.
환경 | 설명 | 기본값 |
---|---|---|
hostname | IBM MQ 서비스의 호스트 이름 | 해당 없음 |
포트 | IBM MQ 서비스의 포트 | 해당 없음 |
queue_manager | 큐 관리자 이름 | 해당 없음 |
채널 | 큐 관리자에 연결하는 데 사용되는 채널 이름입니다. 일반적으로 다음을 사용할 수 있습니다. | 해당 없음 |
사용자 이름 | IBM MQ 서비스에 인증하기 위한 사용자 이름 | 해당 없음 |
비밀번호 | IBM MQ 서비스에 인증하기 위한 비밀번호 | 해당 없음 |
모니터링된 대기열 | 모니터링할 대기열(와일드카드 및 ! 제외) | 해당 없음 |
모니터링 채널 | 모니터링할 채널(와일드카드 및 제외할 ! 허용) | 해당 없음 |
모니터링된_주제 | 모니터링할 주제(와일드카드 및 제외할 ! 허용) | 해당 없음 |
모니터링된_구독 | 모니터링할 구독(와일드카드 및 제외할 ! 허용) | 해당 없음 |
exporter_port | 스크레이프 엔드포인트를 노출할 포트, 이것이 제공되지 않으면 임의의 포트가 내보내기를 시작하는 데 사용됩니다. | 랜덤 포트 |
측정항목 데이터
다음 차원 측정항목은 내보내기를 스크랩하여 캡처되고 엔티티 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 수 |
|
| 가져오기 이후 시간 |
|
| 넣기 이후 시간 |
|
| 커밋되지 않은 메시지(수) |
|
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 고유한 포크를 만들어 빌드할 수 있습니다.
또한 이 통합은 커뮤니티에서 만든 오픈 소스 내보내기를 활용합니다.