Rastreamento de solicitação HTTP

O rastreamento de solicitação HTTP é um recurso do IIS que fornece uma maneira de determinar o que exatamente está acontecendo com uma solicitação. Isso inclui qualquer forma de autenticação, qual manipulador foi usado e quanto tempo cada etapa levou no pipeline. Habilitar o rastreamento de solicitação é uma maneira útil de diagnosticar comportamento inesperado ou indesejável.

Configurações de recurso (/api/webserver/http-request-tracing)

O recurso de rastreamento de solicitação HTTP cria arquivos de rastreamento com base em um conjunto configurado de regras. As informações nos arquivos de rastreamento são determinadas por quais provedores são avaializáveis para essa regra. As configurações de recurso para o rastreamento de solicitação lidam com a geração dos arquivos de rastreamento.

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

Provedores de rastreamento (/api/webserver/http-request-tracing/providers)

Os provedores de rastreamento de solicitação HTTP determinam quais informações serão fornecidas sempre que uma regra de rastreamento for disparada. O IIS vem com um conjunto de provedores padrão que fornecem a maioria das informações que um consumidor desejará.

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

Regras de rastreamento (/api/webserver/http-request-tracing/rules)

As regras de rastreamento geram logs de rastreamento de solicitação sempre que uma solicitação é executada que atende às condições especificadas na regra de rastreamento. As regras de rastreamento podem ser disparadas com base no código de status, no tempo de execução e no caminho.

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

Criando uma regra de rastreamento de solicitação

Uma regra de rastreamento de solicitação deve especificar a seção de rastreamento de solicitação à qual ela pertence quando está sendo criada e também deve especificar quaisquer provedores que devem registrar informações no arquivo de log gerado. Neste exemplo, é criada uma regra que gera apenas logs de rastreamento para solicitações para index.html. Os logs incluirão informações do provedor de rastreamento de do SERVIDOR WWW.

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

Logs de rastreamento (/api/webserver/http-request-tracing/traces)

A API de Administração do Microsoft IIS fornece um ponto de extremidade para exibir dados para os logs de rastreamento que foram gerados. Essas informações ajudam a determinar rapidamente qual arquivo de rastreamento é de interesse em vez de ter que abrir cada arquivo individualmente.

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