IIS
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

IIS

Agent Check Check de l'Agent

Supported OS: Windows

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, suivez les étapes suivantes :

  1. Installez l’Agent sur vos serveurs IIS.

  2. La classe WMI Win32_PerfFormattedData_W3SVC_WebService doit être installée sur vos serveurs IIS. Pour vous en assurer, utiliser la commande suivante :

    Get-WmiObject -List -Namespace root\cimv2 | select -Property name | where name -like "*Win32_PerfFormattedData_W3SVC*"

    Cette classe doit être installée avec la fonctionnalité Windows web-http-common :

    PS C:\Users\vagrant> Get-WindowsFeature web-* | where installstate -eq installed | ft -AutoSize
    
    Display Name                       Name               Install State
    ------------                       ----               -------------
    [X] Web Server (IIS)               Web-Server             Installed
    [X] Web Server                     Web-WebServer          Installed
    [X] Common HTTP Features           Web-Common-Http        Installed
    [X] Default Document               Web-Default-Doc        Installed
    [X] Directory Browsing             Web-Dir-Browsing       Installed
    [X] HTTP Errors                    Web-Http-Errors        Installed
    [X] Static Content                 Web-Static-Content     Installed

Vous pouvez ajouter les fonctionnalités manquantes avec install-windowsfeature web-common-http. Cette opération nécessite un redémarrage du système pour garantir son bon fonctionnement.

Configuration

Sur vos serveurs IIS, commencez par resynchroniser les compteurs WMI. Sur Windows <= 2003 (ou équivalent), exécutez les commandes suivantes dans cmd.exe :

C:/> winmgmt /clearadap
C:/> winmgmt /resyncperf

Sur Windows >= 2008 (ou équivalent), exécutez plutôt ce qui suit :

C:/> winmgmt /resyncperf

Host

Suivez les instructions ci-dessous pour configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la section Environnement conteneurisé pour en savoir plus sur les environnements conteneurisés.

Collecte de métriques
  1. 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.

  2. Redémarrez l’Agent pour commencer à envoyer vos métriques IIS à Datadog.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

  1. 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
  2. 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.

  3. Redémarrez l’Agent.

Environnement conteneurisé

Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.

Collecte de métriques
ParamètreValeur
<NOM_INTÉGRATION>iis
<CONFIG_INIT>vide ou {}
<CONFIG_INSTANCE>{"host": "%%host%%"}
Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

La collecte de logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs avec Docker.

ParamètreValeur
<CONFIG_LOG>{"source": "iis", "service": "<NOM_SERVICE>"}

Validation

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

Données collectées

Métriques

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.

Événements

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

Checks de service

iis.site_up :
L’Agent envoie ce check de service pour chaque site configuré dans iis.yaml. Il renvoie Critical si l’uptime du site est à zéro, et OK dans les autres cas.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.