Skip to content

bryan-lipinski/cpp_client_telemetry

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

1DS C/C++ SDK

spellcheck

1DS C/C++ SDK enables cross-platform telemetry collection from various Microsoft products. It enables data / telemetry upload to Collector++.

1DS (One Data Strategy), also known as One Observability, is a cross-org initiative with five teams across the company coming together to unify multiple telemetry efforts at Microsoft. This includes the teams that built Asimov, Aria, Shared Data Platform, Geneva, OMS, Azure Monitor, and Visual Studio App Center. We aim to create a unified data collection, ingestion, pipeline, and set of tools for key scenarios for the entire company.

Collector++ is the externally-facing destination end-point where telemetry data is uploaded to that subsequently routes the data to Microsoft internal data pipeline.

Getting Started

The SDK is released as a source package every month, following the milestones. There is no plan to release prebuilt binaries.

Build

Platform specific build instructions:

Other resources to learn how to setup the build system:

  • Review how our cross-platform build system is implemented using GitHub Actions infrastructure.
  • Check the build scripts located in workspace root.

Build Environments

Operating System Compiler
Mac OS X 10.11.6 Clang Xcode 8.3
Mac OS X 10.12.6 Clang Xcode 9.0, 9.1
Mac OS X 10.13.3 Clang Xcode 9.2, 9.3, 10.0, 10.1
Raspbian GNU/Linux 8 (jessie) GCC 4.9.2 (armv7l)
Ubuntu 14.04.x LTS GCC 5.x.x
Ubuntu 16.04 LTS GCC 5.x.x, GCC 5.x.x (armv7l)
Ubuntu 18.04 LTS GCC 7.5.x
Windows 10 Android Studio/Gradle
Windows Server 2016 Visual Studio 2017 (vc141)
Windows Server 2019 Visual Studio 2019 (vc142)

Target Platforms

Target Platform Supported Covered by CI
Android
iOS 10+ (simulator)
iOS 10+ (arm64, arm64e)
Linux (x86, x64, arm, aarch64)
Mac OS X 10.11+
Mac OS X (latest)
Ubuntu 14.04.x LTS
Ubuntu 16.04.x LTS
Ubuntu 18.04.x LTS
Ubuntu (latest)
Windows 7.1
Windows 8.1
Windows 10.x
Windows Server 2012
Windows Server 2016
Windows Server 2019
  • Supported - these platforms are known to work well with the SDK in production.
  • Covered by CI - these platforms are tested as part of CI.

Test

There are two sets of tests available:

  • tests/unittests - unit tests that verify operation of each individual component.
  • tests/functests - functional tests that verify customer-facing APIs and features, they also cover the flow of data to Collector++.

These tests use Google Test / Google Mock framework and get built alongside the SDK. Launch functests and unittests binary executables to capture the test results.

Getting Support

Microsoft products using SDK may use GitHub issues as the communication channel for both feature requests and issues.

Note:

  • Please refer to the supported platforms, anything not in the list should be treated as a feature request.
  • Only C and C++ API surface is supported - any other language wrappers are provided as-is, and not supported.
  • Build issues are in general out of the support scope due to the unlimited number of build flags combinations.

Contributing

This project does not accept Public contributions at this time.

Microsoft-authorized contributors - please refer to contributing instructions here.

Versioning

This library follows Semantic Versioning.

License

By contributing to 1DS C++ SDK repository, you agree that your contributions will be licensed under Apache License 2.0.

About

1DS C++ SDK

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 80.3%
  • C++ 14.5%
  • Java 1.5%
  • C# 0.8%
  • Assembly 0.6%
  • Objective-C++ 0.4%
  • Other 1.9%