Apache 웹 서버(httpd)

Apache 웹 서버(httpd)는 다양한 운영체제에서 널리 사용되는 웹 서버입니다. 자세한 내용을 보려면 http://httpd.apache.org/를 방문하세요.

기본 요건

Apache 웹 서버 원격 분석을 수집하려면 작업 에이전트 2.7.0 이상을 설치해야 합니다.

이 수신자는 Apache 웹 서버 버전 2.4를 지원합니다.

Apache 웹 서버 인스턴스 구성

Apache 웹 서버에서 원격 분석을 수집하려면 mod_status 플러그인을 활성화하도록 서버의 httpd.conf 파일을 구성해야 합니다.

대부분의 Apache 설치는 이 플러그인을 기본적으로 사용 설정합니다. VM 인스턴스에서 플러그인이 사용 설정되어 있는지 확인하려면 다음을 실행하세요.

curl localhost:80/server-status?auto

플러그인이 사용 설정된 경우 출력에 다음과 비슷한 줄이 포함됩니다.

Total Accesses: 2
Total kBytes: 1
BusyWorkers: 1
IdleWorkers: 4

대신 404 Not Found 페이지가 표시되면 mod_status 플러그인이 사용 설정되지 않은 것입니다.

Apache 웹 서버 작업 에이전트 구성

작업 에이전트 구성 가이드에 따라 Apache 웹 서버 인스턴스에서 로그를 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 Apache 웹 서버에서 로그 및 측정항목을 수집 및 처리하고 Linux에서 작업 에이전트를 다시 시작하도록 구성을 만듭니다.

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    apache_access:
      type: apache_access
    apache_error:
      type: apache_error
  service:
    pipelines:
      apache:
        receivers:
        - apache_access
        - apache_error
metrics:
  receivers:
    apache:
      type: apache
      server_status_url: http://localhost:80/server-status?auto
      collection_interval: 30s
  service:
    pipelines:
      apache:
        receivers:
        - apache
EOF
sudo service google-cloud-ops-agent restart

로그 수집 구성

Apache 웹 서버에서 로그를 수집하려면 Apache 웹 서버가 생성하는 로그에 대해 리시버를 만든 후 새 수신자에 대한 파이프라인을 만들어야 합니다. 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

apache_access 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
type 값은 apache_access여야 합니다.
include_paths [/var/log/apache2/access.log,/var/log/apache2/access_log,/var/log/httpd/access_log] 각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(*)를 경로에 사용할 수 있습니다(예: /var/log/apache*/*.log).
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.

apache_error 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
type 값은 apache_error여야 합니다.
include_paths [/var/log/apache2/error.log,/var/log/apache2/error_log,/var/log/httpd/error_log] 각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(*)를 경로에 사용할 수 있습니다(예: /var/log/apache*/*.log).
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.

로깅되는 내용

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

apache_access 로그에는 httpRequest 필드가 포함됩니다.

필드 유형 설명
httpRequest.protocol 문자열 요청에 사용된 프로토콜
httpRequest.referer 문자열 Referer 헤더의 콘텐츠
httpRequest.requestMethod 문자열 HTTP 메서드
httpRequest.requestUrl 문자열 요청 URL(일반적으로 URL의 경로 부분만)
httpRequest.responseSize 문자열(int64) 응답 크기
httpRequest.status 숫자 HTTP 상태 코드
httpRequest.userAgent 문자열 User-Agent 헤더의 콘텐츠
jsonPayload.host 문자열 Host 헤더의 콘텐츠
jsonPayload.user 문자열 요청의 인증된 사용자 이름
timestamp 문자열(Timestamp) 요청이 수신된 시간

로그 항목에는 비어 있거나 누락된 필드가 포함되지 않습니다.


apache_error 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드 유형 설명
jsonPayload.errorCode 문자열 Apache 오류 코드
jsonPayload.level 문자열 로그 항목 수준
jsonPayload.module 문자열 로그가 발생된 Apache 모듈
jsonPayload.pid 숫자 처리 ID
jsonPayload.tid 숫자 스레드 ID
jsonPayload.message 문자열 로그 메시지
jsonPayload.client 문자열 클라이언트 IP 주소(선택사항)
severity 문자열(LogSeverity) 로그 항목 수준(번역됨)
timestamp 문자열(Timestamp) 항목이 로깅된 시간

측정항목 수집 구성

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

필드 기본값 설명
type 값은 apache여야 합니다.
server_status_url http://localhost:8080/server-status?auto mod_status 모듈이 노출하는 URL입니다.
collection_interval 60s time.Duration 값(예: 30s 또는 5m)입니다.

모니터링 대상

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

측정항목 유형
종류, 유형
모니터링 리소스
라벨
workload.googleapis.com/apache.current_connections
GAUGEINT64
gce_instance
server_name
workload.googleapis.com/apache.requests
CUMULATIVEINT64
gce_instance
server_name
workload.googleapis.com/apache.scoreboard
GAUGEINT64
gce_instance
state
server_name
workload.googleapis.com/apache.traffic
CUMULATIVEINT64
gce_instance
server_name
workload.googleapis.com/apache.workers
GAUGEINT64
gce_instance
state
server_name

구성 확인

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

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

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/apache_access" OR "projects/PROJECT_ID/logs/apache_error")


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

fetch gce_instance
| metric 'workload.googleapis.com/apache.requests'
| align rate(1m)
| every 1m