From b528e31668b99e90cd498fc37a5c850c764c6d7d Mon Sep 17 00:00:00 2001 From: Sergey Kanzhelev Date: Wed, 5 Sep 2018 14:13:39 -0700 Subject: [PATCH] few fixes before release --- CHANGELOG.md | 2 +- README.md | 63 ++++++++++++++++++++++++++++++++++++++-------------- 2 files changed, 47 insertions(+), 18 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8ffd12c..9ec04a6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,12 +2,12 @@ ## 0.4.4 +- Initialize `name` and operation id for requests telemetry. - Updated to the latest schemas. Few properties are no longer available. - Enum `Dependency_Type` and `async` argument of `TrackDependency` were removed. - New event type `Availability_Data`. - Use `Cloud` context instead of `Device` context to set role name and role instance of an application. - ## 0.4.3 - Support tracking Throwable and Error, not only Exceptions. diff --git a/README.md b/README.md index 5a9b4ab..92a9ef3 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,23 @@ -# Application Insights for PHP # +# Application Insights for PHP [![Build Status](https://travis-ci.org/Microsoft/ApplicationInsights-PHP.svg?branch=master)](https://travis-ci.org/Microsoft/ApplicationInsights-PHP) [![Packagist Pre Release](https://img.shields.io/packagist/vpre/microsoft/application-insights.svg)](https://packagist.org/packages/microsoft/application-insights) +This project extends the Application Insights API surface to support PHP. +[Application +Insights](http://azure.microsoft.com/services/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 project extends the Application Insights API surface to support PHP. [Application Insights](http://azure.microsoft.com/en-us/services/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. - -## Requirements ## +## Requirements PHP version >=5.4.2 is supported. For opening the project in Microsoft Visual Studio you will need [PHP Tools for Visual Studio](http://www.devsense.com/products/php-tools). This is not required however. -## Installation ## +## Installation We've published a package you can find on [Packagist](https://packagist.org/packages/microsoft/application-insights). In order to use it, first, you'll need to get [Composer](https://getcomposer.org/). @@ -28,14 +33,15 @@ Make sure you add the require statement to pull in the library: require_once 'vendor/autoload.php'; ``` -## Usage ## +## Usage 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](https://github.com/Microsoft/AppInsights-Home/wiki#getting-an-application-insights-instrumentation-key) section for more information. +**Initializing the client and setting the instrumentation key and other optional +configurations** -**Initializing the client and setting the instrumentation key and other optional configurations** ```php $telemetryClient = new \ApplicationInsights\Telemetry_Client(); $context = $telemetryClient->getContext(); @@ -56,25 +62,31 @@ $telemetryClient->flush(); **Setup Operation context** -For correct Application Insights reporting you need to setup Operation Context, reference to Request +For correct Application Insights reporting you need to setup Operation Context, +reference to Request + ```php $telemetryClient->getContext()->getOperationContext()->setId('XX'); $telemetryClient->getContext()->getOperationContext()->setName('GET Index'); ``` **Sending a simple event telemetry item with event name** + ```php $telemetryClient->trackEvent('name of your event'); $telemetryClient->flush(); ``` **Sending an event telemetry item with custom properties and measurements** + ```php $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()** +**Sending more than one telemetry item before sending to the service is also +supported; the API will batch everything until you call flush()** + ```php $telemetryClient->trackEvent('name of your event'); $telemetryClient->trackEvent('name of your second event'); @@ -82,48 +94,60 @@ $telemetryClient->flush(); ``` **Sending a simple page view telemetry item with page name and url** + ```php $telemetryClient->trackPageView('myPageView', 'http://www.foo.com'); $telemetryClient->flush(); ``` -**Sending a page view telemetry item with duration, custom properties and measurements** +**Sending a page view telemetry item with duration, custom properties and +measurements** + ```php $telemetryClient->trackPageView('myPageView', 'http://www.foo.com', 256, ['InlineProperty' => 'test_value'], ['duration' => 42.0]); $telemetryClient->flush(); ``` **Sending a simple metric telemetry item with metric name and value*** + ```php $telemetryClient->trackMetric('myMetric', 42.0); $telemetryClient->flush(); ``` -**Sending a metric telemetry item with point type, count, min, max, standard deviation and measurements** +**Sending a metric telemetry item with point type, count, min, max, standard +deviation and measurements** + ```php $telemetryClient->trackMetric('myMetric', 42.0, \ApplicationInsights\Channel\Contracts\Data_Point_Type::Aggregation, 5, 0, 1, 0.2, ['InlineProperty' => 'test_value']); $telemetryClient->flush(); ``` -**Sending a simple message telemetry item with message*** +**Sending a simple message telemetry item with message** + ```php $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*** +**Sending a simple request telemetry item with request name, url and start +time** + ```php $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** +**Sending a request telemetry item with duration, http status code, whether or +not the request succeeded, custom properties and measurements** + ```php $telemetryClient->trackRequest('myRequest', 'http://foo.bar', time(), 3754, 200, true, ['InlineProperty' => 'test_value'], ['duration_inner' => 42.0]); $telemetryClient->flush(); ``` **Sending an exception telemetry, with custom properties and metrics** + ```php try { @@ -132,17 +156,18 @@ try catch (\Exception $ex) { $telemetryClient->trackException($ex, ['InlineProperty' => 'test_value'], ['duration_inner' => 42.0]); - $telemetryClient->flush(); + $telemetryClient->flush(); } - ``` **Set the Client to gzip the data before sending** + ```php $telemetryClient->getChannel()->setSendGzipped(true); ``` **Registering an exception handler** + ```php class Handle_Exceptions { @@ -151,7 +176,7 @@ class Handle_Exceptions public function __construct() { $this->_telemetryClient = new \ApplicationInsights\Telemetry_Client(); - $this->_telemetryClient->getContext()->setInstrumentationKey('YOUR INSTRUMENTATION KEY'); + $this->_telemetryClient->getContext()->setInstrumentationKey('YOUR INSTRUMENTATION KEY'); set_exception_handler(array($this, 'exceptionHandler')); } @@ -168,24 +193,28 @@ class Handle_Exceptions ``` **Sending a successful SQL dependency telemetry item** + ```php $telemetryClient->trackDependency('Query table', "SQL", 'SELECT * FROM table;', time(), 122, true); $telemetryClient->flush(); ``` **Sending a failed HTTP dependency telemetry item** + ```php $telemetryClient->trackDependency('method', "HTTP", "http://example.com/api/method", time(), 324, false, 503); $telemetryClient->flush(); ``` **Sending any other kind dependency telemetry item** + ```php $telemetryClient->trackDependency('Name of operation', "service", 'Arguments', time(), 23, true); $telemetryClient->flush(); ``` **Changing the operation id (which links actions together)** + ```php $telemetryClient->trackMetric('interestingMetric', 10); $telemetryClient->getContext()->getOperationContext()->setId(\ApplicationInsights\Channel\Contracts\Utils::returnGuid())