12.2. ONTP Message Bus FAQ#

12.2.1. db_write_mode Recommendations#

Note

We recommend using single_table mode in the db_write_mode option.

The only options are

  • single_table

    • Push all the metrics into one table wire_metric

  • multi_table

    • Push the metrics into multiple tables [L1..L7]_metric

Warning

If you select multi-table mode you will have to stitch together the entire packet from the conversation id from each L1..L7 metric table.

You will not be able to reference the entire packet in one query.

12.2.2. db_raw_write#

Note

This controls how the metric messages are written to the database

We recommend using bulk as the default option.

The valid options are

  • bulk

    • bulk write data to the ontp-tsdb[ml]

  • bulk_binary_copy

    • bulk binary copy write data to the ontp-tsdb[ml]

  • txq

    • write data using transactions to the ontp-tsdb[ml]

  • ntx

    • write data using no-transactions to the ontp-tsdb[ml]

12.2.3. db_bulk_write_threshold Recommendations#

Note

The default amount of metrics to collect before bulk writing it to the metric database.

  • Default value: 50

We recommended that you tune this to your network usage to allow for the most efficient collection and storage of metrics.

12.2.4. Deployment Options#

Note

Depending on the size of the environment that you are trying to capture metrics from.

We recommend that you use a F5/A10 to provide access to a number of message bus instances.

So that you have a resilient message bus stack to support your network.

12.2.5. Firewall Ports Access#

Note

Firewall ports to open/limit access to.

  • port 5432 or whatever port you placed the ONTP tsdb[-ml] component on.

You must also allow for port 2568 to lc[1..30].ontp.dev so that on startup the tool can communicate with the ONTP License Server.

See lic_host parameter in the configuration file

12.2.6. Allowed certificate thumbprints#

Note

Allow tool to only accept connections with specified ssl certificate thumbprints.

You can put these definitions into the configuration file section

  • allowed_cert_thumbprints

You can create a fingerprint of the certificate with the following command.

openssl x509 -in CERTIFICATE_FILE -fingerprint -noout

Warning

We do not recommend using this method as the management of valid thumbprints will become a pain the larger your environment is that you are supporting.

12.2.7. runtime_worker_threads#

Note

Default management threads that are started by the system to process incoming messages from ontp-wire capture processes.

  • Default value: 8

12.2.8. runtime_worker_blocking_threads#

Note

Use this to configure the number of waiting blocking threads used to process incoming messages from ontp-wire capture processes.

  • Default value: 1024

12.2.9. max_metric_length#

Note

Use this configuration file option to control the capture of metrics, if a certain metric data is over the specified length it will be truncated.

Use this to control how much metric data is logged to the metric database.

  • Default value: 2700

12.2.10. Userid that the tooling executes as#

Note

The tool is executed as

  • user ontpmbus id 4603

  • group ontpmbus gid 4603

12.2.11. Tool Restart Recommendations#

Warning

It is best practice to restart the container at least once every two weeks.