IIS

인터넷 정보 서비스 통합은 IIS 웹 서버에서 원격 분석을 수집합니다. 이러한 측정항목은 연결 정보와 전송된 바이트에 대한 데이터도 제공합니다. 또한 통합은 액세스 로그의 정보를 수집합니다.

IIS에 대한 자세한 내용은 인터넷 정보 서비스 문서를 참조하세요.

시작하기 전에

작업 에이전트 버전 2.15.0은 workload.googleapis.com/ 프리픽스를 사용하여 새로운 IIS 측정항목 집합을 지원합니다. 구성 예시에 설명된 대로 이러한 측정항목을 수집하도록 에이전트를 구성해야 합니다.

작업 에이전트는 항상 제한된 IIS 측정항목 집합을 지원합니다. 이러한 측정항목은 agent.googleapis.com/iis/ 프리픽스를 사용합니다. Windows VM에서 이러한 측정항목을 수집하는 데 추가 구성은 필요하지 않습니다.

이 문서에서는 agent가 프리픽스로 추가된 측정항목을 v1 측정항목이라고 부르고 workload가 프리픽스로 추가된 측정항목을 v2 측정항목이라고 부릅니다. 이러한 측정항목 표는 모니터링 대상을 참조하세요.

운영 에이전트 버전 2.15.0부터 v1 측정항목, v2 측정항목 또는 둘 다 수집하도록 에이전트를 구성할 수 있습니다.

참고: v1 측정항목을 기반으로 하는 알림 또는 기타 구성이 있는 경우 v2 측정항목으로 전환하면 구성도 마이그레이션해야 합니다. v1 측정항목 수집을 중지하면 해당 측정항목의 알림 및 기타 모니터링도 중단됩니다. 다음 표에서는 v1 측정항목과 v2 측정항목의 매핑을 보여줍니다.

v1 측정항목(`agent.googleapis.com/iis/`)	v2 측정항목(`workload.googleapis.com/`)
`current_connections`	`iis.connection.active`
`network/transferred_bytes_count`	`iis.network.io`
`new_connection_count`	`iis.connection.attempt.count`
`request_count`	`iis.request.count`

기본 요건

IIS 원격 분석을 수집하려면 작업 에이전트를 설치해야 합니다.

측정항목 v1의 경우 버전 1.0.0 이상을 설치합니다.
측정항목 v2의 경우 버전 2.15.0 이상을 설치합니다.
로그에는 버전 2.14.0 이상을 설치합니다.

이 통합은 IIS 버전 8.5 및 10.0을 지원합니다.

IIS용 작업 에이전트 구성

작업 에이전트 구성 가이드에 따라 IIS 인스턴스에서 원격 분석을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 IIS용 원격 분석을 수집하고 처리하는 구성을 만들고 작업 에이전트를 다시 시작합니다.

# This config gets merged with the built-in Ops Agent config, which already
# includes the v1 receiver in the default pipeline.
# Because the v2 receiver here uses a unique ID, it does not overwrite
# the default receiver and so both receivers will be active simultaneously
# during the test.

# Create a back up of the existing file so existing configurations are not lost.
Copy-Item -Path 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' -Destination 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml.bak'

# Configure the Ops Agent.
Add-Content 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' "
metrics:
  receivers:
    iis_v2:
      type: iis
      receiver_version: 2
  service:
    pipelines:
      iispipeline:
        receivers:
          - iis_v2
logging:
  receivers:
    iis_access:
      type: iis_access
  service:
    pipelines:
      iis:
        receivers:
        - iis_access
"

Stop-Service google-cloud-ops-agent -Force
Start-Service google-cloud-ops-agent*

이 수신자는 기본 W3C 로깅 형식만 지원합니다.

로그 수집 구성

IIS에서 액세스 로그를 수집하려면 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

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

필드	기본값	설명
`exclude_paths`	`[]`	`include_paths` 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
`include_paths`	`['C:\inetpub\logs\LogFiles\W3SVC1\u_ex*']`	각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(``)를 경로에 사용할 수 있습니다(예: `C:\inetpub\logs\LogFiles\W3SVC1\u_ex`).
`type`		값은 `iis_access`여야 합니다.
`record_log_file_path`	`false`	`true`로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 `agent.googleapis.com/log_file_path` 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
`wildcard_refresh_interval`	`60s`	`include_paths`의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. `time.ParseDuration`으로 구문 분석할 수 있는 시간 간격으로 지정됩니다(예: 30초 또는 2분). 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

로깅되는 내용

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

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

필드	유형	설명
`httpRequest.referer`	문자열	`Referer` 헤더의 콘텐츠
`httpRequest.remoteIp`	문자열	요청을 수행한 클라이언트의 IP
`httpRequest.requestMethod`	문자열	HTTP 메서드
`httpRequest.requestUrl`	문자열	요청 URL(일반적으로 URL의 경로 부분만)
`httpRequest.serverIp`	문자열	요청된 서버의 IP 및 포트
`httpRequest.status`	숫자	HTTP 상태 코드
`httpRequest.userAgent`	문자열	`User-Agent` 헤더의 콘텐츠
`jsonPayload.sc_substatus`	숫자	하위 상태 오류 코드
`jsonPayload.sc_win32_status`	숫자	Windows 상태 코드
`jsonPayload.time_taken`	숫자	작업에 소요된 시간(밀리초)
`jsonPayload.user`	문자열	요청의 인증된 사용자 이름
`timestamp`	문자열(`Timestamp`)	요청이 수신된 시간

v1 측정항목 수집 구성

Microsoft Windows VM의 작업 에이전트는 IIS v1 측정항목을 자동으로 수집합니다. 추가 구성은 필요하지 않습니다. v2 측정항목만 수집하는 방법에 대한 자세한 내용은 v2 측정항목 수집 구성을 참조하세요.

새 IIS 인스턴스를 설정한 후에는 IIS가 측정항목을 즉시 보고하지 않을 수 있습니다. Windows Server에 설치된 서버 관리자 콘솔을 사용하면 서버의 관리 효율성 열에 온라인 - 성능 카운터가 시작되지 않음 상태가 표시될 수 있습니다.

IIS에서 측정항목을 생성하도록 설정하는 한 가지 방법은 서버 관리자 콘솔에서 IIS 서버를 마우스 오른쪽 버튼으로 클릭하고 성능 카운터 시작을 선택하는 것입니다. 서버가 작업 에이전트에 측정항목을 보내기 시작해야 합니다.

v2 측정항목 수집 구성

IIS에서 v2 측정항목을 수집하려면 IIS에서 생성하는 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

iis 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`collection_interval`	60s	time.Duration 값(예: 30초 또는 5분)
`receiver_version`		수집된 측정항목의 버전입니다. `2`를 사용하여 v2 측정항목을 수집합니다.
`type`		값은 `iis`여야 합니다.

기본적으로 v1 측정항목은 자동으로 수집됩니다. v2 측정항목을 추가로 수집하여 v1 측정항목을 보강하거나 v2 측정항목만 수집하도록 v1 측정항목을 재정의할 수 있습니다.

v2 측정항목만 수집하려면 다음 안내를 따르세요.
- 수신자 iis 이름을 지정합니다.
- type 필드를 iis로 설정합니다.
- receiver_version 필드를 2로 설정합니다.
- default_pipeline 파이프라인에서 이 수신자를 사용합니다. 이 구성은 iis 수신자의 기본 제공 구성을 재정의합니다.
v1 및 v2 측정항목을 모두 수집하려면 다음 안내를 따르세요.
- 수신자에 iis가 아닌 이름(예: iis_v2)을 지정합니다.
- type 필드를 iis로 설정합니다.
- receiver_version를 2로 설정합니다.
- 새 파이프라인에서 이 수신자를 사용합니다. 이 구성은 기본 제공 수신자를 재정의하는 대신 v2 수신자를 추가합니다. 구성 예시의 스크립트에서 이 방법이 사용됩니다.

모니터링 대상

버전 2.15.0부터 운영 에이전트는 2개의 서로 다른 측정항목 집합을 수집할 수 있습니다.

v1 측정항목: agent.googleapis.com/iis/.
v2 측정항목: workload.googleapis.com/.

V1 측정항목

다음 표에서는 작업 에이전트가 IIS 인스턴스에서 수집하는 v1 측정항목 목록을 제공합니다.

이 표의 '측정항목 유형' 문자열 앞에 agent.googleapis.com/iis/가 포함된 프리픽스를 붙여야 합니다. 표의 항목에서는 이 프리픽스가 생략되었습니다.

측정항목 유형 ^{시작 단계} 표시 이름
종류, 유형, 단위 모니터링 리소스	설명 라벨
`current_connections` ^GA IIS 열린 연결
`GAUGE`, `DOUBLE`, `1` aws_ec2_instance, gce_instance	IIS에 대한 현재 열린 연결입니다. 60초마다 샘플링됩니다.
`network/transferred_bytes_count` ^GA IIS 전송 바이트 수
`CUMULATIVE`, `INT64`, `By` aws_ec2_instance, gce_instance	IIS로 전송된 네트워크 바이트 수입니다. 60초마다 샘플링됩니다. `direction`: 경로(전송, 수신)
`new_connection_count` ^GA IIS 연결
`CUMULATIVE`, `INT64`, `1` aws_ec2_instance, gce_instance	IIS에 대해 열린 연결입니다. 60초마다 샘플링됩니다.
`request_count` ^GA IIS 요청
`CUMULATIVE`, `INT64`, `1` aws_ec2_instance, gce_instance	IIS에 수행된 요청입니다. 60초마다 샘플링됩니다. `http_method`: Http 메서드(post, put, get, delete, option, trace, head)

2023년 1월 27일 01:53:03(UTC)에 생성된 표입니다.

V2 측정항목

다음 표에서는 작업 에이전트가 IIS 인스턴스에서 수집하는 v2 측정항목 목록을 제공합니다.

측정항목 유형
종류, 유형 모니터링 리소스	라벨
`workload.googleapis.com/iis.request.count`
`CUMULATIVE`, `INT64` gce_instance	`request`
`workload.googleapis.com/iis.request.rejected`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.request.queue.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.request.queue.age.max`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.network.file.count`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/iis.network.blocked`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.network.io`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/iis.connection.attempt.count`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.connection.active`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.connection.anonymous`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.thread.active`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.uptime`
`GAUGE`, `INT64` gce_instance

샘플 대시보드

IIS 측정항목을 보려면 차트 또는 대시보드가 구성되어 있어야 합니다. Cloud Monitoring은 사전 구성된 차트가 포함된 통합용 샘플 대시보드 라이브러리를 제공합니다. 이러한 대시보드 설치에 대한 자세한 내용은 샘플 대시보드 설치를 참조하세요.

구성 확인

이 섹션에서는 IIS 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 작업 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

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

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/iis_access")

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

v1 측정항목의 경우:

fetch gce_instance
| metric 'agent.googleapis.com/iis/request_count'
| every 1m

v2 측정항목의 경우:

fetch gce_instance
| metric 'workload.googleapis.com/iis.request.count'
| every 1m

다음 단계

Ansible을 사용하여 운영 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.