Application Insights SDK support guidance
Microsoft announces feature deprecations or breaking changes at least one year in advance and strives to provide a seamless process for migration to the replacement experience.
For more information, review the Azure SDK Lifecycle and Support Policy.
Note
Diagnostic tools often provide better insight into the root cause of a problem when the latest stable SDK version is used.
SDK update guidance
Support engineers are expected to provide SDK update guidance according to the following table, referencing the current SDK version in use and any alternatives.
| Current SDK version in use | Alternative version available | Update policy for support |
|---|---|---|
| Latest GA SDK | Newer preview version available | NO UPDATE NECESSARY |
| GA SDK | Newer GA released < one year ago | UPDATE RECOMMENDED |
| GA SDK | Newer GA released > one year ago | UPDATE REQUIRED |
| Unsupported (support policy) | Any supported version | UPDATE REQUIRED |
| Latest Preview | No newer version available | NO UPDATE NECESSARY |
| Latest Preview | Newer GA SDK | UPDATE REQUIRED |
| Preview | Newer preview version | UPDATE REQUIRED |
Note
- General Availability (GA) refers to non-beta versions.
- Preview refers to beta versions.
Tip
Switching to autoinstrumentation eliminates the need for manual SDK updates.
Warning
Only commercially reasonable support is provided for Preview versions of the SDK. If a support incident requires escalation to development for further guidance, customers will be asked to use a fully supported SDK version to continue support. Commercially reasonable support does not include an option to engage Microsoft product development resources; technical workarounds may be limited or not possible.
Release notes
Reference the release notes to see the current version of Application Insights SDKs and previous versions release dates.
Our Service Updates also summarize major Application Insights improvements.