Defaults to /etc/trafficcontro-health-client/tc-health-client.json
-h, --help
Prints command line usage and exits
-l, --logging-dir=logging-directory
Specify the directory where log files are kept. The default location is /var/log/trafficcontrol/
-v, --verbose
Logging verbosity. Errors are logged to the default log file /var/log/trafficcontrol/tc-health-client.log To add Warnings, use -v. To add Warnings and Informational logging, use -vv. Finally you may add Debug logging using -vvv.
The configuration file is a JSON file and is looked for by default at /etc/trafficcontrol/tc-health-client.json
Sample configuarion file:
{ "cdn-name": "over-the-top", "enable-active-markdowns": false, "reason-code": "active", "to-credential-file": "/etc/credentials", "to-url": "https://tp.cdn.com:443", "to-request-timeout-seconds": "5s", "tm-poll-interval-seconds": "60s", "tm-proxy-url", "http://sample-http-proxy.cdn.net:80", "to-login-dispersion-factor": 90, "unavailable-poll-threshold": 2, "markup-poll-threshold": 1, "trafficserver-config-dir": "/opt/trafficserver/etc/trafficserver", "trafficserver-bin-dir": "/opt/trafficserver/bin", "poll-state-json-log": "/var/log/trafficcontrol/poll-state.json", "enable-poll-state-log": false }
The name of the CDN that the Traffic Server host is a member of.
When enabled, the client will actively mark down Traffic Server parents. When disabled, the client will only log that it would have marked down Traffic Server parents. Down Parents are always marked UP if Traffic Monitor reports them available irregardless of this setting.
Use the reason code active or local when marking down Traffic Server hosts in the Traffic Server HostStatus subsystem.
The file where Traffic Ops credentials are read. The file should define the following variables:
The Traffic Ops URL
The time in seconds to wait for a query response from both Traffic Ops and the Traffic Monitors
The polling interval in seconds used to update Traffic Server parent status.
If not nil, all Traffic Monitor requests will be proxied through this proxy endpoint. This is useful when there are large numbers of caches polling a Traffic Monitor and you wish to funnel queries through a caching proxy server to limit direct direct connections to Traffic Monitor.
This is used to calculate TrafficOps login dispersion. It is related to the tm-poll-interval-seconds. The login dispersion is computed by multiplying tm-poll-interval-seconds by the to-login-dispersion-factor. For example if to-login-dispersion-factor is 90 and the tm-poll-interval-seconds is 10s the the dispersion modulo window is 900s.
This controls when an unhealthy parent is marked down. An unhealthy parent will be marked down when the number of consecutive polls reaches this threshold with the parent reported as unhealthy. The default threshold is 2.
This controls when a healthy parent is marked up. An healthy parent will be marked up when the number of consecutive polls reaches this threshold with the parent reported as healthy. The default threshold is 1.
The location on the host where Traffic Server configuration files are located.
The location on the host where Traffic Server traffic_ctl tool may be found.
The full path to the polling state file which contains information about the current status of parents and the health client configuration. Polling state data is written to this file after each polling cycle when enabled, see enable-poll-state-log
Enable writing the Polling state to the poll-state-json-log after eache polling cycle. Default false, disabled