Troubleshooting BMC TrueSight Operations Management ETLs


This topic provides information about troubleshooting issues with the BMC TrueSight Operations Management ETLs. 

Before you integrate TrueSight Capacity Optimization with TrueSight Operations Management, ensure that TrueSight Operations Management is installed and running.

To integrate TrueSight Capacity Optimization with BMC TrueSight Operations Management

ETL module name

Input URL

BMC - TrueSight Operations Management 10.1/10.5/10.7/11.0/11.3 extractor

Use the URL of the Presentation Server instance that is configured for TrueSight Operations Management.

BMC - TrueSight Operations Management 10.1/10.5/10.7/11.0/11.3 Generic extractor

BMC - TrueSight Operations Management 9.0/9.5/9.6/10.0 extractor

Use the TrueSight Infrastructure Management Server URL.

BMC - TrueSight Operations Management 9.0/9.5/9.6/10.0 Generic View Extractor

To collect the ETL logs at log level 10

To add detailed activity logs to the log file:

  1. In TrueSight Capacity Optimization, navigate to Administration > ETL & system tasks > ETL tasks and select the configured TrueSight Operations Management ETLs.
  2. In the Run configurations section click edit_simulation_icon.pngto modify the ETL task. 
  3. From the Edit run configuration page, click Advanced.
  4. Note down the current value of the Log level.
  5. Change the value to 10 - Verbose
  6. Save the changes and run the ETL.
  7. After you run the ETL and the logs are collected, set the log level back to the earlier value to avoid filesystem space issues.

Common issues

Issue

Cause

Resolution

The ETL fails with BCO_ETL_FAIL102: Error in connecting and getting data from server error.

The Data Integration API URL format used to connect with the TrueSight Presentation Server in the ETL configuration is incorrect.

  • In ETL configuration, in the TrueSight Operations Management Connection tab check the Data Integration API URL field.
  • The URL must be in https://<host>:<port>/tsws format.
  • Save the configuration and run the ETL.

The ETL does not import all the servers from the Realm even when the current data (CPU Utilization) is displayed in TrueSight Operations Management or TrueSight Presentation Server.

The EntityType of the missing devices is unsupported. The servers contain an unsupported EntityType or the value is blank.

Use the Agent Query option from TrueSight Presentation Server to find the Entity type.

Run the following commands:

  • Linux

    For local monitoring:

    print(get("/UNIX_OS/UNIX_OS/EntityType")); 

    For remote monitoring:

    print(get("/UNIX_OS/UNIX_OS@<remote-host>/EntityType"));
  • Windows

    For local monitoring:

    print(get("/NT_OS/NT_OS/EntityType"));

    For remote monitoring:

    print(get("/NT_OS/NT_OS@<remote-host>/EntityType"));

In case of further issues, contact the TrueSight Integration manager team and request assistance in correcting the EntityType of the servers.


For details, see the knowledge article number 000383017 (Support logon ID required).

The ETL fails with the BCO_ETL_FAIL103: User access denied - incorrect tenant name, or user name or password for connecting Url error.

The ETL is configured with incorrect credentials.

  • In ETL configuration, in the TrueSight Operations Management Connection tab check the Username, Password, and Tenant name details.
  • Update the ETL in with the correct information.
  • Save the configuration and run the ETL.

Frequently Asked Questions

Can the BMC TrueSight Operations Management ETL retrieve data from remotely monitored systems?

Yes. The BMC TrueSight Operations Management ETL can retrieve data from the PATROL Knowledge Modules that are supported by TrueSight Capacity Optimization. 

What is the best way to import historical data from the TrueSight Infrastructure Management database via the TSOM ETL in the TrueSight Capacity Optimization?

Follow the instructions in the knowledge article to import historical data. For details, see the knowledge article number 000239528 (Support logon ID required).

Is there an option to blacklist/whitelist entity list in BMC TrueSight Operations Management ETL?

No. Blacklist or whitelist filtering is not available in the BMC TrueSight Operations Management ETL. You can vote for the Entity Whitelist for TSOM ETL idea on BMC Communities.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC TrueSight Capacity Optimization 20.02