Apache 모니터링 통합

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

통합은 Apache의 상태 모듈 에서 데이터를 수집하여 작동하므로 해당 모듈은 Apache 인스턴스에 대해 활성화되고 구성되어야 합니다(자세한 내용은 요구 사항 참조).

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

호환성 및 요구 사항

통합은 Apache 버전 2.2 또는 2.4와 호환됩니다.

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

New Relic 계정. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
Apache 인스턴스에 대해 활성화되고 구성된 Apache 상태 모듈 입니다.
Apache 통합이 포함된 호스트에서 사용할 수 있는 Apache 상태 모듈 엔드포인트(기본값 server-status )
Apache가 Kubernetes 또는 Amazon ECS에서 실행 되지 않는 경우 Apache를 실행하는 Linux OS 호스트에 인프라 에이전트가 설치되어 있어야 합니다. 그렇지 않으면:
- Kubernetes에서 실행 중인 경우 다음 요구 사항 을 참조하십시오.
- ECS에서 실행하는 경우 다음 요구 사항 을 참조하십시오.

빠른 시작

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

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

안내 설치

EU 가이드 설치

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

안내 설치는 대부분의 설정에서 작동합니다. 그러나 귀하의 요구 사항에 적합하지 않은 경우 Apache 웹 서버 모니터링을 시작하기 위해 아래에서 다른 방법을 찾을 수 있습니다.

설치 및 활성화

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

' '

파일 이름 nri-apache 을(를) 사용하여 통합 설치 지침을 따르십시오.
디렉토리를 통합 폴더로 변경합니다.
```
cd /etc/newrelic-infra/integrations.d
```

샘플 구성 파일의 사본:

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

구성 설정 에 설명된 대로 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
```

다음에서 nri-apache .MSI 설치 프로그램 이미지를 다운로드합니다.
http://download.newrelic.com/infrastructure_agent/windows/integrations/nri-apache/nri-apache-amd64.msi

Windows 명령 프롬프트에서 설치하려면 다음을 실행하십시오.

msiexec.exe /qn /i PATH\TO\nri-apache-amd64.msi

Integrations 디렉터리 C:\Program Files\New Relic\newrelic-infra\integrations.d\ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.
```
cp apache-config.yml.sample apache-config.yml
```
구성 설정 을 사용하여 apache-config.yml 구성 파일을 편집합니다.
인프라 에이전트를 다시 시작하십시오 .

추가 참고 사항:

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

구성

Apache 서버 활성화

Apache 통합에서 데이터를 캡처하려면 먼저 상태 모듈을 활성화하고 구성해야 합니다.

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

통합 구성

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

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

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

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

중요

레거시 구성/정의 파일을 계속 사용하고 있다면 이 문서 에서 도움을 받으십시오.

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

Apache 인스턴스 설정

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

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

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

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

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

라벨/맞춤 속성

레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키/값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 샘플 구성 파일에는 레이블의 예가 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.

labels:
   env: production
   role: load_balancer

구성 예

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

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

데이터 찾기 및 사용

이 서비스의 데이터는 통합 대시보드 에 보고됩니다.

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를 사용할 수 있습니다.

소스 코드 확인

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

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

호환성 및 요구 사항

빠른 시작

설치 및 활성화

ECS

Kubernetes

Linux

윈도우

구성

Apache 서버 활성화

통합 구성

중요

Apache 인스턴스 설정

라벨/맞춤 속성

구성 예

기본 구성

HTTP 기본 인증

커스텀 아파치 바이너리 위치

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

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

환경 변수 교체