Overview
Troubleshooting of SDN environment can be complex, as there are extensive areas to examine, depending on the resources that you are troubleshooting. To help facilitate automated troubleshooting, there are several functions that do the bulk of the work.
Get-SdnInfrastructureInfo
Get-SdnInfrastructure or Get-SdnEnvironmentInfo connects to Network Controller to then learn about the underlying SDN fabric. This information is then stored into a global cache $Global:SdnDiagnostics.EnvironmentInfo that can be referenced later and is used natively by other functions within the SdnDiagnostics module. To see full list of parameters supported with the function, review https://github.com/microsoft/SdnDiagnostics/wiki/Get-SdnInfrastructureInfo.
Debug-SdnFabricInfrastructure
Debug-SdnFabricInfrastructure executes a series of validation tests to check the current state of the environment. This is a great starting point to ensure everything related to the fabric is healthy before doing deeper level investigations into resources.
https://github.com/microsoft/SdnDiagnostics/assets/18577812/816d993d-b971-4452-b8d4-4070937f4759
Once you have performed Debug-SdnFabricInfrastructure, you can review the results by leveraging Get-SdnFabricInfrastructureResult to enumerate the results. In addition, iff you run Start-SdnDataCollection after performing Debug-SdnFabricInfrastructure, the debug summary and detailed report will be collected automatically.
https://github.com/microsoft/SdnDiagnostics/assets/18577812/60dad4b7-1569-4d0a-9969-22ea2afa3e33
To see full list of parameters supported with each function, review https://github.com/microsoft/SdnDiagnostics/wiki/Debug-SdnFabricInfrastructure and https://github.com/microsoft/SdnDiagnostics/wiki/Get-SdnFabricInfrastructureResult.
Start-SdnDataCollection
Start-SdnDataCollection asists customers and engineers with an automated data collection process. The function will determine the fabric information and collect the appropriate configuration details and logs for the role(s) or computers specified. This log bundle can then be provided to Microsoft CSS for further review. To see a full list of the parameters supported with the function, review https://github.com/microsoft/SdnDiagnostics/wiki/Start-SdnDataCollection.
For more advanced scenarios for data collection, please refer to Gather Network Traces and Logs.