Suivi des requêtes HTTP

Le suivi des requêtes HTTP est une fonctionnalité d’IIS qui permet de déterminer exactement ce qui se passe avec une requête. Cela inclut toute forme d’authentification, le gestionnaire utilisé et la durée pendant laquelle chaque étape a pris dans le pipeline. L’activation du suivi des demandes est un moyen utile de diagnostiquer un comportement inattendu ou indésirable.

Paramètres de fonctionnalité (/api/webserver/http-request-tracing)

La fonctionnalité de suivi des requêtes HTTP crée des fichiers de trace basés sur un ensemble configuré de règles. Les informations contenues dans les fichiers de trace sont déterminées par les fournisseurs qui peuvent être utilisés pour cette règle. Les paramètres de fonctionnalité pour le suivi des demandes traitent de la génération des fichiers de trace.

GET/api/webserver/http-request-tracing/{request-tracing-id}

{
    "id": "{request-tracing-id}",
    "scope": "",
    "metadata": {
        "is_local": "true",
        "is_locked": "false",
        "override_mode": "inherit",
        "override_mode_effective": "allow"
    },
    "enabled": "true",
    "directory": "%SystemDrive%\\inetpub\\logs\\FailedReqLogFiles",
    "maximum_number_trace_files": "50",
    "website": null,
    "_links": {
        "providers": {
            "href": "/api/webserver/http-request-tracing/providers?http_request_tracing.id={request-tracing-id}"
        },
        "rules": {
            "href": "/api/webserver/http-request-tracing/rules?http_request_tracing.id={request-tracing-id}"
        }
    }
}

Fournisseurs de trace (/api/webserver/http-request-tracing/providers)

Les fournisseurs de suivi des requêtes HTTP déterminent quelles informations seront fournies chaque fois qu’une règle de trace est déclenchée. IIS est fourni avec un ensemble de fournisseurs par défaut qui fournissent la plupart des informations souhaitées par un consommateur.

GET/api/webserver/http-request-tracing/providers/{provider-id}

{
    "name": "ASPNET",
    "id": "{provider-id}",
    "guid": "{aff081fe-0247-4275-9c4e-021f3dc1da35}",
    "areas": [
        "Infrastructure",
        "Module",
        "Page",
        "AppServices"
    ],
    "request_tracing": {
        "id": "{request-tracing-id}",
        "scope": "",
        "_links": {
            "self": {
                "href": "/api/webserver/http-request-tracing/{request-tracing-id}"
            }
        }
    }
}

Règles de trace (/api/webserver/http-request-tracing/rules)

Les règles de suivi génèrent des journaux de suivi des demandes chaque fois qu’une demande est exécutée qui répond aux conditions spécifiées dans la règle de trace. Les règles de trace peuvent se déclencher en fonction du code d’état, du temps d’exécution et du chemin d’accès.

GET/api/webserver/http-request-tracing/rules/{rule-id}

{
    "path": "*",
    "id": "{rule-id}",
    "status_codes": [
        "101-999"
    ],
    "min_request_execution_time": "2147483647",
    "event_severity": "ignore",
    "custom_action": {
        "executable": "",
        "params": "",
        "trigger_limit": "1"
    },
    "traces": [
        {
            "allowed_areas": {
                "Authentication": "true",
                "Security": "true",
                "Filter": "true",
                "StaticFile": "true",
                "CGI": "true",
                "Compression": "true",
                "Cache": "true",
                "RequestNotifications": "true",
                "Module": "true",
                "FastCGI": "true",
                "WebSocket": "true"
            },
            "provider": {
                "name": "WWW Server",
                "id": "{provider-id}",
                "_links": {
                    "self": {
                        "href": "/api/webserver/http-request-tracing/providers/{provider-id}"
                    }
                }
            },
            "verbosity": "warning"
        }
    ],
    "request_tracing": {
        "id": "{request-tracing-id}",
        "scope": "",
        "_links": {
            "self": {
                "href": "/api/webserver/http-request-tracing/{request-tracing-id}"
            }
        }
    }
}

Création d’une règle de suivi de requête

Une règle de suivi de requête doit spécifier la section de suivi de requête à laquelle elle appartient lors de sa création, et doit également spécifier tous les fournisseurs qui doivent consigner des informations pour le fichier journal généré. Dans cet exemple, une règle est créée qui génère uniquement des journaux de trace pour les requêtes à index.html. Les journaux d’activité incluent des informations provenant du fournisseur de trace WWW Server.

POST/api/webserver/http-request-tracing/rules

{
    "path": "index.html",
    "status_codes": [
        "100-999"
    ],
    "traces": [
        {
            "allowed_areas": {
                "Authentication": "true",
                "Security": "true",
                "Filter": "true",
                "StaticFile": "true",
                "CGI": "true",
                "Compression": "true",
                "Cache": "true",
                "RequestNotifications": "true",
                "Module": "true",
                "FastCGI": "true",
                "WebSocket": "true"
            },
            "provider": {
                "id": "{www-server-provider-id}"
            },
            "verbosity": "warning"
        }
    ],
    "request_tracing": {
        "id": "{request-tracing-id}"
    }
}

Journaux de trace (/api/webserver/http-request-tracing/traces)

L’API Administration Microsoft IIS fournit un point de terminaison pour afficher les données des journaux de trace générés. Ces informations permettent de déterminer rapidement le fichier de trace qui est intéressant au lieu d’avoir à ouvrir chaque fichier individuellement.

GET/api/webserver/http-request-tracing/traces/{trace-id}

{
    "id": "{trace-id}",
    "url": "http://localhost:80/favicon.ico",
    "method": "GET",
    "status_code": "404",
    "date": "2017-03-02T15:34:17.0627155-08:00",
    "time_taken": "0",
    "process_id": "8172",
    "activity_id": "{8000009D-0001-F700-B63F-84710C7967BB}",
    "file_info": {
        "name": "fr000001.xml",
        "id": "{file-id}",
        "type": "file",
        "physical_path": "c:\\inetpub\\logs\\FailedReqLogFiles\\W3SVC1\\fr000001.xml",
        "_links": {
            "self": {
                "href": "/api/files/{file-id}"
            }
        }
    },
    "request_tracing": {
        "id": "{request-tracing-id}",
        "scope": "Default Web Site/",
        "_links": {
            "self": {
                "href": "/api/webserver/http-request-tracing/{request-tracing-id}"
            }
        }
    }
}