OpenTelemetry를 사용하여 자체 호스팅 RabbitMQ를 모니터링하세요.

OpenTelemetry Collector를 설치하고 구성하여 Linux 호스트에서 실행 중인 RabbitMQ를 모니터링하세요. 이 종합 가이드는 Debian, Ubuntu, RHEL 및 CentOS 시스템의 설치, 설정 및 검증 과정을 단계별로 안내합니다.

설치 단계

자체 호스팅 RabbitMQ 인스턴스에 대한 모니터링을 설정하려면 다음 단계를 따르십시오.

시작하기 전에

사용 환경이 다음 요구 사항을 충족하는지 확인하십시오.

RabbitMQ 관리 플러그인을 활성화하세요.

관리 플러그인은 OpenTelemetry Collector가 수집하는 API를 제공합니다.

bash

$sudo rabbitmq-plugins enable rabbitmq_management

제대로 작동하는지 확인하세요:

bash

$curl -I -u admin:password http://localhost:15672/api/overview

응답에 HTTP/1.1 200 OK 표시되어야 합니다.

OpenTelemetry Collector를 설치하세요.

모든 리눅스 배포판에서 사용 가능:

호스트 운영 체제에 맞는 OpenTelemetry Collector Contrib 바이너리를 OpenTelemetry Collector 릴리스 페이지 에서 다운로드하여 설치하십시오.

수집기 구성

/etc/otelcol-contrib/config.yaml 생성하거나 교체하세요:

receivers:
  rabbitmq:
    endpoint: http://localhost:15672
    username: admin
    password: password
    collection_interval: 30s
    metrics:
      # Queue Metrics (essential for message flow and backlog)
      rabbitmq.consumer.count:
        enabled: true
      rabbitmq.message.delivered:
        enabled: true
      rabbitmq.message.published:
        enabled: true
      rabbitmq.message.acknowledged:
        enabled: true
      rabbitmq.message.dropped:
        enabled: true
      rabbitmq.message.current:
        enabled: true # Crucial for monitoring queue backlog, includes 'ready' and 'unacknowledged' states

      # Node Health Metrics (critical for server resource monitoring)
      rabbitmq.node.disk_free:
        enabled: true
      rabbitmq.node.disk_free_limit:
        enabled: true
      rabbitmq.node.disk_free_alarm:
        enabled: true
      rabbitmq.node.mem_used:
        enabled: true
      rabbitmq.node.mem_limit:
        enabled: true
      rabbitmq.node.mem_alarm:
        enabled: true
      rabbitmq.node.mem_used_details.rate:
        enabled: true
      rabbitmq.node.fd_used:
        enabled: true
      rabbitmq.node.fd_total:
        enabled: true
      rabbitmq.node.sockets_used:
        enabled: true
      rabbitmq.node.sockets_total:
        enabled: true
      rabbitmq.node.proc_used:
        enabled: true
      rabbitmq.node.proc_total:
        enabled: true
      rabbitmq.node.uptime:
        enabled: true
      rabbitmq.node.run_queue:
        enabled: true
      rabbitmq.node.processors:
        enabled: true
      rabbitmq.node.context_switches_details.rate:
        enabled: true
      rabbitmq.node.gc_num_details.rate:
        enabled: true
      rabbitmq.node.gc_bytes_reclaimed_details.rate:
        enabled: true

      # I/O Metrics (important for understanding disk and network activity)
      rabbitmq.node.io_read_count_details.rate:
        enabled: true
      rabbitmq.node.io_read_bytes_details.rate:
        enabled: true
      rabbitmq.node.io_read_avg_time_details.rate:
        enabled: true
      rabbitmq.node.io_write_count_details.rate:
        enabled: true
      rabbitmq.node.io_write_bytes_details.rate:
        enabled: true
      rabbitmq.node.io_write_avg_time_details.rate:
        enabled: true
      rabbitmq.node.io_sync_count_details.rate:
        enabled: true
      rabbitmq.node.io_sync_avg_time_details.rate:
        enabled: true
      rabbitmq.node.io_seek_count_details.rate:
        enabled: true
      rabbitmq.node.io_seek_avg_time_details.rate:
        enabled: true
      rabbitmq.node.io_reopen_count_details.rate:
        enabled: true

      # Mnesia and Store Metrics (for internal database and message storage)
      rabbitmq.node.mnesia_ram_tx_count_details.rate:
        enabled: true
      rabbitmq.node.mnesia_disk_tx_count_details.rate:
        enabled: true
      rabbitmq.node.msg_store_read_count_details.rate:
        enabled: true
      rabbitmq.node.msg_store_write_count_details.rate:
        enabled: true
      rabbitmq.node.queue_index_write_count_details.rate:
        enabled: true
      rabbitmq.node.queue_index_read_count_details.rate:
        enabled: true

      # Connection/Channel/Queue Lifecycle Metrics
      rabbitmq.node.connection_created_details.rate:
        enabled: true
      rabbitmq.node.connection_closed_details.rate:
        enabled: true
      rabbitmq.node.channel_created_details.rate:
        enabled: true
      rabbitmq.node.channel_closed_details.rate:
        enabled: true
      rabbitmq.node.queue_declared_details.rate:
        enabled: true
      rabbitmq.node.queue_created_details.rate:
        enabled: true
      rabbitmq.node.queue_deleted_details.rate:
        enabled: true

# processors: Process data before exporting.
processors:
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: true
        host.id:
          enabled: true
  resource:
    attributes:
      - key: instrumentation.provider
        value: opentelemetry
        action: upsert
      - key: rabbitmq.deployment.name
        value: my-rabbitmq-server  # Replace with your server name
        action: upsert
  batch:
    send_batch_size: 1024
    timeout: 30s

exporters:
  otlphttp/newrelic:
    endpoint: ${env:NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:NEWRELIC_LICENSE_KEY}
    compression: gzip

service:
  pipelines:
    metrics:
      receivers: [rabbitmq]
      processors: [resourcedetection, resource, batch]
      exporters: [otlphttp/newrelic]

설정에서 다음 값을 업데이트하세요.

endpointRabbitMQ 관리 API URL (기본값: http://localhost:15672)
username 및 password: RabbitMQ 자격 증명
rabbitmq.deployment.name이 RabbitMQ 인스턴스에 대한 고유한 이름입니다.
collection_interval메트릭을 수집하는 빈도(기본값: 30초)

환경 변수 설정

환경 변수에 대한 systemd 재정의 파일을 생성합니다.

bash

$sudo mkdir -p /etc/systemd/system/otelcol-contrib.service.d

뉴렐릭 지역을 선택하세요:

bash

$cat <<EOF | sudo tee /etc/systemd/system/otelcol-contrib.service.d/environment.conf
$[Service]
$Environment="NEWRELIC_OTLP_ENDPOINT=https://otlp.nr-data.net:4318"
$Environment="NEWRELIC_LICENSE_KEY=YOUR_LICENSE_KEY"
$EOF

YOUR_LICENSE_KEY 뉴렐릭 클러스터 키로 바꿉니다.

bash

$cat <<EOF | sudo tee /etc/systemd/system/otelcol-contrib.service.d/environment.conf
$[Service]
$Environment="NEWRELIC_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net:4318"
$Environment="NEWRELIC_LICENSE_KEY=YOUR_LICENSE_KEY"
$EOF

YOUR_LICENSE_KEY 뉴렐릭 클러스터 키로 바꿉니다.

systemd 다시 로드하고 수집기를 재시작하세요.

bash

$sudo systemctl daemon-reload
$sudo systemctl restart otelcol-contrib

뉴렐릭에서 데이터를 확인하세요

서비스 상태를 확인하세요:

bash

$sudo systemctl status otelcol-contrib

출력 결과에 active (running) 표시되어야 합니다.

최근 로그 보기:

bash

$sudo journalctl -u otelcol-contrib -n 50 --no-pager

데이터 수집이 성공적으로 완료되었음을 나타내는 메시지를 찾아보세요.

INFO    RabbitmqReceiver        Successfully scraped rabbitmq metrics

뉴렐릭에서 지표를 확인하세요.

데이터가 나타날 때까지 2-3분 정도 기다린 후 쿼리 빌더 에서 다음 쿼리를 실행하세요.

SELECT count(*)
FROM Metric
WHERE metricName LIKE 'rabbitmq.%'
  AND instrumentation.provider = 'opentelemetry'
  AND rabbitmq.deployment.name = 'my-rabbitmq-server'
FACET metricName
SINCE 10 minutes ago

다음과 같은 메트릭 이름이 표시될 것입니다.

rabbitmq.queue.count - 대기열 수
rabbitmq.queue.message.count - 큐 전체의 총 메시지 수
rabbitmq.connection.count - 활성 연결
rabbitmq.consumer.count - 적극적인 소비자

팁

5분 후에도 데이터가 표시되지 않으면 아래 문제 해결, 해결 섹션을 확인하세요.

(선택 사항) RabbitMQ 로그를 뉴렐릭으로 전달합니다.

메트릭 외에도 포괄적인 옵저버빌리티를 위해 RabbitMQ 로그 로그를 뉴렐릭으로 전달할 수 있습니다. 이는 지표와 로그 전반에 걸쳐 문제를 연관시키는 데 도움이 됩니다.

중요

로그 포워딩에는 추가 설정 및 시스템 권한이 필요합니다. 진행하기 전에 필요한 접근 권한이 있는지 확인하십시오.

/etc/otelcol-contrib/config.yaml업데이트하여 파일 로그 수신기를 추가하세요.

receivers:
  rabbitmq:
    # ... existing rabbitmq config ...

  # Add filelog receiver for RabbitMQ logs
  filelog/rabbitmq:
    include:
      - /var/log/rabbitmq/*.log
      - /var/log/rabbitmq/**/*.log
    include_file_path: true
    include_file_name: false
    operators:
      - type: regex_parser
        regex: '^(?P<timestamp>\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}) \[(?P<level>\w+)\] <(?P<pid>[^>]+)> (?P<message>.*)$'
        timestamp:
          parse_from: attributes.timestamp
          layout: '%Y-%m-%d %H:%M:%S.%L'
        severity:
          parse_from: attributes.severity

processors:
  # ... existing processors ...

  transform/rabbitmq_logs:
    log_statements:
      - context: resource
        statements:
          - set(attributes["rabbitmq.display.name"], Concat(["server", attributes["rabbitmq.deployment.name"]], ":"))

service:
  pipelines:
    metrics:
      receivers: [rabbitmq]
      processors: [resourcedetection, resource, batch]
      exporters: [otlphttp/newrelic]

    logs/rabbitmq:
      receivers: [filelog]
      processors: [batch, resource, transform/rabbitmq_logs]
      exporters: [otlphttp/newrelic]

수집기가 로그를 읽을 수 있는 권한을 부여하십시오. 한 가지 방법을 선택하세요:

rabbitmq 그룹에 추가:

bash

$sudo usermod -a -G rabbitmq otelcol-contrib

또는 파일 권한을 설정하세요.

bash

$sudo chmod 644 /var/log/rabbitmq/*.log

수집기를 재시작하세요:

bash

$sudo systemctl restart otelcol-contrib

뉴렐릭에서 로그가 수집되고 있는지 확인하세요.

SELECT count(*)
FROM Log
WHERE service.name = 'rabbitmq'
  AND rabbitmq.deployment.name = 'my-rabbitmq-server'
SINCE 10 minutes ago

데이터 찾기

몇 분 후 RabbitMQ 창이 뉴렐릭에 나타날 것입니다. 뉴럴릭 UI 의 다양한 보기에서 RabbitMQ 대역폭을 탐색하는 방법에 대한 자세한 지침은 데이터 찾기 및 검색을 참조하세요.

NRQL을 사용하여 데이터를 쿼리할 수도 있습니다.

FROM Metric SELECT * WHERE rabbitmq.deployment.name = 'my-rabbitmq-server'

문제점 해결

설치 후 뉴렐릭에 지표가 표시되지 않는 경우:

1. 관리 플러그인이 활성화되어 있는지 확인하십시오.

bash

$sudo rabbitmq-plugins list | grep management

[E*] rabbitmq_management 이 표시되면 활성화되어 실행 중인 것입니다.

2. 관리 API를 테스트합니다.

bash

$curl -u admin:password http://localhost:15672/api/overview

이 명령은 RabbitMQ 인스턴스에 대한 JSON 데이터를 반환합니다. 그렇지 않다면 관리 플러그인이 제대로 작동하지 않는 것입니다.

3. 수집기 로그에서 오류를 확인하십시오.

bash

$sudo journalctl -u otelcol-contrib -f

다음 내용을 찾아보세요:

인증 오류(잘못된 사용자 이름/비밀번호)
연결 시간 초과(네트워크 문제)
구문 분석 오류 (설정 구문 문제)

4. 수집기 서비스가 실행 중인지 확인합니다.

bash

$sudo systemctl status otelcol-contrib

active (running) 표시해야 합니다. 그렇지 않다면 로그를 확인하여 시작 실패 원인을 파악하십시오.

5. 라이선스 키를 확인하세요:

bash

$sudo cat /etc/systemd/system/otelcol-contrib.service.d/environment.conf

NEWRELIC_LICENSE_KEY 이 올바르게 설정되었는지, 불필요한 공백이나 따옴표가 없는지 확인하십시오.

수집기 로그에 connection refused 표시되면:

RabbitMQ가 15672번 포트에서 수신 대기 중인지 확인하십시오.

bash

$sudo netstat -tlnp | grep 15672

RabbitMQ가 수신 대기 중인 것을 확인할 수 있을 것입니다. 그렇지 않다면 관리 플러그인이 활성화되어 있지 않거나 예상 포트에 바인딩되어 있지 않은 것입니다.

방화벽 규칙을 확인하세요:

bash

$sudo iptables -L -n | grep 15672

방화벽 규칙으로 인해 15672번 포트가 차단되지 않았는지 확인하십시오.

엔드포인트 설정 확인:\ /etc/otelcol-contrib/config.yaml 의 endpoint 이 RabbitMQ 설정(호스트명, 포트)과 일치하는지 확인하십시오.

401 Unauthorized 오류가 발생하는 경우:

자격 증명을 확인하세요:\ /etc/otelcol-contrib/config.yaml 에 있는 사용자 이름과 비밀번호가 RabbitMQ 사용자 이름과 일치하는지 확인하십시오.

관리자 권한이 있는지 확인하십시오.

bash

$sudo rabbitmqctl list_users

사용자 계정에는 [administrator] 태그가 있어야 합니다. 그렇지 않다면 관리자 권한을 부여하십시오.

bash

$sudo rabbitmqctl set_user_tags your-username administrator

수집기가 과도한 자원을 소비하는 경우:

배치 크기를 줄이세요:\ batch 프로세서에서 send_batch_size 512에서 256 이하로 줄이십시오.

수집 간격을 늘리세요:\ 스크래핑 빈도를 낮추려면 collection_interval 30초에서 60초 이상으로 변경하세요.

불필요한 기능을 비활성화합니다.\ rabbitmq 수신기 설정에서는 필요하지 않은 지표입니다.

예시:

receivers:
  rabbitmq:
    collection_interval: 60s  # Increased
    metrics:
      rabbitmq.queue.message.count:
        enabled: true
      # Disable less critical metrics
      # rabbitmq.queue.count:
      #   enabled: false

로그 수집 시 권한 오류가 발생하는 경우:

파일 접근 테스트:

bash

$sudo -u otelcol-contrib cat /var/log/rabbitmq/rabbit@$(hostname).log

이 과정이 실패하면 수집기 사용자는 로그 파일을 읽을 수 없습니다.

파일 권한을 확인하세요:

bash

$ls -la /var/log/rabbitmq/

권한 수정:\ Rabbitmq 그룹에 수집기 사용자를 추가합니다.

bash

$sudo usermod -a -G rabbitmq otelcol-contrib
$sudo systemctl restart otelcol-contrib

다음 단계

이제 RabbitMQ 모델 설정이 완료되었으므로 옵저버빌리티를 향상할 수 있습니다.

데이터를 살펴보세요:

데이터 찾기 및 쿼리 - 뉴렐릭 UI 탐색하고 NRQL 쿼리 작성
RabbitMQ 메트릭 살펴보기 - 알림 권장 사항을 포함한 완벽한 메트릭 참조 자료

모니터링 강화:

알림 생성 - 큐 깊이 및 메시지 백로그에 대한 알림을 설정합니다.
대시보드 구축 - RabbitMQ 지표를 시각화하기 위한 맞춤형 대시보드 생성

사용자의 편의를 위해 제공되는 기계 번역입니다.

OpenTelemetry를 사용하여 자체 호스팅 RabbitMQ를 모니터링하세요.

설치 단계

시작하기 전에

RabbitMQ 요구 사항

시스템 요구 사항

뉴렐릭 요구 사항

소프트웨어 요구 사항

RabbitMQ 관리 플러그인을 활성화하세요.

OpenTelemetry Collector를 설치하세요.

수집기 구성

환경 변수 설정

뉴렐릭에서 데이터를 확인하세요

팁

(선택 사항) RabbitMQ 로그를 뉴렐릭으로 전달합니다.

중요

데이터 찾기

문제점 해결

뉴릭에 데이터가 나타나지 않습니다

연결 거부 오류

인증 실패(401 권한 없음)

메모리 또는 CPU 사용량이 높습니다.

로그에 대한 권한이 거부되었습니다.

다음 단계

사용자의 편의를 위해 제공되는 기계 번역입니다.

OpenTelemetry를 사용하여 자체 호스팅 RabbitMQ를 모니터링하세요.

설치 단계 .css-21sua1{background:none;border:none;width:0;padding:0;}

시작하기 전에

시스템 요구 사항

뉴렐릭 요구 사항

소프트웨어 요구 사항

RabbitMQ 관리 플러그인을 활성화하세요.

OpenTelemetry Collector를 설치하세요.

수집기 구성

환경 변수 설정

뉴렐릭에서 데이터를 확인하세요

팁

(선택 사항) RabbitMQ 로그를 뉴렐릭으로 전달합니다.

중요

데이터 찾기

문제점 해결

뉴릭에 데이터가 나타나지 않습니다

연결 거부 오류

인증 실패(401 권한 없음)

메모리 또는 CPU 사용량이 높습니다.

로그에 대한 권한이 거부되었습니다.

다음 단계

설치 단계