Pelacakan Permintaan HTTP

Pelacakan permintaan HTTP adalah fitur IIS yang menyediakan cara untuk menentukan apa yang sebenarnya terjadi dengan permintaan. Ini termasuk segala bentuk autentikasi, handler mana yang digunakan, dan berapa lama setiap langkah mengambil dalam alur. Mengaktifkan pelacakan permintaan adalah cara yang berguna untuk mendiagnosis perilaku yang tidak terduga atau tidak diinginkan.

Pengaturan Fitur (/api/webserver/http-request-tracing)

Fitur pelacakan permintaan HTTP membuat file pelacakan berdasarkan sekumpulan aturan yang dikonfigurasi. Informasi dalam file pelacakan ditentukan oleh penyedia apa yang tersedia untuk aturan tersebut. Pengaturan fitur untuk permintaan penelusuran menangani pembuatan file jejak.

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

Penyedia Pelacakan (/api/webserver/http-request-tracing/providers)

Penyedia untuk pelacakan permintaan HTTP menentukan informasi apa yang akan diberikan setiap kali aturan pelacakan dipicu. IIS dilengkapi dengan sekumpulan penyedia default yang memberikan sebagian besar informasi yang diinginkan konsumen.

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

Aturan Pelacakan (/api/webserver/http-request-tracing/rules)

Aturan pelacakan menghasilkan log pelacakan permintaan setiap kali permintaan dijalankan yang memenuhi kondisi yang ditentukan dalam aturan pelacakan. Aturan pelacakan dapat dipicu berdasarkan kode status, waktu eksekusi, dan jalur.

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

Membuat Aturan Pelacakan Permintaan

Aturan pelacakan permintaan harus menentukan bagian pelacakan permintaan mana yang dimilikinya saat dibuat, dan juga harus menentukan penyedia apa pun yang harus mencatat informasi untuk file log yang dihasilkan. Dalam contoh ini, aturan dibuat yang hanya menghasilkan log jejak untuk permintaan index.html. Log akan menyertakan informasi dari penyedia pelacakan Server 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}"
    }
}

Jejak Log (/api/webserver/http-request-tracing/traces)

API Administrasi Microsoft IIS menyediakan titik akhir untuk melihat data untuk log jejak yang telah dihasilkan. Informasi ini membantu dengan cepat menentukan file pelacakan mana yang menarik alih-alih harus membuka setiap file satu per satu.

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