cpp_client_telemetry/docs/cpp-start-linux.md

This tutorial guides you through the process of integrating the 1DS SDK into your existing C++ Linux app or service.

## 1. Clone the repository

Run `git clone https://github.com/microsoft/cpp_client_telemetry.git` to clone the repo. If your project requires UTC to send telemetry, you need to add `--recurse-submodules` when cloning to tell git to add `lib/modules` repo. You will be asked your credentials to clone the repo. Use your username and GitHub token.

## 2. Build all

### Ubuntu and other Debian-based distros

Run `build.sh` script in the root folder of the source tree. This will fetch the necessary build tools and build the SDK. You may be prompted for root password in order to install the build package.

### RedHat / CentOS distros

Run `source build-rhel.sh` then run `build.sh`. Older versions of RedHat require devtoolset-7 or above. devtoolset-7 - Developer Toolset is designed for developers working on CentOS or Red Hat Enterprise Linux platform. It provides current versions of the GNU Compiler Collection, GNU Debugger, and other development, debugging, and performance monitoring tools.

### Using Docker for builds

Docker on Windows can be used to build SDK in Docker image. Please refer to `build-docker.cmd` for details.

## 3. Integrate the SDK into your C++ project

SDK package contains headers and library installed at the following locations:

* Headers: /usr/local/include/mat
* Library: /usr/local/lib/${arch}/libmat.a

1DS SDK is built using cmake, but you can explore building it with any other build system of your choice.


## 4. Instrument your code to send a telemetry event

1. Include the main 1DS SDK header file in your main.cpp by adding the following statement to the top of your app's implementation file.

	```
    #include "LogManager.hpp"
	```
    
2. Use namespace by adding the following statement after your include statements at the top of your app's implementation file.

    ```
    using namespace Microsoft::Applications::Events; 
    ```

3. Create the default LogManager instance for your project using the following macro in your main file:

	```
    LOGMANAGER_INSTANCE
    ```

4. Initialize the SDK, create and send a telemetry event, and then flush the event queue and shut down the telemetry
logging system by adding the following statements to your main() function.

    ```
    ILogger* logger = LogManager::Initialize("0123456789abcdef0123456789abcdef-01234567-0123-0123-0123-0123456789ab-0123");
    logger->LogEvent("My Telemetry Event");
    ...
    LogManager::FlushAndTeardown();
    ```

    **Note** For more advanced usage (control of the telemetry system), use *LogManagerProvider**.
    {: .bg-info }

    **Important!** Replace the place-holder application key value with the actual value of your application key.
    {: .bg-info }

*You're done! You can now compile and run your app, and it will send a telemetry event.*