IIS

Supported OS Windows

통합 버전3.1.1

IIS Graph

개요

사이트 전체나 사이트별로 집계된 IIS 메트릭을 수집하세요. IIS 에이전트 점검에서는 활성 연결, 송수신된 바이트, HTTP 메서드별 요청 개수 등의 메트릭을 수집합니다. 또 각 사이트의 서비스 점검을 전송해 사이트가 정상인지 아니면 다운되었는지 알려줍니다.

설정

설치

IIS 점검은 에이전트 패키지에 포함되어 있습니다. IIS 메트릭과 로그 수집을 시작하려면 IIS 서버에 에이전트를 설치하세요.

호스트

호스트에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

  1. 에이전트 구성 파일의 루트에 있는 에이전트 conf.d 디렉터리의 iis.d/conf.yaml 파일을 편집해 IIS 사이트 데이터 수집을 시작하세요. 사용할 수 있는 구성 옵션 전체를 보려면 샘플 iis.d/conf.yaml를 참고하세요.

  2. 에이전트를 재시작해 IIS 메트릭을 Datadog로 전송하기 시작합니다.

참고: 이 점검의 2.14.0 이상 버전에서는 메트릭 수집에 새로운 구현을 사용하므로 Python 3이 필요합니다. Python 3을 사용할 수 없는 호스트의 경우 또는 이 점검의 레거시 버전을 사용하려는 경우 다음 config를 참고하세요.

로그 수집

  1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml파일에서 로그 수집을 사용하도록 설정합니다.

    logs_enabled: true

  2. 이 구성 블록을 iis.d/conf.yaml 파일에 추가해 IIS 로그 수집을 시작하세요.

    logs:
  - type: file
    path: C:\inetpub\logs\LogFiles\W3SVC1\u_ex*
    service: myservice
    source: iis

    path와 service 파라미터 값을 내 환경에 맞게 변경하세요. 사용할 수 있는 구성 옵션 전체를 보려면 샘플 iis.d/conf.yaml을 참고하세요.

  3. 에이전트를 재시작하세요.

참고: 수집하고자하는 로그 파일을 테일링할 수 있도록datadog-agent 사용자에게 읽기 및 실행 액세스를 부여해야 합니다. IIS에서 새 하위 폴더를 생성할 때(새 사이트가 생성되었을 떄) 상위 폴더 권한이 자동으로 부여되지 않습니다. 자세한 정보는 로그 파일 테일링 권한 문제를 참고하세요.

검증

에이전트 상태 하위 명령을 실행하고 Checks 섹션 아래에서 iis를 찾으세요.

수집한 데이터

메트릭

iis.app_pool.recycle.count
(count)		The number of times that the application pool has been recycled since Windows Process Activation Service (WAS) started.
iis.app_pool.state
(gauge)		The current status of the application pool (1 - Uninitialized, 2 - Initialized, 3 - Running, 4 - Disabling, 5 - Disabled, 6 - Shutdown Pending, 7 - Delete Pending).
iis.app_pool.uptime
(gauge)		The length of time, in seconds, that the application pool has been running since it was started.
Shown as second
iis.errors.locked
(gauge)		The number of locked errors per second (typically reported as an HTTP 423 response code)
Shown as error
iis.errors.not_found
(gauge)		The number of not found errors per second (typically reported as an HTTP 404 response code)
Shown as error
iis.httpd_request_method.delete
(gauge)		The number of DELETE requests per second
Shown as request
iis.httpd_request_method.get
(gauge)		The number of GET requests per second
Shown as request
iis.httpd_request_method.head
(gauge)		The number of HEAD requests per second
Shown as request
iis.httpd_request_method.options
(gauge)		The number of OPTIONS requests per second
Shown as request
iis.httpd_request_method.post
(gauge)		The number of POST requests per second
Shown as request
iis.httpd_request_method.put
(gauge)		The number of PUT requests per second
Shown as request
iis.httpd_request_method.trace
(gauge)		The number of TRACE requests per second
Shown as request
iis.net.bytes_rcvd
(gauge)		The number of bytes received per second
Shown as byte
iis.net.bytes_sent
(gauge)		The number of bytes served per second
Shown as byte
iis.net.bytes_total
(gauge)		The total number of bytes transferred per second
Shown as byte
iis.net.connection_attempts
(gauge)		The number of connection attempts since service startup
Shown as connection
iis.net.connection_attempts_sec
(gauge)		The number of connection attempts per second
Shown as connection
iis.net.files_rcvd
(gauge)		The number of files received per second
Shown as file
iis.net.files_sent
(gauge)		The number of files sent per second
Shown as file
iis.net.num_connections
(gauge)		The number of active connections
Shown as connection
iis.requests.cgi
(gauge)		The number of Common Gateway Interface requests executed per second
Shown as request
iis.requests.isapi
(gauge)		The number of ISAPI requests executed per second
Shown as request
iis.uptime
(gauge)		The amount of time the IIS server has been running
Shown as second
iis.users.anon
(gauge)		The number of requests from users over an anonymous connection per second
Shown as request
iis.users.nonanon
(gauge)		The number of requests from users over a non-anonymous connection per second
Shown as request

이벤트

IIS 점검은 이벤트를 포함하지 않습니다.

서비스 점검

iis.site_up
Returns CRITICAL if the uptime for a site is 0 and OK otherwise. The site uptime is collected via Windows Performance Data Helper using the ‘Web Service(*)\Service Uptime’ counter
Statuses: ok, critical

iis.app_pool_up
Returns CRITICAL if the tagged app_pool is down and OK otherwise.
Statuses: ok, critical

트러블슈팅

도움이 필요하신가요? Datadog 고객 지원팀에 문의하세요.