HTTP-Anforderungsablaufverfolgung

Die HTTP-Anforderungsablaufverfolgung ist ein Feature von IIS, das eine Möglichkeit bietet, zu bestimmen, was genau mit einer Anforderung geschieht. Dazu gehören jede Art von Authentifizierung, welche Handler verwendet wurde und wie lange jeder Schritt in der Pipeline ausgeführt wurde. Das Aktivieren der Anforderungsablaufverfolgung ist eine nützliche Möglichkeit, unerwartetes oder unerwünschtes Verhalten zu diagnostizieren.

Featureeinstellungen (/api/webserver/http-request-tracing)

Das Feature für die HTTP-Anforderungsablaufverfolgung erstellt Ablaufverfolgungsdateien basierend auf einem konfigurierten Satz von Regeln. Die Informationen in den Ablaufverfolgungsdateien werden von den Anbietern bestimmt, die für diese Regel verfügbar sind. Die Featureeinstellungen für die Anforderungsablaufverfolgung behandeln die Generierung der Ablaufverfolgungsdateien.

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}"
        }
    }
}

Ablaufverfolgungsanbieter (/api/webserver/http-request-tracing/providers)

Die Anbieter für die HTTP-Anforderungsablaufverfolgung bestimmen, welche Informationen bereitgestellt werden, wenn eine Ablaufverfolgungsregel ausgelöst wird. IIS verfügt über eine Reihe von Standardanbietern, die die meisten Informationen bereitstellen, die ein Verbraucher benötigen wird.

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}"
            }
        }
    }
}

Ablaufverfolgungsregeln (/api/webserver/http-request-tracing/rules)

Ablaufverfolgungsregeln generieren Anforderungsablaufverfolgungsprotokolle, wenn eine Anforderung ausgeführt wird, die die in der Ablaufverfolgungsregel angegebenen Bedingungen erfüllt. Ablaufverfolgungsregeln können basierend auf Statuscode, Ausführungszeit und Pfad ausgelöst werden.

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}"
            }
        }
    }
}

Erstellen einer Anforderungsablaufverfolgungsregel

Eine Anforderungsablaufverfolgungsregel muss angeben, zu welchem Anforderungsablaufverfolgungsabschnitt sie gehört, wann sie erstellt wird, und auch alle Anbieter angeben, die Informationen für die generierte Protokolldatei protokollieren sollen. In diesem Beispiel wird eine Regel erstellt, die nur Ablaufverfolgungsprotokolle für Anforderungen an index.htmlgeneriert. Die Protokolle enthalten Informationen vom WWW Server Ablaufverfolgungsanbieters.

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}"
    }
}

Ablaufverfolgungsprotokolle (/api/webserver/http-request-tracing/trace)

Die Microsoft IIS-Verwaltungs-API stellt einen Endpunkt zum Anzeigen von Daten für die Ablaufverfolgungsprotokolle bereit, die generiert wurden. Mit diesen Informationen können Sie schnell ermitteln, welche Ablaufverfolgungsdatei von Interesse ist, anstatt jede Datei einzeln öffnen zu müssen.

GET/api/webserver/http-request-tracing/trace/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}"
            }
        }
    }
}