diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..bb2cf8e --- /dev/null +++ b/FAQ.md @@ -0,0 +1,16 @@ +## What is ai.0.js? +This file contains a minified JavaScript SDK script. The snippet that you put on your website has a very limited functionality to keep it as small as possible. The snippet will queue all events and download the full SDK script (ai.0.js). Once the full script is downloaded, it will replace the `window.appInsights` object and send all queued telemetry. + + +## Can I use a local copy of ai.0.js? +We recommend downloading it from a default location (https://az416426.vo.msecnd.net/scripts/a/ai.0.js), which leverages Azure CDN to deliver the script fast. But it is possible to use a local copy, see [`url` config](https://github.com/Microsoft/ApplicationInsights-JS/blob/master/API-reference.md#config). Please keep in mind that you will need to update it manually if you want to receive the latest features. + + +## How do I exclude parts of telemetry from sending? +The easiest way is to write your own [telemetryInitializer](https://github.com/Microsoft/ApplicationInsights-JS/blob/master/API-reference.md#addtelemetryinitializer) which will modify your data. TelemetryInitializer can also block data from sending. + + +## Something weird is going on... How do I debug the JS SDK? +To make the debugging process easier you can `enableDebug` mode and turn on the `verboseLogging` (see [config](https://github.com/Microsoft/ApplicationInsights-JS/blob/master/API-reference.md#config)). + +You can also use an un-minified version of the JS SDK script [ai.js](https://az416426.vo.msecnd.net/scripts/a/ai.js). The easiest way to use it is to temporarily change snippet to load the `ai.js` file instead of `ai.0.js`