This project extends the Application Insights API surface to support PHP. Application Insights is a service that allows developers to keep their application available, performing and succeeding. This PHP module will allow you to send telemetry of various kinds (event, trace, exception, etc.) to the Application Insights service where they can be visualized in the Azure Portal.
This SDK is NOT maintained or supported by Microsoft even though we've contributed to it in the past. Note that Azure Monitor only provides support when using the supported SDKs. We’re constantly assessing opportunities to expand our support for other languages, so follow our GitHub Announcements page to receive the latest SDK news.
PHP version >=5.4.2 is supported.
For opening the project in Microsoft Visual Studio you will need PHP Tools for Visual Studio. This is not required however.
We've published a package you can find on Packagist. In order to use it, first, you'll need to get Composer.
Once you've setup your project to use Composer, just add a reference to our package with whichever version you'd like to use to your composer.json file.
require: "microsoft/application-insights": "*"Or you can use the composer command to automatically add the package to your composer.json file.
composer require microsoft/application-insightsMake sure you add the require statement to pull in the library:
require_once 'vendor/autoload.php';Once installed, you can send telemetry to Application Insights. Here are a few samples.
Note: before you can send data to you will need an instrumentation key. Please see the Getting an Application Insights Instrumentation Key section for more information.
$telemetryClient = new \ApplicationInsights\Telemetry_Client();
$context = $telemetryClient->getContext();
// Necessary
$context->setInstrumentationKey('YOUR INSTRUMENTATION KEY');
// Optional
$context->getSessionContext()->setId(session_id());
$context->getUserContext()->setId('YOUR USER ID');
$context->getApplicationContext()->setVer('YOUR VERSION');
$context->getLocationContext()->setIp('YOUR IP');
// Start tracking
$telemetryClient->trackEvent('name of your event');
$telemetryClient->flush();For correct Application Insights reporting you need to setup Operation Context, reference to Request
$telemetryClient->getContext()->getOperationContext()->setId('XX');
$telemetryClient->getContext()->getOperationContext()->setName('GET Index');$telemetryClient->trackEvent('name of your event');
$telemetryClient->flush();$telemetryClient->trackEvent('name of your event', ['MyCustomProperty' => 42, 'MyCustomProperty2' => 'test'], ['duration', 42]);
$telemetryClient->flush();Sending more than one telemetry item before sending to the service is also supported; the API will batch everything until you call flush()
$telemetryClient->trackEvent('name of your event');
$telemetryClient->trackEvent('name of your second event');
$telemetryClient->flush();$telemetryClient->trackPageView('myPageView', 'http://www.foo.com');
$telemetryClient->flush();$telemetryClient->trackPageView('myPageView', 'http://www.foo.com', 256, ['InlineProperty' => 'test_value'], ['duration' => 42.0]);
$telemetryClient->flush();$telemetryClient->trackMetric('myMetric', 42.0);
$telemetryClient->flush();Sending a metric telemetry item with point type, count, min, max, standard deviation and measurements
$telemetryClient->trackMetric('myMetric', 42.0, \ApplicationInsights\Channel\Contracts\Data_Point_Type::Aggregation, 5, 0, 1, 0.2, ['InlineProperty' => 'test_value']);
$telemetryClient->flush();$telemetryClient->trackMessage('myMessage', \ApplicationInsights\Channel\Contracts\Message_Severity_Level::INFORMATION, ['InlineProperty' => 'test_value']);
$telemetryClient->flush();Sending a simple request telemetry item with request name, url and start time
$telemetryClient->trackRequest('myRequest', 'http://foo.bar', time());
$telemetryClient->flush();Sending a request telemetry item with duration, http status code, whether or not the request succeeded, custom properties and measurements
$telemetryClient->trackRequest('myRequest', 'http://foo.bar', time(), 3754, 200, true, ['InlineProperty' => 'test_value'], ['duration_inner' => 42.0]);
$telemetryClient->flush();try
{
// Do something to throw an exception
}
catch (\Exception $ex)
{
$telemetryClient->trackException($ex, ['InlineProperty' => 'test_value'], ['duration_inner' => 42.0]);
$telemetryClient->flush();
}$telemetryClient->getChannel()->setSendGzipped(true);class Handle_Exceptions
{
private $_telemetryClient;
public function __construct()
{
$this->_telemetryClient = new \ApplicationInsights\Telemetry_Client();
$this->_telemetryClient->getContext()->setInstrumentationKey('YOUR INSTRUMENTATION KEY');
set_exception_handler(array($this, 'exceptionHandler'));
}
function exceptionHandler(\Exception $exception)
{
if ($exception != NULL)
{
$this->_telemetryClient->trackException($exception);
$this->_telemetryClient->flush();
}
}
}$telemetryClient->trackDependency('Query table', "SQL", 'SELECT * FROM table;', time(), 122, true);
$telemetryClient->flush();$telemetryClient->trackDependency('method', "HTTP", "http://example.com/api/method", time(), 324, false, 503);
$telemetryClient->flush();$telemetryClient->trackDependency('Name of operation', "service", 'Arguments', time(), 23, true);
$telemetryClient->flush();$telemetryClient->trackMetric('interestingMetric', 10);
$telemetryClient->getContext()->getOperationContext()->setId(\ApplicationInsights\Channel\Contracts\Utils::returnGuid())
$telemetryClient->trackMetric('differentOperationMetric', 11);
$telemetryClient->flush();This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent