This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.
TrueSight Capacity Optimization
TSCO vCenter Service ETL how to use whitelist and blacklist parameters
Trying to use the vCenter Service ETL whitelist and blacklist options but the results in the workspace are not what are expected.
Details for accessing the vCenter Service ETL whitelist and blacklist options are in the TSCO documentation. Some of the links can be found below:
TSCO 10.7 - https://docs.bmc.com/docs/display/btco107/Configuring+the+continuous+polling+and+collection+of+data+from+a+VMware+environment
TSCO 11.0 - https://docs.bmc.com/docs/display/btco110/Configuring+the+continuous+polling+and+collection+of+data+from+a+VMware+environment
TSCO 11.3 - https://docs.bmc.com/docs/display/btco115/VMware+vCenter+Extractor+Service
Look for the Import Filter on the documentation Pagse to find the information about Whitelist and Blacklist.
*** Make sure you have the latest CHF installed in your environment. There was a defect DRCOZ-16117 which made it difficult to determine the proper case of VMs from the vCenter while high logging is enabled in the ETL. All VMs were being converted to lowercase.
To blacklist only certain cluster or hosts and whitelist VMs using a whitelist file, below is an example of the ETL import filter settings:
Blacklist does not provide support for regular expression, to exclude monitoring of a set of VMs which certain string in the name use a white list file with an inverted regular expression (see details more below).
The contents of the whitelist file used in the "Blacklist file path option" are listed below:
The results of the imported systems in the workspace are:
*** Note the inclusion of BCOQA-DC and New Datacenter is being tracked by defect DRCOZ-16609. These datacenters should not have been imported. When defect DRCOZ-16609 is fixed they will not be loaded into TSCO since there are not part of the whitelist information.
When higher logging is enabled, the service log will show the follow information about the whitelist otpions:
2018-04-11 11:45:17,558 DEBUG [service-104-1]- Adding vm regex to whitelist: ^vw\-pun\-co\-aut19.* 2018-04-11 11:45:17,558 INFO [service-104-1]- Loaded whitelist regex file - #1 regex will be used for whitelisting vms. 2018-04-11 11:25:01,260 DEBUG [service-104-1]- Whitelisted VMs: [vw-pun-co-aut19.dsl.bmc.com] 2018-04-11 11:25:01,260 DEBUG [service-104-1]- Blacklisted VMs: [vw-pun-co-aut18.dsl.bmc.com, vl-pun-bco-qa52, vw-pun-co-aut32.dsl.bmc.com, vl-pun-aut-qa55, vw-pun-aut-qa02.dsl.bmc.com, vl-pun-aut-qa56, vl-pun-aut-qa57, vw-pun-co-aut17.dsl.bmc.com, vw-pun-co-aut20.dsl.bmc.com, vl-pun-bco-qa54, vl-pun-bco-qa53]
The above information is only available after the saver has run for the service.
The Whitelist file can also be used to get an inverted selection from the vCenter. An example would be, you can use this way to blacklist a set of VMs. In the example below no VMs with the including the string vl-pun are monitored.
The above will result in the following whitelist and blacklist output as shown in the log. The regex string will whitelist all VMs not matching "vl-pun, the "vl-pun" VMs will be added to the blacklist as shown below:
2018-04-11 19:00:00,616 DEBUG [service-106-1]- Blacklisted VMs: [vl-pun-aut-qa29, vl-pun-aut-qa01_old, vl-pun-bco-neuton, vl-pun-bco-qa02-2, vl-pun-bco-ADDM11202, vl-pun-aut-qa15, vl-pun-bco-pt08-BCO-RHEL5.9-64, vl-pun-rds-tl1d, vl-pun-bco-qa52, vl-pun-bcm-ADDM1102, vl-pun-aut-qa55, vl-pun-aut-qa56, vl-pun-aut-qa57, vl-pun-aut-qa14, vl-pun-bld-qa01, vl-pun-bco-qa57, vl-pun-bco-qa13, vl-pun-bco-cmdb01, vl-pun-bco-qa54, vl-pun-bco-qa53, vl-pun-bco-qa02 - SUSE12, vl-pun-bco-qa56, vl-pun-bco-qa12, vl-pun-bco-qa55, vl-pun-bco-qa11, vl-pun-bcm-ADDM112, vl-pun-bco-octa, vl-pun-openn-vc01, vl-pun-bco-rsso1, vl-pun-bco-pt06, vl-pun-bcm-dv28, vl-pun-bcm-dv26, vl-pun-bco-pt03, vl-pun-bco-pt02, vl-pun-aut-qa01, vl-pun-bcm-dv27, vl-pun-bco-pt05, vl-pun-aut-qa02, vl-pun-bco-pt04, vl-pun-bcm-qa09-CentOS-6.5-64, vl-pun-bco-qa05, vl-pun-bco-qa06-CentOS6.5-64, vl-pun-bco-pt03c, vl-pun-bco-pt03b, vl-pun-bco-pt03a, vl-pun-bcm-dv19, vl-pun-bcm-dv15, vl-pun-bcm-dv16, vl-pun-octa2-qa02, vl-pun-bcm-qa10, vl-pun-bco-qa02-1 - SUSE12, vl-pun-bcm-qa13, vl-pun-bco-qa39, vl-pun-bcm-qa12, vl-pun-open-new01, vl-pun-bcm-qa11, vl-pun-bco-pt01, vl-pun-ocata-qa01, vl-pun-bco-mitaka3]