IIS

Supported OS Windows

インテグレーションバージョン2.18.3

IIS グラフ

概要

すべてのサイトを集計して、またはサイトごとに IIS メトリクスを収集します。IIS Agent チェックは、アクティブな接続数、送信および受信バイト数、HTTP メソッド別のリクエスト数などのメトリクスを収集します。サイトごとのサービスチェックも送信されるため、サイトが稼働しているか停止しているかを把握できます。

セットアップ

APM に Datadog Agent を構成する

IIS チェックは Agent にパッケージ化されています。IIS メトリクスとログの収集を開始するには、Agent をインストールします。

ホスト

ホストで実行中の Agent に対してこのチェックを構成するには:

メトリクスの収集

IIS のサイトデータの収集を開始するには、Agent の構成ディレクトリのルートにある Agent の conf.d ディレクトリの iis.d/conf.yaml ファイルを編集します。使用可能なすべての構成オプションの詳細については、サンプル iis.d/conf.yaml を参照してください。
Agent を再起動すると、Datadog への IIS メトリクスの送信が開始されます。

注: このチェックのバージョン 2.14.0 以降では、メトリクスの収集に新しい実装を使用し、これには Python 3 が必要です。Python 3 の使用が不可能なホストの場合や、このチェックのレガシーバージョンを使用する場合は、以下のコンフィグを参照してください。

ログの収集

Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。
```
logs_enabled: true
```
IIS のログの収集を開始するには、次の構成ブロックを iis.d/conf.yaml ファイルに追加します。
```
logs:
  - type: file
    path: C:\inetpub\logs\LogFiles\W3SVC1\u_ex*
    service: myservice
    source: iis
```
path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。使用可能なすべての構成オプションの詳細については、サンプル iis.d/conf.yaml を参照してください。
Agent を再起動します。

注: datadog-agent ユーザーが、収集したいログファイルを追跡するための読み取りアクセス権を持っていることを確認してください。詳細は、ログファイルの追跡における権限の問題を参照してください。

検証

Agent の status サブコマンドを実行し、Checks セクションで iis を探します。

収集データ

メトリクス

iis.uptime (gauge)	The amount of time the IIS server has been running Shown as second
iis.net.bytes_sent (gauge)	The number of bytes served per second Shown as byte
iis.net.bytes_rcvd (gauge)	The number of bytes received per second Shown as byte
iis.net.bytes_total (gauge)	The total number of bytes transferred per second Shown as byte
iis.net.num_connections (gauge)	The number of active connections Shown as connection
iis.net.files_sent (gauge)	The number of files sent per second Shown as file
iis.net.files_rcvd (gauge)	The number of files received per second Shown as file
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.httpd_request_method.get (gauge)	The number of GET 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.head (gauge)	The number of HEAD 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.delete (gauge)	The number of DELETE 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.trace (gauge)	The number of TRACE requests per second Shown as request
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.errors.locked (gauge)	The number of locked errors per second (typically reported as an HTTP 423 response code) Shown as error
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.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.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.app_pool.recycle.count (count)	The number of times that the application pool has been recycled since Windows Process Activation Service (WAS) started.

イベント

IIS チェックには、イベントは含まれません。

サービスのチェック

iis.site_up
サイトのアップタイムが 0 の場合は CRITICAL を、それ以外の場合は OK を返します。サイトのアップタイムは WMI 経由で Win32_PerfFormattedData_W3SVC_WebService クラスを用いて収集されます。
Statuses: ok, クリティカル

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。