운영 에이전트를 사용하여 Apache에서 로그 수집

운영 에이전트를 사용하여 Compute Engine 가상 머신(VM) 인스턴스에 설치된 Apache 웹 서버에서 수집된 syslog 로그를 수집하고 보는 방법을 알아봅니다. 이 빠른 시작에서 비슷한 프로세스를 사용하여 기타 타사 애플리케이션을 모니터링할 수 있습니다.

이 빠른 시작에서 다루는 작업은 다음과 같습니다.

Compute Engine VM 인스턴스를 만들고 운영 에이전트 설치
Apache 웹 서버 설치
Apache 웹 서버 운영 에이전트 구성
로그 탐색기에서 로그 보기
로그 기반 알림 만들기
알림 테스트
삭제

Google Cloud 콘솔에서 이 태스크에 대한 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.

둘러보기

시작하기 전에

조직에서 정의한 보안 제약조건으로 인해 다음 단계를 완료하지 못할 수 있습니다. 문제 해결 정보는 제한된 Google Cloud 환경에서 애플리케이션 개발을 참조하세요.

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

API Compute Engine, Cloud Monitoring, and Cloud Logging 사용 설정

API 사용 설정

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

API Compute Engine, Cloud Monitoring, and Cloud Logging 사용 설정

API 사용 설정

VM 인스턴스 만들기

Google Cloud 콘솔의 탐색 패널에서 Compute Engine을 선택한 후 VM 인스턴스를 선택합니다.
VM 인스턴스로 이동
인스턴스 만들기를 클릭하여 VM 인스턴스를 만듭니다.
이름 필드에 설명이 포함된 이름을 입력합니다.
머신 유형 필드에서 e2-small을 선택합니다.
부팅 디스크 섹션에서 기본 설정인 Debian GNU/Linux를 그대로 둡니다.
방화벽 섹션에서 HTTP 트래픽 허용 및 HTTPS 트래픽 허용을 모두 선택합니다.
관측 가능성 - 운영 에이전트 섹션에서 모니터링 및 로깅을 위한 운영 에이전트 설치를 선택합니다.
만들기를 클릭합니다.

Apache 웹 서버 설치

Compute Engine VM 인스턴스에 Apache 웹 서버를 배포하려면 다음을 수행합니다.

VM 인스턴스 페이지에서 새 VM을 찾고 연결 열로 이동한 후 SSH를 클릭합니다.

연결하는 데 문제가 있다면 SSH 문제 해결을 참조하세요.
패키지 목록을 업데이트하려면 다음 명령어를 클립보드에 복사하고 SSH 터미널에 붙여넣은 다음 Enter 키를 누릅니다.
```
sudo apt-get update
```
'Reading package lists... Done'이라는 메시지가 표시되면 SSH 터미널에서 다음 명령어를 실행하여 Apache2 웹 서버를 설치합니다.
```
sudo apt-get install apache2 php7.0
```
계속 설치할지 묻는 메시지가 표시되면 Y를 입력합니다. 설치 명령어가 실패하면 sudo apt-get install apache2 php를 사용합니다.
명령어 프롬프트가 반환되면 VM 인스턴스 페이지로 이동하고 VM의 외부 IP 주소를 다음 URL에 복사합니다.
```
http://EXTERNAL_IP
```
Apache 웹 서버에 연결하려면 새 브라우저 탭을 열고 이전 단계의 URL을 입력합니다.

웹 서버가 성공적으로 설치되면 브라우저 탭에 Apache2 Debian 기본 페이지가 표시됩니다.

Apache 웹 서버 로그 및 측정항목 수집

이 단계에서는 운영 에이전트를 구성하여 Apache 웹 서버에서 로그와 측정항목을 수집합니다.

VM 인스턴스의 SSH 터미널로 이동합니다. 터미널이 열려 있지 않으면 다음을 수행합니다.
1. Google Cloud 콘솔의 탐색 패널에서 Compute Engine을 선택한 후 VM 인스턴스를 선택합니다.
  VM 인스턴스로 이동
2. 새 VM을 찾은 후 SSH를 클릭합니다.

다음 명령어를 복사하여 인스턴스의 터미널에 붙여넣은 다음 Enter 키를 누릅니다.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    apache:
      type: apache
  service:
    pipelines:
      apache:
        receivers:
          - apache
logging:
  receivers:
    apache_access:
      type: apache_access
    apache_error:
      type: apache_error
  service:
    pipelines:
      apache:
        receivers:
          - apache_access
          - apache_error
EOF

sudo service google-cloud-ops-agent restart
sleep 60

이전 명령어는 Apache 웹 서버에서 로그와 측정항목을 수집하는 구성을 만듭니다. 자세한 내용은 Apache 웹 서버용 운영 에이전트 구성을 참조하세요.

명령어 프롬프트가 표시될 때까지 기다립니다(60초 이상 소요).

Apache 웹 서버 로그 보기

Google Cloud 콘솔에서 로그를 보려면 로그 탐색기를 사용합니다.

Google Cloud 콘솔의 탐색 패널에서 Logging을 선택한 후 로그 탐색기를 선택합니다.
로그 탐색기로 이동

가장 최근 로그가 쿼리 결과 창에 표시됩니다.
툴바에서 쿼리 표시가 사용 설정되어 있는지 확인합니다.
Apache 웹 서버 로그를 보려면 쿼리를 만들고 실행합니다.
1. Google Cloud 프로젝트 선택기에서 Google Cloud 프로젝트 목록을 펼친 후 Google Cloud 프로젝트 ID를 클립보드에 복사합니다.
2. 다음 표현식에서 복사된 ID를 PROJECT_ID 필드에 붙여넣은 다음 표현식을 쿼리 편집기에 복사합니다.
```
resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/apache_access" OR "projects/PROJECT_ID/logs/apache_error")
```
  이전 쿼리가 실행되면 apache_access 및 apache_error 로그 항목만 표시됩니다.
3. 쿼리 실행을 클릭합니다.
  
  쿼리 결과가 쿼리 결과 창에 표시됩니다.

운영 에이전트가 Apache 웹 서버에서 로그 및 측정항목을 수집하도록 구성했고 이러한 로그를 확인했습니다. 다음 단계는 특정 패턴이 로그에 나타날 때 알림을 받도록 알림 정책을 만드는 것입니다.

이메일 알림 채널 만들기

알림 정책을 만들기 전에 알림 정책에서 사용할 알림 채널을 구성합니다. Cloud Monitoring은 이메일, Slack, PagerDuty, Pub/Sub를 비롯한 다양한 유형의 알림 채널을 지원합니다. 자세한 내용은 알림 채널 만들기 및 관리를 참고하세요. 이메일로 알림을 받으려면 다음 안내를 따르세요.

Google Cloud 콘솔의 탐색 패널에서 Monitoring을 선택한 후 알림을 선택합니다.
알림으로 이동
툴바에서 알림 채널 수정을 클릭합니다.
알림 채널 페이지에서 이메일까지 스크롤하고 새로 추가를 클릭합니다.
이메일 주소와 표시 이름(예: My email)을 입력한 후 저장을 클릭합니다.

로그 기반 알림 만들기

특정 메시지가 로그 항목에 나타날 때 알림을 받으려면 로그 기반 알림을 만듭니다. 이 섹션에서는 로그 항목에 404 Not Found 메시지가 나타날 때 알림이 전송되도록 로그 기반 알림을 만듭니다.

Google Cloud 콘솔의 탐색 패널에서 Logging을 선택한 후 로그 탐색기를 선택합니다.
로그 탐색기로 이동
쿼리 결과 툴바에서 알림 만들기를 클릭합니다. 로그 기반 알림 정책 창이 열립니다.
알림 세부정보의 알림 정책 이름 필드에 404 Not Found를 입력합니다.
이 알림에 포함할 로그 선택에서 다음을 수행합니다.
1. 로그 필터 텍스트 상자에 있는 콘텐츠를 삭제합니다.
2. 다음 쿼리를 복사하여 로그 필터 텍스트 상자에 붙여넣습니다.
```
severity>=DEFAULT /help httpRequest.status=404
```
  이전 로그 필터는 최소 DEFAULT 이상의 severity 레벨로 /help 텍스트가 포함되고 httpRequest 상태가 404인 로그 항목을 검색합니다.
알림 빈도 및 자동 종료 기간 설정 섹션에서 다음을 수행합니다.
1. 알림 간격 필드를 5분으로 설정합니다.
2. 이슈 자동 종료 기간 필드를 30분으로 설정합니다.
알림 수신 대상의 알림 채널 메뉴에서 이메일을 선택한 후 저장을 클릭합니다.

알림 정책 테스트

알림 정책을 테스트하려면 다음을 수행합니다.

VM 인스턴스의 SSH 터미널로 이동합니다. 터미널이 열려 있지 않으면 다음을 수행합니다.
1. Google Cloud 콘솔의 탐색 패널에서 Compute Engine을 선택한 후 VM 인스턴스를 선택합니다.
  VM 인스턴스로 이동
2. 새 VM을 찾은 후 SSH를 클릭합니다.
서버에서 가짜 페이지 localhost/help를 검색하려면 다음 명령어를 실행합니다.
```
curl localhost/help
```
터미널에 404 Not Found 메시지가 표시되면 이메일 알림이 전송됩니다. 이 프로세스를 완료하는 데 몇 분 정도 걸립니다.

다음과 유사한 이메일 알림이 수신됩니다.
새 로그 항목을 보려면 다음 안내를 따르세요.
1. Google Cloud 콘솔의 탐색 패널에서 Logging을 선택한 후 로그 탐색기를 선택합니다.
  로그 탐색기로 이동
2. 툴바에서 현재 시점으로 이동을 클릭합니다.

운영 에이전트가 Apache 웹 서버에서 로그와 측정항목을 수집하도록 구성했지만 로그만 살펴봤습니다. Apache 웹 서버 측정항목을 보는 방법은 운영 에이전트로 Apache 웹 서버 측정항목 수집: 트래픽 생성을 참조하세요.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

새 프로젝트를 만들었지만 더 이상 필요하지 않은 경우 프로젝트를 삭제하세요.

기존 프로젝트를 사용한 경우 다음을 수행합니다.

VM을 만든 경우 삭제합니다.
1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.
  VM 인스턴스로 이동
2. 삭제할 인스턴스.
3. 인스턴스를 삭제하려면 추가 작업을 클릭하고, 삭제를 클릭한 후 안내를 따르세요.
만든 알림 정책을 삭제합니다.
1. Google Cloud 콘솔의 탐색 패널에서 Monitoring을 선택한 후 알림을 선택합니다.
  알림으로 이동
2. 만든 알림 정책을 선택한 후 삭제를 클릭합니다.

다음 단계

운영 에이전트 및 지원되는 통합에 대한 자세한 내용은 다음을 참조하세요.
- 운영 에이전트 개요.
- 타사 애플리케이션 모니터링
로그 탐색기에서 로그를 보는 방법은 로그 탐색기를 사용하여 로그 보기를 참조하세요.
로그 탐색기를 사용한 쿼리에 대한 상세 설명은 로그 탐색기에서 쿼리 빌드를 참조하세요.
Apache 웹 서버 측정항목을 수집하고 보는 방법에 대한 자세한 내용은 빠른 시작: 운영 에이전트로 Apache 웹 서버 측정항목 수집을 참조하세요.
Monitoring 및 Cloud Logging과의 관계에 대한 자세한 내용은 Monitoring을 참조하세요.