Common configurable properties

Following are the configurable properties in the End-to-End Monitoring agent available at the following installer-based directory: <INSTALL-DIR>\E2EMonitoring\agent\config\agent.config Package-based directory: <INSTALL-DIR>\IntegrationServer\packages\<IS-E2EM package name>\resources\agent\config\agent.config

Property Description
agent.trace_transfer_interval=${SW_AGENT_TRACE_TRANSFER_INTERVAL:180000} This property defines the interval between each write operation to the file. The same property is used for data send interval through the gRPC channel. The default value is 18000 ms. It is preferred to reduce this time interval to shorter segment trace writes if you prefer a faster sync time.
collector.establish_cloud_communication=${SW_AGENT_COLLECTOR_ESTABLISH_CLOUD_COMMUNICATION:true} This property defines connectivity with the cloud collector. The default value is true, which means that data is sent to the cloud collector.
agent.onprem_multitenant_alias Hybrid data transfer takes place within tenants of one given region only. When multiple tenant connections are created for different tenants that belong to the same region, specifying one of the tenant connection names for agent.onprem_multitenant_alias in agent.config is sufficient to trace hybrid transactions of other tenants that belong to the same region. However, this configuration is required only if you have multiple tenants in the same region and you want to route the trace by using a specific tenant. End-to-End Monitoring can trace to only one tenant but is able to determine the original tenant for each trace.
agent.global_incl_serv_flag=${SW_AGENT_GLOBAL_INCL_SERV_FLAG:GLOBAL_OR_LOCAL} This property allows you to select between IBM® Designer audit property or Integration Server extended settings WATT properties based tracing. Default Value is GLOBAL_OR_LOCAL. Possible values are GLOBAL_OR_LOCAL, GLOBAL, LOCAL.
  • LOCAL: Only services with audit service that is enabled on the IBM Designer are traced.
  • GLOBAL: WATT property include-exclude list is considered for tracing.
  • GLOBAL_OR_LOCAL: WATT property and IBM Designer settings, both are considered for include-exclude list.
agent.exclude_serv_list=${SW_AGENT_EXCLUDE_SERV_LIST:wm.,com.,pub.} This property is considered only if WATT exclude is set with $wmservices. $wmservices represents any webMethods services. These service names start with wm. or pub. or com., and are excluded from tracing.
agent.watt_check_interval=${SW_AGENT_WATT_CHECK_INTERVAL:600000} Any changes in the WATT property or the content in include or exclude files is refreshed in the cache at this interval. The default value is 600000 ms=10 minutes.
agent.service_name=${SW_AGENT_NAME:ONPREMISEIS} Indicates a service name that monitors product calls. Set SW_AGENT_NAME to ONPREMISEAPI to monitor on-premises API Gateway calls.
agent.onprem_tenant_id=${SW_AGENT_ONPPREM_TENANT_ID:default} Indicates the source cloud tenant from which transactions to on-premises API Gateway originate. The tenant name is the value for SW_AGENT_ONPPREM_TENANT_ID.
agent.apigw_tag=${SW_AGENT_APIGW_TAG:<custom tag>} End-to-End Monitoring, by default, monitors all the on-premises API Gateway calls with tag e2em. If you need to monitor an API containing custom tags, add this property in agent.config with custom tag value. To enable tracing, add the e2em tags to the API Gateway API, in case you do not have them already.
collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES: uhm.e2em-hybrid-az-us.webmethods.io:443} If there are connection issues in the agent to collector connectivity, this property can be used to set collector endpoint so that the agent can connect to the specified collector. This property is not required to be set explicitly from v10.15 onward, for v10.11 or v1.3.0 latest fixes (Fix 5 and higher).
Note: Refer the collector end-point section for specific collector end-point values.
agent.onprem_multijndi_alias = ${SW_AGENT_ONPREM_MULTIJNDI_ALIAS:DEFAULT_IS_JNDI_PROVIDER} This property defines the Multi-JNDI support for specific alias. This property is set to DEFAULT_IS_JNDI_PROVIDER by default. If you use custom JNDI provider alias in the Integration Server, then use the custom name as a value instead of DEFAULT_IS_JNDI_PROVIDER.
agent.onprem_jndi_auth_enable=${SW_AGENT_ONPREM_JNDI_AUTH_ENABLE:true} This property defines on-premises to cloud JNDI-based authentication. It is set to false by default.