Download the PHP package marchie/ms-application-insights-laravel without Composer
On this page you can find all versions of the php package marchie/ms-application-insights-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download marchie/ms-application-insights-laravel
More information about marchie/ms-application-insights-laravel
Files in marchie/ms-application-insights-laravel
Package ms-application-insights-laravel
Short Description Microsoft Azure Application Insights for Laravel 5
License MIT
Informations about the package ms-application-insights-laravel
Microsoft Application Insights for Laravel 5
A simple Laravel implementation for Microsoft Application Insights
Installation
Update the require
section of your application's composer.json file:
Instrumentation Key
The package will check your application's .env file for your Instrumentation Key.
Add the following to your .env file:
You can find your instrumentation key on the Microsoft Azure Portal.
Navigate to:
Microsoft Azure > Browse > Application Insights > (Application Name) > Settings > Properties
On Laravel versions without Auto-Discovery (< 5.5):
Service Provider
Add the service provider to the providers array in your application's config/app.php file:
Facade
Add the facades to the aliases array in your application's config/app.php file:
Usage
Request Tracking Middleware
To monitor your application's performance with request tracking, add the middleware to your in your application, found in app/Http/Kernel.php. It has to be added after the StartSession middleware has been added.
The request will send the following additional properties to Application Insights:
- ajax (boolean): true if the request is an AJAX request
- ip (string): The client's IP address
- pjax (boolean): true if the request is a PJAX request
- secure (boolean): true if the request was sent over HTTPS
- route (string): The name of the route, if applicable
- user (integer): The ID of the logged in user, if applicable
- referer (string): The HTTP_REFERER value from the request, if available
The middleware is also used to estimate the time that a user has spent on a particular page. This is sent as a trace event named browse_duration.
Exception Handler
To report exceptions that occur in your application, use the provided exception handler. Replace the following line in your application's app/Handlers/Exception.php file:
The exception handler will send additional properties to Application Insights, as above.
Client Side
In order to register page view information from the client with Application Insights, simply insert the following code into your Blade views:
NOTE: Microsoft recommend that you put the script in the <head>
section of your pages, in order to calculate the fullest extent of page load time on the client.
Custom
If you want to use any of the underlying ApplicationInsights-PHP functionality, you can call the methods directly from the server facade:
See the ApplicationInsights-PHP page for more information on the available methods.
Version History
0.2.4
- Added try/catch blocks when flushing data to prevent RequestExceptions from killing the application if there is a problem connecting to Application Insights.
0.2.3
- Corrected dingus mistake!
0.2.2
- Added additional properties to exceptions
- Removed auto-flushing shutdown function
0.2.1
- Flush queue on exception (otherwise, if Laravel is daemonized, queue exceptions will not be reported)
0.2.0
- Server side implementation
0.1.2
- Correcting silly mistake!
0.1.1
- Empty key no longer results in an exception being thrown (no JavaScript is inserted into the view)
0.1.0
- Client-side JavaScript only
All versions of ms-application-insights-laravel with dependencies
illuminate/config Version ~5.0
illuminate/support Version ~5.0
laravel/framework Version ~5.0
microsoft/application-insights Version ^0.3.0