C++ SDK の次のことを知っている必要があります。

• アプリケーションスレッド内で動作し、新しいスレッドを生成しません。
• すべてのイベントデータをメモリに保持し、ディスクには保持しません。
• ネットワーク インターフェイスに登録する API を提供します。
• アプリケーションの HTTPS スタックを使用して EUM サーバと通信します。
• SDK ログメッセージを取得する API を提供します。アプリケーション開発者は、ログメッセージを stderr またはログファイルに書き込むことによってログを管理する必要があります。
• 静的にリンクされているオープンソースの json-c ライブラリを使用します。
• スレッドセーフではない同期ブロック API コールを発信します。スレッドセーフコールはアプリケーション開発者が発信します。

開始する前に、次の要件を満たしていることを確認します。

• 32/64 ビットアーキテクチャ用の GNU C++ コンパイラ（g++）バージョン 4.2
• glibc 2.20 以降をベースとする Linux ディストリビューション
• ビーコンを EUM クラウドに送信するための HTTPS スタック
• EUM アプリケーションキー

C++ SDK は、GitHub から IoT C++ SDK を複製またはダウンロードすることによって取得できます。「Installation」に記載されている手順に従って、IoT C++ SDK をビルドします。

IoT C++ SDK のアップグレード

GitHub にある IoT C++ SDK のクローンのルートディレクトリで、次のようにします。

• 次のリポジトリを更新します。 $ git pull origin master
• 「Installation」に記載されている手順に従って、IoT C++ SDK を再構築します。

C++ SDK は tar zip ファイルとしてパッケージ化されていて、以下が含まれています。

• include：C++ SDK で使用するパブリック API のヘッダーが格納されているディレクトリ
• lib：C++ SDK の共有オブジェクトファイルが格納されているディレクトリ

SDK ヘッダーファイルが含まれている include ディレクトリをアプリケーション ディレクトリにコピーまたは移動し、SDK API にアクセスするためにコードに含めます。

#include "appd_iot_interface.h"
....
{

次に示すように、SDK とデバイスの構成を入力パラメータとして指定し、関数 appd_iot_init_sdk を呼び出すことにより、C++ SDK を初期化する必要があります。SDK の構成は、アプリケーションキー、ログレベル、および EUM コレクタ URL のパラメータを取得します。SDK は EUM コレクタ URL を使用して EUM サーバにデータを送信します。デバイス構成には、一意のデバイスを識別するための情報が含まれています。

#include "appd_iot_interface.h"
....
{
// Declare config variables for the SDK and device.
appd_iot_sdk_config_t sdkcfg;
appd_iot_device_config_t devcfg;
appd_iot_init_to_zero(&sdkcfg, sizeof(sdkcfg));
appd_iot_init_to_zero(&devcfg, sizeof(devcfg));
// Set the initialization configurations for the SDK
sdkcfg.appkey = "<EUM_APP_KEY>";
// Set the device configurations
devcfg.device_id = "1111";
devcfg.device_type = "SmartCar";
devcfg.device_name = "AudiS3";
// Initialize the instrumentation
appd_iot_init_sdk(sdkcfg, devcfg);
}

SDK には、EUM サーバにイベントを送信するための HTTPS インターフェイスが必要です。アプリケーション開発者は、SDK が HTTPS リクエストを実行するためのコールバック関数を指定する必要があります。libcurl を使用するネットワーク インターフェイスの実装例については、「サンプルアプリケーションの実行」を参照してください。

#include "appd_iot_interface.h"
....
{
appd_iot_http_cb_t http_cb;
//Callback function triggered by SDK to send http request and receive http response
http_cb.http_req_send_cb = &your_network_interface_send_cb;
//Callback function triggered by SDK to indicate completion of http response processing
http_cb.http_resp_done_cb = &your_network_interface_resp_done_cb;
//register http interface callbacks
appd_iot_register_network_interface(http_cb);
...
}

さまざまなタイプのイベントを理解するために、 以下のセクションに示すスマートカー IoT アプリケーションの例を使用します。

カスタム イベント

「SmartCar」の技術的な統計情報をキャプチャするカスタムイベント。

#include "appd_iot_interface.h"
....
{
appd_iot_custom_event_t custom_event;
appd_iot_init_to_zero(&custom_event, sizeof(custom_event));
custom_event.type = "SmartCar Stats";
custom_event.summary = "Technical Stats of SmartCar";
custom_event.timestamp_ms = ((int64_t)time(NULL) * 1000);
custom_event.data = (appd_iot_data_t*)calloc(2, sizeof(appd_iot_data_t));
appd_iot_data_set_integer(&custom_event.data[0], "Speed mph", 65);
appd_iot_data_set_double(&custom_event.data[1], "Oil Temperature", 220);
appd_iot_add_custom_event(custom_event);
free(custom_event.data);
....
appd_iot_send_all_events();
}

ネットワーク リクエスト イベント

HTTPS コールのパフォーマンスをキャプチャして天気情報を取得するネットワーク リクエスト イベント。

#include "appd_iot_interface.h"
....
{
appd_iot_network_request_event_t network_event;
appd_iot_init_to_zero(&network_event, sizeof(network_event));
network_event.url = "https://apdy.api/weather";
network_event.resp_code = 202;
network_event.duration_ms = 10;
network_event.req_content_length = 300;
network_event.req_content_length = 100;
network_event.timestamp_ms = ((int64_t)time(NULL) * 1000);
network_event.data = (appd_iot_data_t*)calloc(1, sizeof(appd_iot_data_t));
appd_iot_data_set_string(&network_event.data[0], "city", "San Francisco");
appd_iot_add_network_request_event(network_event);
free(network_event.data);
....
appd_iot_send_all_events();
}

error イベント

次のエラーイベントは、SmartCar アプリケーションで Bluetooth エラーをキャプチャするために使用されます。

#include "appd_iot_interface.h"
....
{
appd_iot_error_event_t error_event;
appd_iot_init_to_zero(&error_event, sizeof(error_event));
error_event.name = "Bluetooth Connection Error";
error_event.message = "connection dropped due to bluetooth exception";
error_event.severity = APPD_IOT_ERR_SEVERITY_CRITICAL;
error_event.timestamp_ms = ((int64_t)time(NULL) * 1000);
error_event.data = (appd_iot_data_t*)calloc(1, sizeof(appd_iot_data_t));
appd_iot_data_set_integer(&error_event.data[0], "Bluetooth Error Code", 43);
appd_iot_add_error_event(error_event);
free(error_event.data);
....
appd_iot_send_all_events();
}

IoT アプリケーションがコントローラにデータをレポートしたことの確認IoT アプリケーションがコントローラにデータをレポートしたことの確認

 IoT C++ SDK を使用して、IoT C++ インストゥルメンテーションをさらにカスタマイズできます。最新の IoT C++ SDK ドキュメント、または以下に記載されている以前のバージョンを参照してください。

• https://sdkdocs.appdynamics.com/javadocs/iot-cpp-sdk/4.5/4.5.0/
• https://sdkdocs.appdynamics.com/javadocs/iot-cpp-sdk/4.5/4.5.1/
• https://sdkdocs.appdynamics.com/javadocs/iot-cpp-sdk/4.5/4.5.2/
• https://sdkdocs.appdynamics.com/javadocs/iot-cpp-sdk/4.5/4.5.4/

サンプル C++ アプリケーションは、カスタム、ネットワークリクエスト、およびエラーイベントのサンプルデータを送信します。データは、スマート カー アプリケーションをモックし、使用状況情報、ネットワークパフォーマンス、およびエラーをキャプチャします。

サンプルアプリケーションを実行するには、「Sample Application using IoT C++ SDK」に記載されている手順に従います。