HAProxy 모니터링 통합

당사의 HAProxy 통합 은 HAProxy 인스턴스에서 New Relic 플랫폼으로 인벤토리 및 메트릭을 수집하여 전송합니다. 여기서 HAProxy 서버, 프런트엔드 및 백엔드에 대한 주요 성능 메트릭을 집계하고 시각화할 수 있습니다.

통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.

호환성 및 요구 사항

통합은 HAProxy 버전 1.3 - 2.x와 호환됩니다.

통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.

HAProxy 통계 페이지가 활성화되어 액세스할 수 있습니다.
HAProxy가 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않으면 HAProxy를 실행하는 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:
- Kubernetes에서 실행 중인 경우 다음 요구 사항 을 참조하십시오.
- ECS에서 실행하는 경우 다음 요구 사항 을 참조하십시오.

빠른 시작

HAProxy 인스턴스를 신속하게 계측하고 설치 안내를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 맞춤형 CLI 명령을 생성합니다.

시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.

안내 설치

EU 가이드 설치

가이드 설치는 인프라 에이전트를 사용하여 HAProxy 통합을 설정합니다. 뿐만 아니라 사용자 환경에서 실행 중인 다른 애플리케이션 및 로그 소스를 검색한 다음 계측해야 할 항목을 추천합니다.

안내 설치는 대부분의 설정에서 작동합니다. 그러나 요구 사항에 적합하지 않은 경우 아래에서 다른 방법을 찾아 HAProxy 인스턴스 모니터링을 시작할 수 있습니다.

설치 및 활성화

HAProxy 통합을 설치하려면 환경에 대한 지침을 따르십시오.

' '

인프라 에이전트를 설치하고 INTEGRATION_FILE_NAME 변수를 nri-haproxy 로 바꿉니다.
디렉토리를 통합 폴더로 변경하십시오.
```
cd /etc/newrelic-infra/integrations.d
```

샘플 구성 파일을 복사합니다.

sudo cp haproxy-config.yml.sample haproxy-config.yml

구성 설정 에 설명된 대로 haproxy-config.yml 파일을 편집합니다.
인프라 에이전트를 다시 시작하십시오 .

다음에서 nri-haproxy .MSI 설치 프로그램 이미지를 다운로드합니다.
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-haproxy/nri-haproxy-amd64.msi
Windows 명령 프롬프트에서 설치하려면 다음을 실행하십시오.
```
msiexec.exe /qn /i PATH\TO\nri-haproxy-amd64.msi
```
Integrations 디렉터리 C:\Program Files\New Relic\newrelic-infra\integrations.d\ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.
```
cp haproxy-config.yml.sample haproxy-config.yml
```
구성 설정 을 사용하여 haproxy-config.yml 구성 파일을 편집합니다.
인프라 에이전트를 다시 시작하십시오 .

추가 참고 사항:

고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.

이 문서가 설치하는데 도움이 되셨나요?

통합 구성

설치 방법에 따라 통합을 구성하는 여러 가지 방법이 있습니다.

Kubernetes를 통해 활성화된 경우 Kubernetes에서 실행 중인 서비스 모니터링 을 참조하세요.
Amazon ECS를 통해 활성화된 경우 ECS에서 실행 중인 서비스 모니터링 을 참조하십시오.
호스트에 설치된 경우 통합의 YAML 구성 파일 haproxy-config.yml 에서 구성을 편집합니다.

통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다.

구성 파일에는 interval , timeout , inventory_source 와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 읽으려면 구성 형식 문서를 참조하십시오.

레거시 구성/정의 파일을 계속 사용하고 있다면 온호스트 통합 표준 구성 형식 을 참조하십시오.

HAProxy와 관련된 특정 설정은 구성 파일의 env 섹션을 사용하여 정의됩니다. 이러한 설정은 HAProxy 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다.

HAProxy 인스턴스 설정

HAProxy 통합은 메트릭( M ) 및 인벤토리( I ) 정보를 모두 수집합니다. 표에서 각 컬렉션에 사용할 수 있는 설정에 대해 적용 대상 열을 사용합니다.

' ' ' ' ' ' ' ' ' '

환경	설명	기본값	적용 대상
STATS_URL	HAProxy 통계 페이지를 가리키는 URL입니다.	해당 없음	미
사용자 이름	HAProxy 연결을 위한 사용자 이름입니다.	해당 없음	미
비밀번호	지정된 사용자의 비밀번호입니다.	해당 없음	미
HA_PROXY_CLUSTER_NAME	모니터링 중인 클러스터를 고유하게 식별하기 위한 사용자 정의 이름입니다. 필수 .	해당 없음	미
측정항목	측정항목 전용 수집을 활성화하려면 `true` 으로 설정합니다.	잘못된
목록	인벤토리 전용 컬렉션을 활성화하려면 `true` 으로 설정합니다.	잘못된

이러한 설정의 값은 다음과 같은 방식으로 정의할 수 있습니다.

구성 파일에 직접 값을 추가합니다.
{{}} 표기법을 사용하여 환경 변수의 값을 바꿉니다. 이를 위해서는 인프라 에이전트 버전 1.14.0 이상이 필요합니다. 자세한 내용은 여기를 참조하거나 아래 예를 참조하십시오.
비밀 관리를 사용하여 암호와 같은 민감한 정보가 구성 파일의 일반 텍스트로 노출되지 않도록 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.

라벨/맞춤 속성

레이블을 사용하여 측정항목을 꾸밀 수도 있습니다. 레이블을 사용하면 메트릭에 키/값 쌍 속성을 추가할 수 있습니다. 레이블을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.

기본 샘플 구성 파일에는 레이블의 예가 포함되어 있지만 원하는 새 레이블을 제거, 수정 또는 추가할 수 있습니다.

labels:
   env: production
   role: load_balancer

구성 예

다음은 로컬 호스트에서 지표 및 인벤토리를 수집하기 위한 기본 구성입니다.

integrations:
  - name: nri-haproxy
    env:
      STATS_URL: http://haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster
    interval: 15s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/haproxy

이 구성은 환경 변수 HAPROXY_STATS 를 사용하여 통합의 STATS_URL 설정을 채웁니다.

integrations:
  - name: nri-haproxy
    env:
      METRICS: "true"
      STATS_URL: {{HAPROXY_STATUS}}
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성은 동일한 통합에서 여러 HAProxy 서버를 모니터링합니다. 첫 번째 인스턴스( STATUS_URL: https://1st_haproxy-instance/stats )는 측정항목과 인벤토리를 수집하고 두 번째 인스턴스( STATUS_URL: https://2nd_haproxy-instance/stats )는 측정항목만 수집합니다.

integrations:
  - name: nri-haproxy
    env:
      METRICS: "true"
      STATS_URL: http://1st_haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster1
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-haproxy
    env:
      INVENTORY: "true"
      STATS_URL: http://1st_haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster1
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/haproxy

  - name: nri-haproxy
    env:
      METRICS: "true"
      STATS_URL: http://2nd_haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster2
    interval: 15s
    labels:
      env: production
      role: load_balancer

데이터 찾기 및 사용

이 통합의 데이터는 전용 New Relic 대시보드 에 보고됩니다.

메트릭은 다음 이벤트 유형 에 연결됩니다.

HAProxyBackendSample
HAProxyFrontendSample
HAProxyServerSample

문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.

데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

측정항목 데이터

HAProxy 통합은 다음 메트릭 데이터 속성을 수집합니다. 각 측정항목 이름에는 backend. , frontend. 또는 server. 와 같은 카테고리 표시기와 마침표가 접두사로 붙습니다.

HAProxy 백엔드 샘플 측정항목

다음 속성은 HAProxyBackendSample 이벤트 유형에 연결됩니다.

미터법	설명
`backend.activeServers`	활성 서버의 수입니다.
`backend.averageConnectTimeInSeconds`	1024개의 마지막 요청에 대한 평균 연결 시간(밀리초)입니다.
`backend.averageQueueTimeInSeconds`	1024개의 마지막 요청에 대한 평균 대기열 시간(밀리초)입니다.
`backend.averageResponseTimeInSeconds`	1024개의 마지막 요청에 대한 평균 응답 시간(밀리초)입니다.
`backend.averageTotalSessionTimeInSeconds`	1024개의 마지막 요청에 대한 평균 총 세션 시간(밀리초)입니다.
`backend.backupServers`	백업 서버의 수입니다.
`backend.bytesInPerSecond`	초당 수신된 바이트입니다.
`backend.bytesOutPerSecond`	초당 전송된 바이트입니다.
`backend.bytesThatBypassedCompressorPerSecond`	초당 HTTP 압축기를 우회한 바이트 수입니다.
`backend.connectingRequestErrorsPerSecond`	초당 백엔드 서버에 연결하는 동안 오류가 발생한 요청 수입니다.
`backend.connectionRetriesPerSecond`	초당 서버 연결을 재시도한 횟수입니다.
`backend.cookieName`	쿠키의 이름입니다.
`backend.currentQueuedRequestsWithoutServer`	서버가 할당되지 않은 현재 대기 중인 요청입니다.
`backend.currentSessions`	현재 세션 수입니다.
`backend.dataTransfersAbortedByClientPerSecond`	초당 클라이언트가 중단한 데이터 전송 수입니다.
`backend.dataTransfersAbortedByServerPerSecond`	초당 서버에서 중단된 데이터 전송 수입니다.
`backend.downtimeInSeconds`	총 다운타임(초)입니다.
`backend.http100ResponsesPerSecond`	초당 1xx 코드의 HTTP 응답.
`backend.http200ResponsesPerSecond`	초당 2xx 코드의 HTTP 응답.
`backend.http300ResponsesPerSecond`	초당 3xx 코드의 HTTP 응답.
`backend.http400ResponsesPerSecond`	초당 4xx 코드의 HTTP 응답.
`backend.http500ResponsesPerSecond`	초당 5xx 코드의 HTTP 응답.
`backend.httpOtherResponsesPerSecond`	초당 다른 코드(프로토콜 오류)가 있는 HTTP 응답.
`backend.httpRequestsPerSecond`	초당 HTTP 요청.
`backend.httpResponseBytesEmittedByCompressorPerSecond`	압축기에서 초당 내보낸 HTTP 응답 바이트 수입니다.
`backend.httpResponseBytesFedToCompressorPerSecond`	초당 압축기에 공급되는 HTTP 응답 바이트 수입니다.
`backend.httpResponsesCompressedPerSecond`	초당 압축된 HTTP 응답 수입니다.
`backend.interceptedRequestsPerSecond`	차단된 초당 요청 수입니다.
`backend.maxQueuedRequestsWithoutServer`	서버가 할당되지 않은 최대 대기열 요청입니다.
`backend.maxSessions`	최대 세션 수입니다.
`backend.maxSessionsPerSecond`	초당 최대 새 세션 수입니다.
`backend.mode`	프록시 모드. 옵션: tcp, http, health, unknown.
`backend.proxyName`	프록시의 이름입니다.
`backend.requestRedispatchPerSecond`	요청이 초당 다른 서버로 재전송된 횟수입니다.
`backend.requestsDenied.securityConcernPerSecond`	초당 요청 거부된 bytcp-request 연결 규칙입니다.
`backend.responseErrorsPerSecond`	초당 응답 오류입니다.
`backend.responsesDenied.securityConcernPerSecond`	거부된 요청은 초당 bytcp-request 세션 규칙입니다.
`backend.serverSelectedPerSecond`	새 세션을 위해 또는 다시 디스패치할 때 초당 서버가 선택된 횟수입니다.
`backend.sessionsPerSecond`	초당 생성된 세션입니다.
`backend.status`	상태. 옵션: UP, DOWN, NOLB, MAINT, MAINT(경유), MAINT(분해능).
`backend.timeSinceLastSessionAssignedInSeconds`	백엔드에 할당된 마지막 세션 이후 경과된 시간(초)입니다.
`backend.timeSinceLastUpDownTransitionInSeconds`	마지막 UP<->DOWN 전환 이후 경과된 시간(초)입니다.
`backend.totalWeight`	백엔드의 총 중량입니다.
`backend.type`	백엔드 유형입니다. `0` = 프런트엔드, `1` = 백엔드, `2` = 서버, `3` = 소켓/리스너.
`backend.upToDownTransitionsPerSecond`	초당 UP->DOWN 전환 수입니다.

HAProxy 프런트엔드 샘플 측정항목

다음 속성은 HAProxyFrontendSample 이벤트 유형에 연결됩니다.

미터법	설명
`frontend.bytesInPerSecond`	초당 수신된 바이트 수입니다.
`frontend.bytesOutPerSecond`	초당 보낸 바이트 수입니다.
`frontend.connectionsPerSecond`	초당 연결 수입니다.
`frontend.currentSessions`	현재 세션 수입니다.
`frontend.http100ResponsesPerSecond`	초당 1xx 코드의 HTTP 응답.
`frontend.http200ResponsesPerSecond`	초당 2xx 코드의 HTTP 응답.
`frontend.http300ResponsesPerSecond`	초당 3xx 코드의 HTTP 응답.
`frontend.http400ResponsesPerSecond`	초당 4xx 코드의 HTTP 응답.
`frontend.http500ResponsesPerSecond`	초당 5xx 코드의 HTTP 응답.
`frontend.httpOtherResponsesPerSecond`	다른 코드가 포함된 HTTP 응답(프로토콜 오류).
`frontend.httpRequests.maxPerSecond`	관찰된 초당 최대 HTTP 요청 수입니다.
`frontend.httpRequestsPerSecond`	초당 HTTP 요청.
`frontend.interceptedRequestsPerSecond`	차단된 초당 요청 수입니다.
`frontend.maxConnectionsPerSecond`	최대 연결 수.
`frontend.maxSessions`	최대 세션 수입니다.
`frontend.maxSessionsPerSecond`	초당 최대 새 세션 수입니다.
`frontend.mode`	프록시 모드. tcp, http, health, unknown 중 하나입니다.
`frontend.proxyName`	프록시의 이름입니다.
`frontend.requestErrors`	초당 요청 오류입니다.
`frontend.requestsDenied.securityConcernsPerSecond`	초당 보안 문제로 인해 요청이 거부되었습니다.
`frontend.requestsDenied.tcpRequestConnectionRulesPerSecond`	초당 요청 거부된 bytcp-request 연결 규칙입니다.
`frontend.requestsDenied.tcpRequestSessionRulesPerSecond`	거부된 요청은 초당 bytcp-request 세션 규칙입니다.
`frontend.responsesDenied.securityConcernsPerSecond`	초당 보안 문제로 인해 응답이 거부되었습니다.
`frontend.serviceName`	서비스의 이름입니다.
`frontend.sessionsPerSecond`	초당 생성된 세션입니다.
`frontend.status`	프런트엔드의 상태입니다. 옵션: UP, DOWN, NOLB, MAINT, MAINT(경유), MAINT(분해능).
`frontend.type`	프론트엔드의 유형. `0` = 프런트엔드, `1` = 백엔드, `2` = 서버, `3` = 소켓/리스너.

HAProxy 서버 샘플 메트릭

다음 속성은 HAProxyServerSample 이벤트 유형에 연결됩니다.

미터법	설명
`server.agentCheckContents`	마지막 에이전트 확인 내용 또는 텍스트 오류입니다.
`server.agentDurationInSeconds`	마지막 확인을 완료하는 데 걸린 시간(밀리초)입니다.
`server.agentStatus`	에이전트의 상태입니다.
`server.agentStatusDescription`	사람이 읽을 수 있는 `agent_status` 에 대한 짧은 설명입니다.
`server.averageConnectTimeInSeconds`	1024개의 마지막 요청에 대한 평균 연결 시간(밀리초)입니다.
`server.averageQueueTimeInSeconds`	1024개의 마지막 요청에 대한 평균 대기열 시간(밀리초)입니다.
`server.averageResponseTimeInSeconds`	1024개의 마지막 요청에 대한 평균 응답 시간(밀리초)입니다.
`server.averageTotalSessionTimeInSeconds`	1024개의 마지막 요청에 대한 평균 총 세션 시간(밀리초)입니다.
`server.bytesInPerSecond`	초당 수신된 바이트입니다.
`server.bytesOutPerSecond`	초당 전송된 바이트입니다.
`server.checkStatusDescription`	사람이 읽을 수 있는 `check_status` 에 대한 짧은 설명입니다.
`server.connectingToBackendRequestErrorsPerSecond`	초당 백엔드 서버에 연결하는 동안 오류가 발생한 요청 수입니다.
`server.connectionRetriesPerSecond`	초당 서버 연결을 재시도한 횟수입니다.
`server.cookieValue`	서버의 쿠키 값입니다.
`server.currentSessions`	현재 세션 수입니다.
`server.dataTransfersAbortedByClientPerSecond`	초당 클라이언트가 중단한 데이터 전송 수입니다.
`server.dataTransfersAbortedByServerPerSecond`	초당 서버에서 중단된 데이터 전송 수입니다.
`server.downtimeInSeconds`	총 다운타임(초)입니다.
`server.failedChecksPerSecond`	초당 실패한 검사 수입니다.
`server.failedHealthCheckDetails`	상태 확인 세부정보에 실패했습니다.
`server.healthCheckContents`	마지막 상태 확인 내용 또는 텍스트 오류입니다.
`server.healthCheckDurationInMilliseconds`	마지막 상태 확인을 완료하는 데 걸린 시간(밀리초)입니다.
`server.healthCheckStatus`	상태 확인 상태입니다.
`server.http100ResponsesPerSecond`	초당 1xx 코드의 HTTP 응답.
`server.http200ResponsesPerSecond`	초당 2xx 코드의 HTTP 응답.
`server.http300ResponsesPerSecond`	초당 3xx 코드의 HTTP 응답.
`server.http400ResponsesPerSecond`	초당 4xx 코드의 HTTP 응답.
`server.http500ResponsesPerSecond`	초당 5xx 코드의 HTTP 응답.
`server.httpOtherResponsesPerSecond`	다른 코드가 포함된 HTTP 응답(프로토콜 오류).
`server.isActive`	서버가 활성 상태인지 여부입니다. `0` = 비활성, `1` = 활성.
`server.isBackup`	서버가 백업인지 여부. `0` = 백업 아님, `1` = 백업.
`server.layerCode`	가능한 경우 레이어 5-7 코드.
`server.maximumQueuedRequests`	최대 대기 요청 수.
`server.maxSessions`	최대 세션 수입니다.
`server.maxSessionsPerSecond`	초당 최대 세션 수.
`server.mode`	프록시 모드. tcp, http, health, unknown 중 하나입니다.
`server.proxyName`	프록시의 이름입니다.
`server.queuedRequests`	현재 대기 중인 요청입니다.
`server.requestRedispatchPerSecond`	요청이 초당 다른 서버로 재전송된 횟수입니다.
`server.requestsDenied.securityConcernPerSecond`	초당 보안 문제로 인해 요청이 거부되었습니다.
`server.responseErrorsPerSecond`	초당 응답 오류입니다.
`server.responsesDenied.securityConcernPerSecond`	초당 보안 문제로 인해 응답이 거부되었습니다.
`server.serverID`	서버 ID입니다.
`server.serverSelectedPerSecond`	새 세션을 위해 또는 다시 디스패치할 때 초당 서버가 선택된 횟수입니다.
`server.serverWeight`	서버 무게.
`server.serviceName`	서비스의 이름입니다.
`server.sessionsPerSecond`	초당 세션.
`server.status`	서버의 상태입니다. 옵션: UP, DOWN, NOLB, MAINT, MAINT(경유), MAINT(분해능).
`server.throttlePercentage`	느린 시작이 활성화된 경우 서버의 스로틀 백분율입니다. 또는 느린 시작이 아니면 값이 없습니다.
`server.timeSinceLastSessionAssignedInSeconds`	백엔드에 할당된 마지막 세션 이후 경과된 시간(초)입니다.
`server.timeSinceLastUpDownTransitionInSeconds`	마지막 UP<->DOWN 전환 이후 경과된 시간(초)입니다.
`server.type`	서버 유형입니다. `0` = 프런트엔드, `1` = 백엔드, `2` = 서버, `3` = 소켓/리스너.
`server.upToDownTransitionsPerSecond`	초당 UP->DOWN 전환 수입니다.

인벤토리 데이터

HAProxy 통합은 HAProxy 인스턴스의 구성 매개변수를 캡처합니다. 데이터는 config/haproxy 소스 아래의 인프라 인벤토리 페이지 에서 사용할 수 있습니다. 인벤토리 데이터에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

통합은 다음 구성 매개변수에 대한 데이터를 캡처합니다.

백엔드 인벤토리

이름	설명
`iid`	백엔드 프록시 ID입니다.
`pid`	백엔드 프로세스 ID입니다.
`slim`	백엔드 세션 제한입니다.

프런트엔드 인벤토리

이름	설명
`iid`	프런트엔드 프록시 ID입니다.
`pid`	프론트엔드 프로세스 ID입니다.
`rate_lim`	초당 새 세션 제한.
`slim`	프런트엔드 세션 제한입니다.

서버 인벤토리

이름	설명
`iid`	백엔드 프록시 ID입니다.
`pid`	서버 프로세스 ID입니다.
`qmax`	구성된 최대 대기열입니다. `0` = 제한 없음.
`sid`	서버 ID입니다.
`slim`	서버 세션 제한.

소스 코드 확인

이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.