Post

ASP.NET Core Diagnostics for IIS/IIS Express, Stories Behind

A post about how to diagnose ASP.NET Core issues on IIS/IIS Express.

ASP.NET Core on IIS/IIS Express shouldn’t be hard, as they all come from Microsoft. However, we all know it has been a mess since the beginning, as I blogged multiple times from different angles, in the following posts like this, this, and this.

So what should a developer do when a related error happens? Going through all the materials and tons of posts on Stack Overflow? That’s both a waste of time and also a painful process, because even for a single error code (like 502.5) there are at least four possible causes (while Microsoft documentation only covers one).

I have been thinking about this for a while (since June 2017 maybe), but I wasn’t quite familiar with all the necessary details yet, until last month at Microsoft campus. Again, thanks for all the new knowledge I gained from the MVP Summit sessions, and the passions from other participants, so that this year I was able to create ASP.NET Core Diagnostics for IIS/IIS Express on the Hackathon day.

Similar to other diagnostics (like SSL), this new diagnostics tool focus first on data collection, where it checks,

  • Whether ASP.NET Core module (ANCM) is installed, and what is the version number.
  • Whether Visual C++ 2015 runtime is installed, and what’s the version number.
  • Whether the application pool is using No Managed Code.
  • Whether a valid handler is registered.
  • What’s the web app runtime version.

Of course, whenever possible it also reports typical errors, such as version mismatch between ANCM and the web app runtime. Such should already apply to most 500 and 502.5 scenarios.

I am still trying to improve this tool so that it can cover more cases, and dig up more useful information in the report, so let’s see how far we can go from here.

Stay tuned.

© Lex Li. All rights reserved. The code included is licensed under CC BY 4.0 unless otherwise noted.
Advertisement