IIS

Supported OS Windows

Intégration2.19.1

Graphique IIS

Présentation

Recueillez les métriques IIS agrégées par site ou sur l’ensemble vos sites. Le check de l’Agent IIS recueille des métriques sur les connexions actives, les octets envoyés et reçus, le nombre de requêtes par méthode HTTP, et plus encore. Il envoie également un check de service pour chaque site, pour vous informer de sa disponibilité.

Implémentation

Installation

Le check IIS est fourni avec l’Agent. Pour commencer à recueillir vos logs et métriques IIS, installez l’Agent sur vos serveurs IIS.

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

Collecte de métriques

Modifiez le fichier iis.d/conf.yaml dans le dossier conf.d de l’Agent à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de site IIS. Consultez le fichier d’exemple iis.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent pour commencer à envoyer vos métriques IIS à Datadog.

Remarque : les versions 2.14.0+ de ce check sont basées sur une nouvelle implémentation pour la collecte de métriques qui nécessite d’utiliser Python 3. Pour les hosts ne pouvant pas utiliser Python 3, ou si vous souhaitez utiliser une ancienne version de ce check, consultez cette configuration.

Collecte de logs

La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :
```
logs_enabled: true
```
Ajoutez ce bloc de configuration à votre fichier iis.d/conf.yaml pour commencer à recueillir vos logs IIS :
```
logs:
  - type: file
    path: C:\inetpub\logs\LogFiles\W3SVC1\u_ex*
    service: myservice
    source: iis
```
Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement. Consultez le fichier d’exemple iis.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent.

Remarque : assurez-vous que l’utilisateur datadog-agent bénéficie d’un accès en lecture seule, afin de pouvoir suivre les fichiers de log dont vous souhaitez recueillir les données. Consultez la rubrique Problèmes d’autorisation lors du suivi de fichiers de log pour en savoir plus.

Validation

Lancez la sous-commande status de l’Agent et cherchez iis dans la section Checks.

Données collectées

Métriques

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

Événements

Le check IIS n’inclut aucun événement.

Checks de service

iis.site_up
Renvoie CRITICAL si la durée de fonctionnement d’un site est égale à 0. Si ce n’est pas le cas, renvoie OK. La durée de fonctionnement d’un site est recueillie via WMI à l’aide de la classe Win32_PerfFormattedData_W3SVC_WebService
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.