Update README.md

Author: jmichaelis

README.md

@@ -13,16 +13,72 @@ http://www.stackify.com/sign-up/
 ## Standalone logger
 Install the latest version with `composer require stackify/logger`
 
+There are three different transport options that can be configured to send data to Stackify.  Below will show how to implement the different transport options:
+
+### <a name="transport"></a>Transport options:
+
+
+- <b>ExecTransport</b> does not require Stackify agent to be installed because it sends data directly to Stackify services. It collects log entries in a single batch, calls curl using the ```exec``` function, and sends it to the background immediately [```exec('curl ... &')```]. This will affect the performance of your application minimally, but it requires permissions to call ```exec``` inside the PHP script and it may cause silent data loss in the event of any network issues. This transport method does not work on Windows. To configure ExecTransport you need to pass the environment name and API key (license key):
+    ```php
+    use Stackify\Log\Transport\ExecTransport;
+    use Stackify\Log\Monolog\Handler as StackifyHandler;
+    
+    $transport = new ExecTransport('api_key');
+    $handler = new StackifyHandler('application_name', 'environment_name', $transport);
+    ```
+    ```yml
+    # or configuration file example
+    services:
+        stackify_transport:
+            class: "Stackify\\Log\\Transport\ExecTransport"
+            arguments: ["api_key"]
+        stackify_handler:
+            class: "Stackify\\Log\\Monolog\\Handler"
+            arguments: ["application_name", "environment_name", "@stackify_transport"]
+    ```
+### Configuration
+##### Proxy
+ExecTransport and CurlTransport support data delivery through proxy. Specify proxy using [libcurl format](http://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html): <[protocol://][user:password@]proxyhost[:port]>
+```php
+$transport = new ExecTransport($apiKey, ['proxy' => 'https://55.88.22.11:3128']);
+```
+##### Curl path
+It can be useful to specify ```curl``` destination path for ExecTransport. This option is set to 'curl' by default.
+```php
+$transport = new ExecTransport($apiKey, ['curlPath' => '/usr/bin/curl']);
+```
+- <b>CurlTransport</b> does not require a Stackify agent to be installed and it also sends data directly to Stackify services. It collects log entries in a single batch and sends data using native [PHP cURL](http://php.net/manual/en/book.curl.php) functions. This way is a blocking one, so it should not be used on production environments. To configure CurlTransport you need to pass environment name and API key (license key):
+    ```php
+    use Stackify\Log\Transport\CurlTransport;
+    use Stackify\Log\Monolog\Handler as StackifyHandler;
+    
+    $transport = new CurlTransport('api_key');
+    $handler = new StackifyHandler('application_name', 'environment_name', $transport);
+    ```
+    ```yml
+    # or configuration file example
+    services:
+        stackify_transport:
+            class: "Stackify\\Log\\Transport\CurlTransport"
+            arguments: ["api_key"]
+        stackify_handler:
+            class: "Stackify\\Log\\Monolog\\Handler"
+            arguments: ["application_name", "environment_name", "@stackify_transport"]
+    ```
+###Configuration
+#### Proxy
+ExecTransport and CurlTransport support data delivery through proxy. Specify proxy using [libcurl format](http://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html): <[protocol://][user:password@]proxyhost[:port]>
+```php
+$transport = new CurlTransport($apiKey, ['proxy' => 'https://55.88.22.11:3128']);
+```
+
+- <b>AgentTransport</b> does not require additional configuration on PHP side because all data is passed to the [Stackify agent](https://stackify.screenstepslive.com/s/3095/m/7787/l/119709-installation-for-linux), which must be installed on the same machine. Local TCP socket is used, so performance of your application is affected minimally.
+
+## Troubleshooting
+If transport does not work, try looking into ```vendor\stackify\logger\src\Stackify\debug\log.log``` file (if it is available for writing). Errors are also written to global PHP [error_log](http://php.net/manual/en/errorfunc.configuration.php#ini.error-log).
+Note that ExecTransport does not produce any errors at all, but you can switch it to debug mode:
 ```php
-use Stackify\Log\Standalone\Logger;
-
-$logger = new Logger('appname.com');
-$logger->warning('something happened');
-try {
-    $db->connect();
-catch (DbException $ex) {
-    $logger->error('DB is not available', ['ex' => $ex]);
-}
+$transport = new ExecTransport($apiKey, ['debug' => true]);
 ```
 
 By default handler requires [Stackify agent](https://stackify.screenstepslive.com/s/3095/m/7787/l/119709-installation-for-linux) to be running.