Apache 모니터링 통합

Apache 통합은 Apache 웹 서버에서 New Relic 플랫폼으로 데이터를 보고합니다. Apache 메트릭 데이터의 대시보드를 보고, 경고 정책을 생성하고, 고유한 사용자 지정 쿼리 및 차트를 생성할 수 있습니다.

호환성 및 요구 사항

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

New Relic 계정. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
아파치 버전 2.2 및 2.4
Apache 인스턴스에 대해 활성화되고 구성된 Apache 상태 모듈 입니다.
Apache 통합이 포함된 호스트에서 사용할 수 있는 Apache 상태 모듈 엔드포인트(기본값 server-status )

빠른 시작

Kubernetes 또는 ECS 환경에서 Apache를 실행하지 않는 경우 가이드 설치를 권장합니다. 가이드 설치는 인프라 에이전트와 CLI를 사용하여 Apache 통합을 설정하고 환경에서 실행 중인 다른 애플리케이션과 로그 소스를 검색한 다음 계측해야 할 항목을 권장합니다.

가이드 설치는 대부분의 설정에서 작동합니다. 그러나 필요에 맞지 않으면 아래에 다른 설치 옵션이 있습니다.

시작할 준비가 되셨습니까? 사용하는 데이터 센터 지역 에 따라 관련 버튼을 클릭합니다. 설치가 완료되면 이 설명서로 돌아와서 구성 옵션을 검토하십시오.

안내 설치, 미국 지역

가이드 설치, EU 지역

설치

가이드 설치를 사용하지 않는 경우 환경에 대한 지침을 따르십시오.

통합 업데이트

이 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으려면 통합 패키지 와 인프라 에이전트를 정기적으로 업데이트하십시오.

설치 후 작업

설치가 완료되면 구성 옵션을 설정할 수 있습니다. 통합이 작동하려면 일부 구성이 필요하고 일부는 선택 사항입니다.

Apache 서버 활성화

Apache 통합에서 데이터를 캡처하려면 다음을 수행해야 합니다.

Apache 상태 모듈 이 Apache 인스턴스에 대해 활성화되고 구성되었는지 확인합니다.
Apache 통합이 포함된 호스트에서 Apache 상태 모듈 엔드포인트(기본값 server-status )를 사용할 수 있는지 확인합니다.

통합 구성

ECS 또는 Kubernetes 통합을 통해 이 통합을 활성화한 경우 해당 문서를 참조하십시오.

표준 온호스트 설치의 경우 이 통합은 YAML 구성 파일 apache-config.yml 과 함께 제공됩니다. 이 구성에서 필요한 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있습니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다. 복사 및 편집할 수 있는 샘플 구성 파일 apache-config.yml.sample 과 함께 제공됩니다.

구성 팁:

통합 디렉터리 C:\Program Files\New Relic\newrelic-infra\integrations.d\ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.

cp apache-config.yml.sample apache-config.yml

그런 다음 구성 기본 설정 에 따라 편집합니다.

자동 Apache 및 Apache 오류 로그 구문 분석 및 전달을 활성화하려면 apache-log-win.yml.example 파일을 apache-log-win.yml 로 복사하거나 이름을 바꿉니다. 에이전트를 다시 시작할 필요는 없지만 Apache 로그 파일의 기본 위치를 사용하지 않는 경우 YML 파일을 해당 위치로 업데이트해야 할 수 있습니다.

통합 디렉터리 /etc/newrelic-infra/integrations.d/ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.

sudo cp apache-config.yml.sample apache-config.yml

그런 다음 구성 기본 설정 에 따라 편집합니다.

자동 Apache 및 Apache 오류 로그 구문 분석 및 전달을 활성화하려면 apache-log.yml.example 파일을 복사하거나 이름을 apache-log.yml 로 바꾸세요. 에이전트를 다시 시작할 필요는 없지만 Apache 로그 파일의 기본 위치를 사용하지 않는 경우 YML 파일을 해당 위치로 업데이트해야 할 수 있습니다.

예를 들어:

bash

$sudo cp /etc/newrelic-infra/logging.d/apache-log.yml.example /etc/newrelic-infra/logging.d/apache-log.yml

구성 파일에는 이 통합과 기타 New Relic 온호스트 통합에 적용할 수 있는 공통 설정(예: interval, timeout, inventory_source 이 있습니다. 이러한 공통 설정에 대해 알아보려면 온호스트 구성 형식을 참조하십시오.

Apache와 관련된 특정 설정은 구성 파일의 env 섹션을 사용하여 정의됩니다. 이러한 설정은 Apache 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다. 유효한 설정 목록은 이 문서의 다음 섹션에 설명되어 있습니다.

또한 예제 구성 파일 도 있습니다.

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

아파치 구성 옵션

Apache 통합은 메트릭과 인벤토리 정보를 모두 수집합니다. 이 표는 각 구성 옵션이 적용되는 항목을 보여줍니다.

' ' ' ' ' ' ' ' ' ' ' ' ' '

환경	설명	기본값	에 적용
STATUS_URL	상태 모듈을 사용하여 메트릭을 제공하도록 설정된 URL입니다.	http://127.0.0.1/server-status?자동	측정항목, 인벤토리
BINARY_PATH	Apache 바이너리 파일의 위치를 설정합니다.	해당 없음	목록
CA_BUNDLE_FILE	대체 인증 기관 번들 파일.	해당 없음	메트릭
CA_BUNDLE_DIR	대체 인증 기관 번들 디렉토리.	해당 없음	메트릭
VALIDATE_CERTS	상태 URL이 자체 서명된 인증서가 있는 HTTPS인 경우 `false` 으로 설정합니다.	진정한	메트릭
원격 모니터링	다중 테넌시 모니터링을 활성화합니다.	진정한	측정항목, 인벤토리
측정항목	측정항목 전용 수집을 활성화하려면 `true` 으로 설정합니다.	잘못된
목록	인벤토리 전용 컬렉션을 활성화하려면 `true` 으로 설정합니다.	잘못된

이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.

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

라벨

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

기본 샘플 구성 파일에는 레이블의 예가 포함되어 있지만 필수가 아니므로 선택한 레이블을 제거, 수정 또는 추가할 수 있습니다.

labels:
   env: production
   role: load_balancer

구성 예

다음은 몇 가지 YAML 구성의 예입니다.

이것은 localhost에서 메트릭과 인벤토리를 수집하는 매우 기본적인 구성입니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

이 구성은 기본 인증으로 보호되는 로컬 호스트에서 메트릭과 인벤토리를 수집합니다. STATUS_URL의 username 및 password 을 사용자 인증 정보로 바꿉니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://username:password@127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: http://username:password@127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

기본적으로 통합은 /usr/sbin/httpd 및 /usr/sbin/apache2ctl 2개의 다른 위치에서 Apache 바이너리를 감지하려고 시도합니다.
Apache가 사용자 지정 위치에 설치되어 있거나 MS Windows를 사용하는 경우 BINARY_PATH 설정을 사용하여 Apache 바이너리의 올바른 위치와 파일 이름을 지정합니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: http://127.0.0.1/server-status?auto
      BINARY_PATH: 'C:\Apache\bin\httpd.exe'
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

이 구성에서는 측정항목만 수집하는 METRICS: true 이 있는 통합 블록이 하나만 있으며 자체 서명된 인증서를 사용할 때 서버의 SSL 인증서 유효성 검사를 방지하기 위해 VALIDATE_CERTS: false 을 추가했습니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: https://my_apache_host/server-status?auto
      VALIDATE_CERTS: false
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성에서는 측정항목만 수집하고 대체 인증서 파일을 가리키는 CA_BUNDLE_FILE 를 추가하기 위해 METRICS: true 이 있는 통합 블록이 하나만 있습니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: https://my_apache_host/server-status?auto
      CA_BUNDLE_FILE='/etc/ssl/certs/custom-ca.crt'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성에서는 환경 변수 APACHE_STATUS 를 사용하여 통합의 STATUS_URL 설정을 채웁니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: {{APACHE_STATUS}}
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

이 구성에서는 동일한 통합에서 여러 Apache 서버를 모니터링합니다. 첫 번째 인스턴스( STATUS_URL: https://1st_apache_host/server-status?auto )의 경우 측정항목과 인벤토리를 수집하는 반면 두 번째 인스턴스( STATUS_URL: https://2nd_apache_host/server-status?auto )의 경우 측정항목만 수집합니다.

integrations:
  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: https://1st_apache_host/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-apache
    env:
      INVENTORY: "true"
      STATUS_URL: https://1st_apache_host/server-status?auto
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/apache

  - name: nri-apache
    env:
      METRICS: "true"
      STATUS_URL: http://2nd_apache_host/server-status?auto
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      env: production
      role: load_balancer

데이터 찾기 및 사용

이 통합의 데이터는 one.newrelic.com > Infrastructure > Third-party services > Apache 로 이동하여 찾을 수 있습니다.

Apache 데이터는 ApacheSample 이벤트 유형 에 연결됩니다. 문제 해결을 위해 또는 사용자 지정 차트 및 대시보드를 생성하기 위해 이 데이터를 쿼리 할 수 있습니다.

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

측정항목 데이터

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

이름	설명
`net.bytesPerSecond`	제공된 바이트 수의 비율(초당 바이트)입니다.
`net.requestsPerSecond`	클라이언트 요청 수의 비율(초당 요청 수)입니다.
`server.busyWorkers`	현재 바쁜 작업자 수입니다.
`server.idleWorkers`	현재 유휴 작업자 수입니다.
`server.scoreboard.closingWorkers`	응답을 제공한 후 TCP 연결을 닫는 작업자의 현재 수입니다.
`server.scoreboard.dnsLookupWorkers`	DNS 조회를 수행하는 현재 작업자 수입니다.
`server.scoreboard.finishingWorkers`	현재 작업자 수를 정상적으로 완료하고 있습니다.
`server.scoreboard.idleCleanupWorkers`	정리할 준비가 된 유휴 작업자의 현재 수입니다.
`server.scoreboard.keepAliveWorkers`	연결 유지 연결을 유지하는 현재 작업자 수입니다.
`server.scoreboard.loggingWorkers`	현재 로깅 중인 작업자 수입니다.
`server.scoreboard.readingWorkers`	요청을 읽는 현재 작업자 수(헤더 또는 본문).
`server.scoreboard.startingWorkers`	현재 시작 중인 작업자 수입니다.
`server.scoreboard.totalWorkers`	사용 가능한 총 작업자 수입니다. 요청을 처리하는 데 필요하지 않은 작업자는 시작되지 않을 수 있습니다.
`server.scoreboard.writingWorkers`	현재 작성 중인 작업자 수입니다.

인벤토리 데이터

인벤토리 데이터는 실행 중인 Apache 및 로드된 모든 Apache 모듈의 버전 번호를 캡처하고 config/apache 네임스페이스 아래에 해당 버전 번호를 추가합니다. 인벤토리 데이터에 대한 자세한 내용은 데이터 이해 를 참조하십시오.

시스템 메타데이터

인프라 에이전트에서 수집한 표준 속성 외에도 통합은 ApacheSample 이벤트 유형 과 연결된 인벤토리 데이터를 수집합니다.

이름	설명
`software.version`	Apache 서버의 버전입니다. 예: `Apache/2.4.7 (Ubuntu)` .

문제점 해결

Apache용 HTTPS 끝점에 액세스하는 데 문제가 있는 경우 다음 두 가지 가능한 솔루션이 있습니다.

SSL 인증을 무시할 수는 없지만 Apache 구성 파일의 서명되지 않은 인증서를 가리키도록 구성 파일 매개변수 ca_bundle_file 및 ca_bundle_dir 을 설정할 수 있습니다. 예시:

instances:
    - name: apache-server-metrics
command: metrics
arguments:
    status_url: http://127.0.0.1/server-status?auto
    ca_bundle_file: /etc/newrelic-infra/integrations.d/ssl/b2b.ca-bundle

ca_bundle_dir 사용 예:

ca_bundle_dir: /etc/newrelic-infra/integrations.d/ssl

또는 HTTPS 대신 HTTP를 사용할 수 있습니다.

소스 코드 확인

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

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

호환성 및 요구 사항

빠른 시작

설치

VM 또는 온프레미스 호스트에 설치

ECS를 통해 설치

Kubernetes를 통해 설치

통합 업데이트

설치 후 작업

Apache 서버 활성화

통합 구성

윈도우 구성

리눅스 구성

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

아파치 구성 옵션

라벨

구성 예

기본 구성

HTTP 기본 인증

사용자 정의 Apache 바이너리 위치

자체 서명된 인증서만 있는 메트릭

대체 인증서가 있는 메트릭만

환경 변수 교체