0fe3a37924
This patch adds functionality to create a JSON message in order to send it to a client socket. When stats are requested by a client, they are retrieved from the metrics library and encoded in JSON format. Signed-off-by: Ciara Power <ciara.power@intel.com> Signed-off-by: Brian Archbold <brian.archbold@intel.com> Signed-off-by: Kevin Laatz <kevin.laatz@intel.com> Acked-by: Harry van Haaren <harry.van.haaren@intel.com>
67 lines
1.3 KiB
C
67 lines
1.3 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright(c) 2018 Intel Corporation
|
|
*/
|
|
|
|
#include <stdint.h>
|
|
|
|
#ifndef _RTE_TELEMETRY_H_
|
|
#define _RTE_TELEMETRY_H_
|
|
|
|
/**
|
|
* @file
|
|
* RTE Telemetry
|
|
*
|
|
* The telemetry library provides a method to retrieve statistics from
|
|
* DPDK by sending a JSON encoded message over a socket. DPDK will send
|
|
* a JSON encoded response containing telemetry data.
|
|
***/
|
|
|
|
/**
|
|
* @warning
|
|
* @b EXPERIMENTAL: this API may change without prior notice
|
|
*
|
|
* Initialize Telemetry
|
|
*
|
|
* @return
|
|
* 0 on successful initialisation.
|
|
* @return
|
|
* -ENOMEM on memory allocation error
|
|
* @return
|
|
* -EPERM on unknown error failure
|
|
* @return
|
|
* -EALREADY if Telemetry is already initialised.
|
|
*/
|
|
int32_t __rte_experimental
|
|
rte_telemetry_init(void);
|
|
|
|
/**
|
|
* @warning
|
|
* @b EXPERIMENTAL: this API may change without prior notice
|
|
*
|
|
* Clean up and free memory.
|
|
*
|
|
* @return
|
|
* 0 on success
|
|
* @return
|
|
* -EPERM on failure
|
|
*/
|
|
int32_t __rte_experimental
|
|
rte_telemetry_cleanup(void);
|
|
|
|
/**
|
|
* @warning
|
|
* @b EXPERIMENTAL: this API may change without prior notice
|
|
*
|
|
* Runs various tests to ensure telemetry initialisation and register/unregister
|
|
* functions are working correctly.
|
|
*
|
|
* @return
|
|
* 0 on success when all tests have passed
|
|
* @return
|
|
* -1 on failure when the test has failed
|
|
*/
|
|
int32_t __rte_experimental
|
|
rte_telemetry_selftest(void);
|
|
|
|
#endif
|