NVIDIA DOCA SDK Data Center on a Chip Framework Documentation
doca_telemetry_diag.h File Reference
#include <doca_error.h>
#include <doca_types.h>
Include dependency graph for doca_telemetry_diag.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  doca_telemetry_diag_data_sample_format_0_value
 Output format 0 per-ID struct. More...
 
struct  doca_telemetry_diag_data_sample_format_0
 Output format 0 struct. More...
 
struct  doca_telemetry_diag_data_sample_format_1
 Output format 1 struct. More...
 
struct  doca_telemetry_diag_data_sample_format_2
 Output format 2 struct. More...
 

Typedefs

typedef struct doca_telemetry_diag_data_sample_format_0_value doca_telemetry_diag_data_sample_format_0_value
 Output format 0 per-ID struct. More...
 
typedef struct doca_telemetry_diag_data_sample_format_0 doca_telemetry_diag_data_sample_format_0
 Output format 0 struct. More...
 
typedef struct doca_telemetry_diag_data_sample_format_1 doca_telemetry_diag_data_sample_format_1
 Output format 1 struct. More...
 
typedef struct doca_telemetry_diag_data_sample_format_2 doca_telemetry_diag_data_sample_format_2
 Output format 2 struct. More...
 

Enumerations

enum  doca_telemetry_diag_sync_mode { DOCA_TELEMETRY_DIAG_SYNC_MODE_NO_SYNC = 0 , DOCA_TELEMETRY_DIAG_SYNC_MODE_SYNC_START = 1 }
 Synchronization mode of data sampling. More...
 
enum  doca_telemetry_diag_sample_mode { DOCA_TELEMETRY_DIAG_SAMPLE_MODE_SINGLE = 0 , DOCA_TELEMETRY_DIAG_SAMPLE_MODE_REPETITIVE = 1 , DOCA_TELEMETRY_DIAG_SAMPLE_MODE_ON_DEMAND = 2 }
 description of data sampling mode More...
 
enum  doca_telemetry_diag_timestamp_source { DOCA_TELEMETRY_DIAG_TIMESTAMP_SOURCE_FRC = 0 , DOCA_TELEMETRY_DIAG_TIMESTAMP_SOURCE_RTC = 1 }
 description of the timestamp source of the sample More...
 
enum  doca_telemetry_diag_output_format { DOCA_TELEMETRY_DIAG_OUTPUT_FORMAT_0 = 0 , DOCA_TELEMETRY_DIAG_OUTPUT_FORMAT_1 = 1 , DOCA_TELEMETRY_DIAG_OUTPUT_FORMAT_2 = 2 }
 Defines the layout of the diagnostic data output: More...
 

Functions

DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_is_supported (const struct doca_devinfo *devinfo)
 Check if given device is capable of executing telemetry diagnostics operations. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_get_max_num_data_ids (const struct doca_devinfo *devinfo, uint32_t *max_num_data_ids)
 Get the maximal num of data IDs that is supported by a given device. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_get_log_max_num_samples (const struct doca_devinfo *devinfo, uint8_t *log_max_num_samples)
 Get the maximal num (in log base 2) of samples that is supported by a given device. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_is_data_clear_supported (const struct doca_devinfo *devinfo, uint8_t *data_clear)
 Check if given device supports data clear. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_is_sync_start_supported (const struct doca_devinfo *devinfo, uint8_t *sync_start)
 Check if given device supports sync start. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_is_sample_mode_supported (const struct doca_devinfo *devinfo, enum doca_telemetry_diag_sample_mode sample_mode, uint8_t *sample_mode_supported)
 Check if given device supports a given sample mode. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_cap_is_data_timestamp_source_supported (const struct doca_devinfo *devinfo, enum doca_telemetry_diag_timestamp_source data_timestamp_source, uint8_t *timestamp_source_supported)
 Check if given device supports a given data timestamp source. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_create (struct doca_dev *dev, uint8_t force_ownership, struct doca_telemetry_diag **diag)
 Create a DOCA Telemetry Diagnostics instance. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_destroy (struct doca_telemetry_diag *diag)
 Destroy doca_telemetry_diag previously created by doca_telemetry_diag_create(). More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_apply_config (struct doca_telemetry_diag *diag)
 Apply device configuration. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_start (struct doca_telemetry_diag *diag)
 Start device sampling - trigger device to collect metrics. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_restart (struct doca_telemetry_diag *diag)
 Restart device sampling - trigger device to collect new metrics. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_stop (struct doca_telemetry_diag *diag)
 Stop device sampling. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_output_format (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_output_format output_format)
 Set output format. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_output_format (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_output_format *output_format)
 Get output format. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_sample_period (struct doca_telemetry_diag *diag, uint64_t sample_period)
 Set sample period. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_sample_period (struct doca_telemetry_diag *diag, uint64_t *sample_period)
 Get sample period. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_log_max_num_samples (struct doca_telemetry_diag *diag, uint8_t log_max_num_samples)
 Set log max of samples. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_log_max_num_samples (struct doca_telemetry_diag *diag, uint8_t *log_max_num_samples)
 Get log max of samples. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_max_num_data_ids (struct doca_telemetry_diag *diag, uint32_t max_num_data_ids)
 Set max num of data IDs. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_max_num_data_ids (struct doca_telemetry_diag *diag, uint32_t *max_num_data_ids)
 Get max num of data IDs. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_sync_mode (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_sync_mode sync_mode)
 Set synchronization mode. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_sync_mode (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_sync_mode *sync_mode)
 Get synchronization mode. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_sample_mode (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_sample_mode sample_mode)
 Set sampling mode. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_sample_mode (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_sample_mode *sample_mode)
 Get Sampling mode. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_data_clear (struct doca_telemetry_diag *diag, uint8_t data_clear)
 Set data clear. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_data_clear (struct doca_telemetry_diag *diag, uint8_t *data_clear)
 Get data clear. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_set_data_timestamp_source (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_timestamp_source data_timestamp_source)
 Set data timestamp source. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_data_timestamp_source (struct doca_telemetry_diag *diag, enum doca_telemetry_diag_timestamp_source *data_timestamp_source)
 Get data timestamp source. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_check_data_id (struct doca_telemetry_diag *diag, uint64_t data_id)
 Check if a counter is supported in current configuration, by it's data ID. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_apply_counters_list_by_id (struct doca_telemetry_diag *diag, const uint64_t *data_ids, uint32_t num_data_ids, uint64_t *counter_id_failure)
 Apply the counters, by their data ID, to be queried. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_num_applied_counters (struct doca_telemetry_diag *diag, uint32_t *num_applied_counters)
 Get number of currently applied counters. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_applied_counters_list_by_id (struct doca_telemetry_diag *diag, uint32_t num_data_ids, uint64_t *data_ids)
 Get list of currently applied counters, by their ID. More...
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_get_sample_size (struct doca_telemetry_diag *diag, uint32_t *sample_size)
 
DOCA_EXPERIMENTAL doca_error_t doca_telemetry_diag_query_counters (struct doca_telemetry_diag *diag, void *buf, uint32_t max_samples_to_read, uint32_t *num_valid_samples)