{"id":12131,"date":"2024-12-26T19:38:14","date_gmt":"2024-12-26T19:38:14","guid":{"rendered":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/t2-0_common_library_apis\/"},"modified":"2025-03-25T05:18:32","modified_gmt":"2025-03-25T05:18:32","slug":"t2-0_common_library_apis","status":"publish","type":"page","link":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/device_management\/xconf\/telemetry_2-0\/t2-0_common_library_apis\/","title":{"rendered":"T2.0 Common Library APIs"},"content":{"rendered":"\n
\n
\n
\n
\n

Introduction<\/h2><\/div>\n<\/div>\n<\/div>\n
\n
\n
\n

T2.0 Shared Library will be used by Components that wish to report Telemetry metrics. This library and its APIs will allow migration away from the current mechanism for Telemetry that uses log message and grepping (via DCA) to report Component Metrics and information. <\/span>This library will insulate Components from needing to know the underlying BUS\/IPC used on the device; the T2 Common Library will use RBUS as its platform agnostic IPC, but can use CCSP directly in RDK-B. <\/span><\/p>

NOTE:  The DCA and grepping mechanism will continue to exist in order to support ad-hoc reporting of device\/component information.  However, going forward, Components will be migrated to use the T2.0 Shared Library to report Telemetry data in order to reduce the need for grepping on devices. Porting all Components to use T2.0 is outside the scope of the T2.0 team, but will be accomplished via Jira tickets and working closely with Component owners once the T2.0 MVP for DCA port is complete and proven.<\/span><\/p>

<\/div>\n<\/div>\n<\/div>\n
\n
\n
\n

T2 Common Library<\/h2>

Telemetry APIs – for use by Components wishing to report metrics\/data:<\/p>

t2_init( char* component) – init BUS\/IPC for component<\/p>

t2_event_s(char* marker, char* value) – send marker with string value to T2<\/p>

t2_event_f(char* marker, double value) – send marker with double value to T2<\/p>

t2_event_d(char* marker, int value) – send marker with int value to T2<\/p>

Usage:<\/p>