uberAgent

Using uberAgent® With a Proxy

uberAgent uses libcurl to send data when using HTTP or HTTPS as protocol. libcurl ignores common per-system or per-user proxy settings. Customers who want to use uberAgent with a proxy, must configure the following two system environment variables:

  • http_proxy
  • https_proxy

Customers who have a proxy configured but don’t want to route the traffic from uberAgent to Splunk through it, must set the environment variable no_proxy to the Splunk server name.

More information is available in the libcurl documentation.

Setting Proxy Variables Specifically for uberAgent

Windows

On Windows, you can configure the above mentioned environment variables specifically for the uberAgent service. This means that the variables are only used by uberAgent. To do so, proceed as follows.

  • Open regedit.exe and browse to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\uberAgentSvc.
  • Create a new multi-string-value (REG_MULTI_SZ) named Environment.
  • Enter the proxy variables with their corresponding values in the following format http_proxy=http://proxy.citrix.com:port. Use a line break, if you’re configuring multiple variables.
  • After adding the variables, restart the uberAgent service in order to apply the new settings.

macOS

On macOS, you can configure the environment variables specifically for uberAgent using the launch daemon. To do so, proceed as follows.

  • Edit the uberAgent launch daemon plist file at /Library/LaunchDaemons/com.vastlimits.uberagent.plist.
  • Add an EnvironmentVariables dictionary within the main dict element with the proxy variables as key-value pairs:
<key>EnvironmentVariables</key>
<dict>
    <key>http_proxy</key>
    <string>http://proxy.citrix.com:port</string>
    <key>https_proxy</key>
    <string>http://proxy.citrix.com:port</string>
</dict>
<!--NeedCopy-->
  • Save the file and reload the launch daemon by running sudo launchctl unload /Library/LaunchDaemons/com.vastlimits.uberagent.plist followed by sudo launchctl load /Library/LaunchDaemons/com.vastlimits.uberagent.plist.
Using uberAgent® With a Proxy