Inside the container, the directory /config contains the configuration files for the NVIDIA® UFM® Telemetry application. The file launch_ibdiagnet_config.ini is the main configuration file.
The following table lists the basic configuration parameters in launch_ibdiagnet_config.ini.
|
Section |
Key |
Type |
Default Value |
Description |
|---|---|---|---|---|
|
|
|
bool |
|
Enable or disable running the |
|
|
String |
|
Directory in which UFM Telemetry data is placed |
|
|
|
String |
|
Directory in which |
|
|
|
Int |
- |
Interval, in seconds, at which port counter data is collected |
|
|
|
String |
|
The HCA to use. You can provide a comma-separated list of HCAs for local high availability |
|
|
|
bool |
|
Skip the HCA state check |
|
|
|
String |
|
The full path of the |
|
|
|
String |
|
Topology policy |
|
|
|
Int |
|
Every "n" iterations, do discovery, otherwise, use result from last run if 0 or 1 |
|
|
|
int |
- |
Set the |
|
|
|
|
bool |
|
Enable this setting in XDR environments to configure additional required indexes |
|
|
|
bool |
|
Enable or disable the retention service |
|
|
time |
|
Interval to wait before running the retention process |
|
|
|
time |
|
Period for which to retain the collected data |
|
|
|
|
bool |
|
Enable or disable the compression service |
|
|
time |
|
Interval to wait before running the compression service |
|
|
|
time |
|
Period to reserve the compressed data |
|
|
|
|
CSV |
- |
weekday/hr:min,hr:hm Time to collect cable info data |
Log File Rotation
The log rotation mechanism monitors the size of the UFM Telemetry log file ibdiagnet2_port_counters.log. Log rotation is especially useful for long run times or high verbosity, when the number of log files can grow very large.
To disable log rotation, set the following flag to 0 (the default is 1):
plugin_env_CLX_LOG_ROTATE_ENABLED
To change the number of rotated files, set the following flag (the default is 3):
plugin_env_CLX_LOG_ROTATE_NUM_FILES
To change the rotation threshold, set the following flag (the default is 100M). Use K, M, or G as the unit:
plugin_env_CLX_LOG_ROTATE_SIZE
UFM Telemetry supports three rotation methods and tries them in the following order:
-
rotatelogs: If this executable exists, UFM Telemetry uses it to rotate logs and names the rotated files with an index suffix. -
logrotate: If this executable exists, UFM Telemetry uses it to rotate logs and names the rotated files with a timestamp suffix. -
Manual rotation: If neither executable is available, UFM Telemetry rotates two log files itself. The older log file has the suffix
.bck.
To skip a rotation method, set the following flag to the executables to use (the default is rotatelogs,logrotate):
plugin_env_CLX_LOG_ROTATE_APP
Auto Discovery Updates
The UFM Telemetry auto discovery feature enables in-process topology updates, eliminating the need for process restarts.
External events trigger additional in-process ad-hoc discoveries and topology updates.
The following parameters configure the auto discovery updates feature:
|
Key |
Type |
Default Value |
Description |
|---|---|---|---|
|
|
bool |
1 |
Enable auto discovery updates |
|
|
bool |
0 |
Enable triggering by an InfiniBand (IB) trap from the subnet manager (SM) |
|
|
bool |
1 |
Enable triggering from telemetry manager (UTM) |
|
|
int |
180 |
Minimum interval, in seconds, between two consecutive ad-hoc discoveries |
|
|
bool |
0 |
Enable triggering by the clx restart file. When enabled, the existence of the file does not restart the process. |
|
|
bool |
0 |
Enable periodic triggering of ad-hoc discoveries |
|
|
int |
-1 |
The local identifier (LID) of the SM. Relevant only when the SM IB trap is enabled. A value of |
Last updated: