OpenTelemetry로 자체 호스팅 IBM MQ 모니터링

NRDOT 수집기 설치

Linux 배포판용 NRDOT 패키지를 다운로드하고 설치합니다. <NRDOT_VERSION> 을(를) nrdot-collector-releases 페이지의 최신 릴리스 태그로 바꿉니다(예: v0.12.0).

• Debian/Ubuntu의 경우:

  bash

  카피

  $
  curl -LO https://github.com/newrelic/nrdot-collector-releases/releases/download/<NRDOT_VERSION>/nrdot-collector_<NRDOT_VERSION>_linux_amd64.deb
  $
  sudo dpkg -i nrdot-collector_<NRDOT_VERSION>_linux_amd64.deb

• RHEL/Rocky/Amazon Linux의 경우:

  bash

  카피

  $
  curl -LO https://github.com/newrelic/nrdot-collector-releases/releases/download/<NRDOT_VERSION>/nrdot-collector_<NRDOT_VERSION>_linux_amd64.rpm
  $
  sudo dnf install ./nrdot-collector_<NRDOT_VERSION>_linux_amd64.rpm

NRDOT Collector구성

IBM MQ 메트릭을 수집하여 뉴렐릭으로 보내도록 NRDOT Collector를 구성합니다. 이 설정은 세 가지 주요 작업을 처리합니다:

• 큐 관리자에 연결
• 데이터 정리
• 뉴렐릭으로 데이터 전송

1. 필요한 권한으로 디렉터리 및 수집기 설정 파일을 생성하려면 다음을 실행하세요:

   bash

   카피

   $
   # Config directory — group-readable by nrdot only (it will hold secrets)
   $
   sudo install -d -o root -g nrdot -m 0750 /etc/nrdot-collector
   $
   
   $
   # Create the config file with correct permissions
   $
   sudo install -o root -g nrdot -m 0640 /dev/null /etc/nrdot-collector/ibmmq-config.yaml
   $
   sudo -u nrdot ${EDITOR:-vi} /etc/nrdot-collector/ibmmq-config.yaml

2. 생성된 설정 파일에 다음 설정을 붙여넣고, 플레이스홀더를 실제 값으로 바꿉니다:

   extensions:
     health_check:
       endpoint: 127.0.0.1:13133
   
   processors:
   
     filter/ibmmq-overhead:
       metrics:
         exclude:
           match_type: regexp
           metric_names:
             - "^go_.*"
             - "^process_.*"
             - "^promhttp_.*"
             - "^scrape_.*"
   
     filter/ibmmq-queues:
       metrics:
         datapoint:
           - 'attributes["queue"] != nil and IsMatch(attributes["queue"], "^SYSTEM\\.(ADMIN\\.|MQSC\\.|DEFAULT\\.|AUTH\\.|CHANNEL\\.|CHLAUTH\\.|CICS\\.|SYNCPOINT\\.|INTERNAL\\.|PENDING\\.|PROTECTION\\.|BROKER\\.|AMQP\\.|DOTNET\\.|REST\\.|RETAINED\\.|SELECTION\\.|DURABLE\\.|HIERARCHY\\.|DDELAY\\.)")'
           - 'attributes["queue"] != nil and IsMatch(attributes["queue"], "^SYSTEM\\.CLUSTER\\.(COMMAND|HISTORY)\\.QUEUE$")'
           - 'attributes["queue"] != nil and IsMatch(attributes["queue"], "^AMQ\\.")'
   
     resourcedetection:
       detectors: [env, ec2, system]
       system:
         resource_attributes:
           host.name:
             enabled: true
           host.id:
             enabled: true
   
     transform/ibmmq-cleanup:
       metric_statements:
         - context: resource
           statements:
             - delete_key(attributes, "server.address")
             - delete_key(attributes, "server.port")
             - delete_key(attributes, "url.scheme")
         - context: datapoint
           statements:
             # Rename the injected identity labels to their OTel dotted form — the
             # names New Relic's IBM MQ entity synthesis keys on. qmgr / queue stay raw.
             - set(attributes["target.name"], attributes["targetName"]) where attributes["targetName"] != nil
             - delete_key(attributes, "targetName")
             - set(attributes["cluster.name"], attributes["clusterName"]) where attributes["clusterName"] != nil
             - delete_key(attributes, "clusterName")
             - delete_key(attributes, "instance")
             - delete_key(attributes, "job")
   
     memory_limiter/ibmmq:
       check_interval: 1s
       limit_mib: 512
       spike_limit_mib: 256
   
     cumulativetodelta/ibmmq: {}
   
     batch/ibmmq:
       send_batch_size: 1000
       timeout: 200ms
   
   exporters:
   
     otlphttp/ibmmq:
       endpoint: ${env:NEW_RELIC_OTLP_ENDPOINT}
       headers:
         api-key: ${env:NEW_RELIC_LICENSE_KEY}
   
   receivers:
   
     prometheus/ibmmq-qm1:
       config:
         scrape_configs:
           - job_name: 'ibmmq-qm1'
             scrape_interval: ${env:IBMMQ_SCRAPE_INTERVAL:-60s}
             scrape_timeout: 15s
             static_configs:
               - targets:
                   - "${env:IBMMQ_QM1_ENDPOINT:-localhost:9157}"
                 labels:
                   targetName: "${env:TARGET_NAME}"
                   clusterName: "${env:IBMMQ_CLUSTER_NAME:-}"
   
   service:
     pipelines:
       metrics/ibmmq-qm1:
         receivers: [prometheus/ibmmq-qm1]
         processors:
           - filter/ibmmq-overhead
           - filter/ibmmq-queues
           - resourcedetection
           - transform/ibmmq-cleanup
           - memory_limiter/ibmmq
           - cumulativetodelta/ibmmq
           - batch/ibmmq
         exporters: [otlphttp/ibmmq]
   
     extensions: [health_check]

   카피

   중요

   프로세서를 재정렬하거나 제거하지 마십시오. 프로세서 체인 순서는 엔티티 합성에 필수적입니다. transform/ibmmq-cleanup 프로세서는 resourcedetection 프로세서 다음에 실행되어야 합니다. 이 순서를 바꾸면 IBM MQ 메트릭이 IBMMQ_MANAGER 엔티티 대신 수집기 자체 엔티티와 연결되어 대시보드에 데이터가 표시되지 않습니다.

   이 설정의 역할

   이 설정은 IBM MQ 큐 관리자에서 메트릭을 수집하고 구조화된 데이터를 뉴렐릭으로 라우팅하는 파이프라인을 생성합니다. 각 구성 요소는 특정 기능을 수행합니다:

   요소	설명
   health_check	수집기가 실행 중인지 확인하고 시작 문제를 해결하기 위해 {"status":"Server available"} 을(를) 반환하는 상태 엔드포인트를 127.0.0.1:13133 에 제공합니다.
   prometheus/ibmmq-qm1	메트릭을 수집하기 위해 60초마다 각 큐 관리자의 익스포터에 연결합니다. 각 큐 관리자는 독립적인 수신기를 사용하며, 한 큐 관리자에 장애가 발생해도 나머지 수신기는 계속 정상적으로 작동합니다. 큐 관리자를 더 추가하려면 다른 큐 관리자 추가 섹션을 참조하세요.
   filter/ibmmq-overhead	IBM MQ 신호가 포함되지 않은 익스포터의 내부 자체 메트릭(go_* 및 process_* 등)을 제거합니다. 불필요한 텔레메트리를 필터링하여 데이터 수집 비용을 최적화합니다.
   filter/ibmmq-queues	내부 IBM MQ 시스템 큐(SYSTEM.* 및 AMQ.*)를 제외하여 애플리케이션 큐만 IBMMQ_QUEUE 엔티티가 되도록 합니다. 이를 통해 전체 엔티티 수를 줄이고 중요한 자산에 대한 모니터링에 집중할 수 있습니다.
   transform/ibmmq-cleanup	이는 메트릭을 뉴렐릭의 적절한 IBM MQ 엔티티에 매핑하는 중요한 구성 요소입니다. 이 구성 요소가 없으면 데이터는 연결된 대시보드 및 알림과 함께 IBMMQ_MANAGER 및 IBMMQ_QUEUE 엔티티를 합성하는 대신 일반 수집기 메트릭으로 나타납니다.
   memory_limiter/ibmmq	수집기가 시스템 리소스 제한을 초과하지 않도록 메모리 사용량을 512MB(256MB 스파이크 허용)로 제한합니다.
   batch/ibmmq	요청당 최대 1,000개의 데이터 포인트를 번들로 묶어 네트워크 오버헤드를 줄이기 위해 전송 전에 메트릭을 함께 그룹화합니다.
   otlphttp/ibmmq	인증을 위해 구성된 라이선스 키와 지정된 리전 엔드포인트를 사용하여 처리된 메트릭을 뉴렐릭으로 내보냅니다.

   각 큐 관리자는 독립적인 파이프라인을 사용하므로 한 인스턴스의 문제가 다른 인스턴스에 영향을 미치지 않습니다. 프로세서 순서는 매우 중요하므로 프로세서를 재정렬하거나 제거하지 마십시오. 그렇지 않으면 메트릭이 IBM MQ 엔티티에 올바르게 매핑되지 않습니다.

NRDOT 환경 변수 설정

수집기 설정은 뉴렐릭 라이선스 키 및 큐 관리자 엔드포인트와 같은 배포별 값에 환경 변수를 사용합니다. 이 접근 방식은 설정 파일에서 시크릿을 분리하여 YAML을 편집하지 않고도 설정을 쉽게 조정할 수 있도록 합니다.

1. NRDOT 수집기용 환경 파일을 생성합니다:

   bash

   카피

   $
   # Owner nrdot, mode 0600 — this file holds the license key
   $
   sudo install -o nrdot -g nrdot -m 0600 /dev/null /etc/nrdot-collector/ibmmq-env
   $
   sudo -u nrdot ${EDITOR:-vi} /etc/nrdot-collector/ibmmq-env

2. 플레이스홀더를 실제 값으로 교체하여 파일에 KEY=VALUE 줄로 값을 추가합니다:

   # /etc/nrdot-collector/ibmmq-env
   
   # --- Required ---
   
   # New Relic ingest license key (40 chars, suffix NRAL)
   NEW_RELIC_LICENSE_KEY=<YOUR-LICENSE-KEY>
   
   # Stable host identity — first segment of every IBMMQ entity GUID
   TARGET_NAME=<YOUR-HOSTNAME>
   
   # mq-metric-samples exporter endpoints, one per queue manager
   IBMMQ_QM1_ENDPOINT=localhost:9157
   
   # --- Optional (shown with defaults) ---
   
   # OTLP endpoint: US prod default shown; For more information, refer to [New Relic OTLP endpoint](https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp).
   NEW_RELIC_OTLP_ENDPOINT=https://otlp.nr-data.net:4318
   
   # Optional tag grouping for the IBMMQ_MANAGER entity (does not affect the entity GUID).
   # Leave unset to omit cluster.name (nullable); set it to group QMs under one cluster tag.
   # IBMMQ_CLUSTER_NAME=prod-mq-cluster
   
   # Scrape interval — must be >= the mq-metric-samples pollInterval (default 60s)
   IBMMQ_SCRAPE_INTERVAL=60s

   카피

   주의

   초기 배포 후에는 TARGET_NAME 값을 변경하지 마십시오. 이 값은 모든 IBMMQ_MANAGER 및 IBMMQ_QUEUE 엔티티 GUID(target.name:qmgr)의 첫 번째 세그먼트를 형성합니다. 배포 후 이 값을 변경하면 새로운 엔티티가 생성되고 기존 엔티티가 고립되어 연결된 대시보드 및 알림이 손상됩니다. 초기 설정 시 Queue Manager QMID와 같은 안정적인 문자열을 선택하십시오. 자세한 내용은 IBM MQ 엔티티 모델을 참조하십시오.

   수집기를 시작하기 전에 설정을 확인하려면 셸에서 다음 환경 변수를 설정하세요:

   변하기 쉬운	필수의	설명
   NEW_RELIC_LICENSE_KEY	네	귀하의 뉴렐릭 수집 라이선스 키.
   TARGET_NAME	네	호스트명 또는 큐 관리자 ID와 같은 호스트의 식별자입니다. 초기 배포 이후에는 엔티티 ID의 일부가 되므로 변경하지 마십시오.
   IBMMQ_QM1_ENDPOINT	네	첫 번째 큐 관리자의 익스포터 위치입니다. 예를 들어, 동일한 호스트에서 실행 중인 경우 localhost:9157 입니다.
   NEW_RELIC_OTLP_ENDPOINT	아니요	해당 리전의 뉴렐릭 OTLP 엔드포인트. 자세한 내용은 뉴렐릭 OTLP 엔드포인트를 참조하세요.
   IBMMQ_CLUSTER_NAME	아니요	뉴렐릭에서 큐 관리자를 그룹화할 Cluster 이름입니다.
   IBMMQ_SCRAPE_INTERVAL	아니요	뉴렐릭으로 메트릭을 내보내기 위한 수집 간격입니다. 기본 수집 간격은 60초입니다.

NRDOT systemd 서비스 설정

1. 설정 및 환경 파일을 로드할 systemd 드롭인 파일을 만듭니다.

   bash

   카피

   $
   sudo mkdir -p /etc/systemd/system/nrdot-collector.service.d
   $
   sudo tee /etc/systemd/system/nrdot-collector.service.d/ibmmq.conf > /dev/null << 'EOF'
   $
   [Service]
   $
   EnvironmentFile=/etc/nrdot-collector/ibmmq-env
   $
   ExecStart=
   $
   ExecStart=/usr/bin/nrdot-collector --config /etc/nrdot-collector/ibmmq-config.yaml
   $
   MemoryMax=1G
   $
   LimitNOFILE=65536
   $
   NoNewPrivileges=true
   $
   ProtectSystem=strict
   $
   ProtectHome=true
   $
   EOF

   빈 ExecStart= 줄은 기본 명령을 지우고 두 번째 줄은 사용자 지정 명령을 설정합니다. 이렇게 하면 수집기가 두 번 시작되는 것을 방지할 수 있습니다. 다른 설정은 환경 파일을 로드하고, 메모리 사용량을 제한하며, 보안을 개선합니다.

2. 드롭인을 생성한 후 systemd가 오류 없이 구문 분석할 수 있는지 확인합니다:

   bash

   카피

   $
   sudo systemd-analyze verify /etc/systemd/system/nrdot-collector.service
   $
   # No output means no syntax errors

NRDOT 수집기를 시작하고 확인

1. 수집기를 시작하고 부팅 시 자동으로 실행되도록 활성화합니다:

   bash

   카피

   $
   sudo systemctl daemon-reload
   $
   sudo systemctl enable --now nrdot-collector.service
   $
   sudo systemctl status nrdot-collector.service --no-pager

   status 명령은 Active: active (running)을(를) 표시해야 합니다. Active: failed이(가) 표시되면 journalctl -u nrdot-collector.service -n 200 --no-pager을(를) 사용하여 로그를 확인합니다.

2. 수집기가 정상인지 확인합니다:

   bash

   카피

   $
   curl -sS http://127.0.0.1:13133
   $
   # Expected: {"status":"Server available", ...}

3. IBM MQ 메트릭이 뉴렐릭으로 전송되고 있는지 확인하세요. 수집기가 시작된 후 60초 동안 기다린 다음, 데이터 찾기 및 쿼리의 확인 쿼리를 사용하여 데이터를 확인하세요.

New Relic에서 데이터 보기

수집기가 실행되고 메트릭이 수집되기 시작하면 뉴렐릭에서 큐 관리자가 IBMMQ_MANAGER 엔티티로 표시되고 해당 큐가 하위 IBMMQ_QUEUE 엔티티로 표시됩니다. 데이터 찾기, 쿼리 실행, 대시보드 및 알림 설정에 대한 자세한 내용은 데이터 찾기 및 쿼리를 참조하세요.