RabbitMQ

RabbitMQ 통합은 전송, 게시, 삭제된 메시지 수와 같은 메시지 측정항목을 수집합니다. 또한 통합은 RabbitMQ 로그를 수집하고 이를 JSON 페이로드로 파싱합니다. 결과에는 프로세스 ID, 수준, 메시지가 포함됩니다.

RabbitMQ에 대한 자세한 내용은 rabbitmq.com/을 참조하세요.

기본 요건

RabbitMQ 로그 및 측정항목을 수집하고 처리하려면 작업 에이전트 버전 2.12.0 이상을 설치해야 합니다.

이 수신자는 RabbitMQ 버전 3.8 및 3.9를 지원합니다.

시작하기 안내에 따라 RabbitMQ 관리 플러그인을 사용 설정해야 합니다.

monitoring 태그로 사용자를 구성해야 합니다.

RabbitMQ용 작업 에이전트 구성

작업 에이전트 구성 가이드에 따라 RabbitMQ 인스턴스에서 측정항목을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 RabbitMQ에 대한 측정항목을 수집 및 처리하기 위한 구성 파일을 생성하고 Linux에서 작업 에이전트를 다시 시작합니다.

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    rabbitmq:
      type: rabbitmq
  service:
    pipelines:
      rabbitmq:
        receivers:
        - rabbitmq
metrics:
  receivers:
    rabbitmq:
      type: rabbitmq
      password: pwd
      username: usr
  service:
    pipelines:
      rabbitmq:
        receivers:
          - rabbitmq
EOF
sudo service google-cloud-ops-agent restart

사용자 이름과 비밀번호를 사용하여 TCP 연결을 통해 RabbitMQ 인스턴스에 연결하려면 측정항목 수신자에 사용자 이름과 비밀번호를 지정합니다. 예를 들면 다음과 같습니다.

metrics:
  receivers:
    rabbitmq:
      type: rabbitmq
      password: pwd
      username: usr
      insecure: false
      insecure_skip_verify: false
      cert_file: /path/to/cert
      ca_file: /path/to/ca
  service:
    pipelines:
      rabbitmq:
        receivers:
          - rabbitmq

로그 수집 구성

RabbitMQ에서 로그를 수집하려면 RabbitMQ로 생성되는 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다. rabbitmq 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`type`		값은 `rabbitmq`여야 합니다.
`include_paths`	`[/var/log/rabbitmq/rabbit*.log]`	각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(``)를 경로에 사용할 수 있습니다(예: `/var/log/rabbitmq/.log`).
`exclude_paths`	`[]`	`include_paths` 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
`wildcard_refresh_interval`	`60s`	`include_paths`의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: `30s` 또는 `2m`)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

로깅되는 내용

rabbitmq 로그의 logName은 구성에 지정된 수신자 ID에서 파생됩니다. LogEntry 내의 자세한 필드는 다음과 같습니다.

필드	유형	설명
`jsonPayload.process_id`	문자열	로그를 발급하는 프로세스 ID입니다.
`jsonPayload.message`	문자열	로그 메시지입니다.
`severity`	문자열(`LogSeverity`)	로그 항목 수준입니다(번역됨).
`timestamp`	문자열(`Timestamp`)	항목이 로깅된 시간입니다.

측정항목 수집 구성

RabbitMQ에서 측정항목을 수집하려면 RabbitMQ 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다. RabbitMQ 측정항목에 대해 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`type`		값은 `rabbitmq`여야 합니다.
`endpoint`	`http://localhost:15672`	모니터링할 노드의 URL입니다.
`collection_interval`	`60s`	time.Duration 값(예: `30s` 또는 `5m`)입니다.
`username`		서버를 연결하는 데 사용되는 비밀번호입니다.
`password`		서버 연결에 사용되는 비밀번호입니다.
`insecure`	`true`	보안 TLS 연결을 사용할지 여부를 설정합니다. `false`로 설정하면 TLS가 사용 설정됩니다.
`insecure_skip_verify`		인증서 확인을 건너뛸지 여부를 설정합니다. `insecure`이 `true`로 설정된 경우 `insecure_skip_verify` 값이 사용되지 않습니다.
`cert_file`		TLS 필수 연결에 사용할 TLS 인증서의 경로입니다.
`key_file`		TLS 필수 연결에 사용할 TLS 키의 경로입니다.
`ca_file`		CA 인증서의 경로입니다. 클라이언트로서 서버 인증서를 확인합니다. 비어있으면 수신자는 시스템 루트 CA를 사용합니다.

모니터링 대상

다음 표에서는 작업 에이전트가 RabbitMQ 인스턴스에서 수집하는 측정항목의 목록을 보여줍니다.

측정항목 유형
종류, 유형 모니터링 리소스	라벨
`workload.googleapis.com/rabbitmq.consumer.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/rabbitmq.message.current`
`GAUGE`, `INT64` gce_instance	`state`

샘플 대시보드

샘플 Cloud Monitoring 대시보드를 사용하여 이 통합의 측정항목을 확인할 수 있습니다. 샘플 대시보드 설치 절차를 완료하여 샘플 라이브러리에서 RabbitMQ GCE 개요 대시보드를 가져오고 RabbitMQ 측정항목을 표시하는 차트를 확인하세요.

구성 확인

로그 탐색기와 측정항목 탐색기를 사용하여 RabbitMQ 수신자가 올바르게 구성됐는지 확인할 수 있습니다. 작업 에이전트가 로그 및 측정항목 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 RabbitMQ 로그를 봅니다.

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/rabbitmq")

측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.

fetch gce_instance
| metric 'workload.googleapis.com/rabbitmq.message.delivered'
| align rate(1m)
| every 1m

다음 단계

Ansible을 사용하여 작업 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 작업 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.