SYNOPSIS
#!/usr/bin/perl
use Apache::TS::AdminClient;
my $cli = Apache::TS::AdminClient->new(%input);
my $string = $cli->get_stat("proxy.config.product_company");
print "$string\n";
DESCRIPTION:
AdminClient opens a TCP connection to a unix domain socket on local disk. When the connection is established, AdminClient will write requests to the socket and wait for Apache Traffic Server to return a response. Valid request strings can be found in RecordsConfig.cc which is included with Apache Traffic Server source. A list of valid request strings are included with this documentation, but this included list may not be complete as future releases of Apache Traffic Server may include new request strings or remove existing ones.CONSTRUCTOR
When the object is created for this module, it assumes the 'Unix Domain Socket' is at the default location from the Apache Traffic Server installation. This can be changed when creating the object by setting 'socket_path'. For example:- my $cli = AdminClient->new(socket_path=> "/var/trafficserver");
- This would make the module look for the 'Unix Domain Socket' in the directory '/var/trafficserver'. The path can optionally include the name of the Socket file, without it the constructor defaults to 'mgmtapi.sock'.
PUBLIC METHODS
To read a single metric (or configuration), two APIs are available:- $cli->get_stat($stats_name);
- $cli->get_config($config_name);
- This will return a (scalar) value for this metric or configuration.
traffic_line
There is a command line tool included with Apache Traffic Server called traffic_line which overlaps with this module. traffic_line can be used to read and write statistics or config settings that this module can. Hence if you don't want to write a perl one-liner to get to this information, traffic_line is your tool.List of configurations
The Apache Traffic Server Administration Manual will explain what these strings represent. (http://trafficserver.apache.org/docs/)
proxy.config.accept_threads proxy.config.task_threads proxy.config.admin.admin_user proxy.config.admin.synthetic_port proxy.config.admin.cli_path proxy.config.admin.number_config_bak proxy.config.admin.user_id proxy.config.alarm.abs_path proxy.config.alarm.bin proxy.config.alarm_email proxy.config.alarm.script_runtime proxy.config.bandwidth_mgmt.filename proxy.config.bin_path proxy.config.body_factory.enable_customizations proxy.config.body_factory.enable_logging proxy.config.body_factory.response_suppression_mode proxy.config.body_factory.template_sets_dir proxy.config.cache.agg_write_backlog proxy.config.cache.alt_rewrite_max_size proxy.config.cache.control.filename proxy.config.cache.dir.sync_frequency proxy.config.cache.enable_checksum proxy.config.cache.enable_read_while_writer proxy.config.cache.hostdb.disable_reverse_lookup proxy.config.cache.hostdb.sync_frequency proxy.config.cache.hosting_filename proxy.config.cache.ip_allow.filename proxy.config.cache.limits.http.max_alts proxy.config.cache.max_disk_errors proxy.config.cache.max_doc_size proxy.config.cache.min_average_object_size proxy.config.cache.volume_filename proxy.config.cache.permit.pinning proxy.config.cache.ram_cache_cutoff proxy.config.cache.ram_cache.size proxy.config.cache.select_alternate proxy.config.cache.storage_filename proxy.config.cache.threads_per_disk proxy.config.cache.mutex_retry_delay proxy.config.cluster.cluster_configuration proxy.config.cluster.cluster_load_clear_duration proxy.config.cluster.cluster_load_exceed_duration proxy.config.cluster.cluster_port proxy.config.cluster.delta_thresh proxy.config.cluster.enable_monitor proxy.config.cluster.ethernet_interface proxy.config.cluster.load_compute_interval_msecs proxy.config.cluster.load_monitor_enabled proxy.config.cluster.log_bogus_mc_msgs proxy.config.cluster.mc_group_addr proxy.config.cluster.mcport proxy.config.cluster.mc_ttl proxy.config.cluster.monitor_interval_secs proxy.config.cluster.msecs_per_ping_response_bucket proxy.config.cluster.peer_timeout proxy.config.cluster.periodic_timer_interval_msecs proxy.config.cluster.ping_history_buf_length proxy.config.cluster.ping_latency_threshold_msecs proxy.config.cluster.ping_response_buckets proxy.config.cluster.ping_send_interval_msecs proxy.config.cluster.receive_buffer_size proxy.config.cluster.rpc_cache_cluster proxy.config.cluster.rsport proxy.config.cluster.send_buffer_size proxy.config.cluster.sock_option_flag proxy.config.cluster.startup_timeout proxy.config.cluster.threads proxy.config.config_dir proxy.config.cop.core_signal proxy.config.cop.linux_min_memfree_kb proxy.config.cop.linux_min_swapfree_kb proxy.config.core_limit proxy.config.diags.action.enabled proxy.config.diags.action.tags proxy.config.diags.debug.enabled proxy.config.diags.debug.tags proxy.config.diags.output.alert proxy.config.diags.output.debug proxy.config.diags.output.diag proxy.config.diags.output.emergency proxy.config.diags.output.error proxy.config.diags.output.fatal proxy.config.diags.output.note proxy.config.diags.output.status proxy.config.diags.output.warning proxy.config.diags.show_location proxy.config.dns.failover_number proxy.config.dns.failover_period proxy.config.dns.lookup_timeout proxy.config.dns.max_dns_in_flight proxy.config.dns.nameservers proxy.config.dns.resolv_conf proxy.config.dns.retries proxy.config.dns.round_robin_nameservers proxy.config.dns.search_default_domains proxy.config.dns.splitDNS.enabled proxy.config.dns.splitdns.filename proxy.config.dns.url_expansions proxy.config.dump_mem_info_frequency proxy.config.env_prep proxy.config.exec_thread.autoconfig proxy.config.exec_thread.autoconfig.scale proxy.config.exec_thread.limit proxy.config.header.parse.no_host_url_redirect proxy.config.hostdb proxy.config.hostdb.cluster proxy.config.hostdb.cluster.round_robin proxy.config.hostdb.fail.timeout proxy.config.hostdb.filename proxy.config.hostdb.lookup_timeout proxy.config.hostdb.migrate_on_demand proxy.config.hostdb.re_dns_on_reload proxy.config.hostdb.serve_stale_for proxy.config.hostdb.size proxy.config.hostdb.storage_path proxy.config.hostdb.storage_size proxy.config.hostdb.strict_round_robin proxy.config.hostdb.timeout proxy.config.hostdb.ttl_mode proxy.config.hostdb.verify_after proxy.config.http.accept_encoding_filter.filename proxy.config.http.accept_no_activity_timeout proxy.config.http.anonymize_insert_client_ip proxy.config.http.anonymize_other_header_list proxy.config.http.anonymize_remove_client_ip proxy.config.http.anonymize_remove_cookie proxy.config.http.anonymize_remove_from proxy.config.http.anonymize_remove_referer proxy.config.http.anonymize_remove_user_agent proxy.config.http.background_fill_active_timeout proxy.config.http.background_fill_completed_threshold proxy.config.http.cache.cache_responses_to_cookies proxy.config.http.cache.cache_urls_that_look_dynamic proxy.config.http.cache.enable_default_vary_headers proxy.config.http.cache.fuzz.min_time proxy.config.http.cache.fuzz.probability proxy.config.http.cache.fuzz.time proxy.config.http.cache.guaranteed_max_lifetime proxy.config.http.cache.guaranteed_min_lifetime proxy.config.http.cache.heuristic_lm_factor proxy.config.http.cache.heuristic_max_lifetime proxy.config.http.cache.heuristic_min_lifetime proxy.config.http.cache.http proxy.config.http.cache.ignore_accept_charset_mismatch proxy.config.http.cache.ignore_accept_encoding_mismatch proxy.config.http.cache.ignore_accept_language_mismatch proxy.config.http.cache.ignore_accept_mismatch proxy.config.http.cache.ignore_authentication proxy.config.http.cache.ignore_client_cc_max_age proxy.config.http.cache.cluster_cache_local proxy.config.http.cache.ignore_client_no_cache proxy.config.http.cache.ignore_server_no_cache proxy.config.http.cache.ims_on_client_no_cache proxy.config.http.cache.max_open_read_retries proxy.config.http.cache.max_open_write_retries proxy.config.http.cache.max_stale_age proxy.config.http.cache.open_read_retry_time proxy.config.http.cache.range.lookup proxy.config.http.cache.range.write proxy.config.http.cache.required_headers proxy.config.http.cache.vary_default_images proxy.config.http.cache.vary_default_other proxy.config.http.cache.vary_default_text proxy.config.http.cache.when_to_revalidate proxy.config.http.chunking_enabled proxy.config.http.congestion_control.default.client_wait_interval proxy.config.http.congestion_control.default.congestion_scheme proxy.config.http.congestion_control.default.dead_os_conn_retries proxy.config.http.congestion_control.default.dead_os_conn_timeout proxy.config.http.congestion_control.default.error_page proxy.config.http.congestion_control.default.fail_window proxy.config.http.congestion_control.default.live_os_conn_retries proxy.config.http.congestion_control.default.live_os_conn_timeout proxy.config.http.congestion_control.default.max_connection proxy.config.http.congestion_control.default.max_connection_failures proxy.config.http.congestion_control.default.proxy_retry_interval proxy.config.http.congestion_control.default.wait_interval_alpha proxy.config.http.congestion_control.enabled proxy.config.http.congestion_control.filename proxy.config.http.congestion_control.localtime proxy.config.http.connect_attempts_max_retries proxy.config.http.connect_attempts_max_retries_dead_server proxy.config.http.connect_attempts_rr_retries proxy.config.http.connect_attempts_timeout proxy.config.http.connect_ports proxy.config.http.default_buffer_size proxy.config.http.default_buffer_water_mark proxy.config.http.doc_in_cache_skip_dns proxy.config.http.down_server.abort_threshold proxy.config.http.down_server.cache_time proxy.config.http.enabled proxy.config.http.enable_http_info proxy.config.http.enable_http_stats proxy.config.http.enable_url_expandomatic proxy.config.http.errors.log_error_pages proxy.config.http.forward.proxy_auth_to_parent proxy.config.http.global_user_agent_header proxy.config.http.insert_age_in_response proxy.config.http.insert_request_via_str proxy.config.http.insert_response_via_str proxy.config.http.insert_squid_x_forwarded_for proxy.config.http.keep_alive_enabled_in proxy.config.http.keep_alive_enabled_out proxy.config.http.keep_alive_no_activity_timeout_in proxy.config.http.keep_alive_no_activity_timeout_out proxy.config.http.keep_alive_post_out proxy.config.http.negative_caching_enabled proxy.config.http.negative_caching_lifetime proxy.config.http.negative_revalidating_enabled proxy.config.http.negative_revalidating_lifetime proxy.config.http.no_dns_just_forward_to_parent proxy.config.http.no_origin_server_dns proxy.config.http.normalize_ae_gzip proxy.config.http.number_of_redirections proxy.config.http.origin_max_connections proxy.config.http.origin_min_keep_alive_connections proxy.config.http.parent_proxies proxy.config.http.parent_proxy.connect_attempts_timeout proxy.config.http.parent_proxy.fail_threshold proxy.config.http.parent_proxy.file proxy.config.http.parent_proxy.per_parent_connect_attempts proxy.config.http.parent_proxy.retry_time proxy.config.http.parent_proxy_routing_enable proxy.config.http.parent_proxy.total_connect_attempts proxy.config.http.post_connect_attempts_timeout proxy.config.http.post_copy_size proxy.config.http.push_method_enabled proxy.config.http.quick_filter.mask proxy.config.http.record_heartbeat proxy.config.http.redirection_enabled proxy.config.http.referer_default_redirect proxy.config.http.referer_filter proxy.config.http.referer_format_redirect proxy.config.http.request_header_max_size proxy.config.http.request_via_str proxy.config.http.response_header_max_size proxy.config.http.response_server_enabled proxy.config.http.response_server_str proxy.config.http.response_via_str proxy.config.http.send_http11_requests proxy.config.http.server_max_connections proxy.config.http.server_port proxy.config.http.slow.log.threshold proxy.config.http.connect_ports proxy.config.http.transaction_active_timeout_in proxy.config.http.transaction_active_timeout_out proxy.config.http.transaction_no_activity_timeout_in proxy.config.http.transaction_no_activity_timeout_out proxy.config.http_ui_enabled proxy.config.http.uncacheable_requests_bypass_parent proxy.config.icp.default_reply_port proxy.config.icp.enabled proxy.config.icp.icp_configuration proxy.config.icp.icp_interface proxy.config.icp.icp_port proxy.config.icp.lookup_local proxy.config.icp.multicast_enabled proxy.config.icp.query_timeout proxy.config.icp.reply_to_unknown_peer proxy.config.icp.stale_icp_enabled proxy.config.io.max_buffer_size proxy.config.lm.pserver_timeout_msecs proxy.config.lm.pserver_timeout_secs proxy.config.local_state_dir proxy.config.log.ascii_buffer_size proxy.config.log.auto_delete_rolled_files proxy.config.log.collation_host proxy.config.log.collation_host_tagged proxy.config.log.collation_max_send_buffers proxy.config.log.collation_port proxy.config.log.collation_retry_sec proxy.config.log.collation_secret proxy.config.log.custom_logs_enabled proxy.config.log.file_stat_frequency proxy.config.log.hostname proxy.config.log.hosts_config_file proxy.config.log.log_buffer_size proxy.config.log.logfile_dir proxy.config.log.logfile_perm proxy.config.log.logging_enabled proxy.config.log.max_line_size proxy.config.log.max_secs_per_buffer proxy.config.log.max_space_mb_for_logs proxy.config.log.max_space_mb_for_orphan_logs proxy.config.log.max_space_mb_headroom proxy.config.log.overspill_report_count proxy.config.log.rolling_enabled proxy.config.log.rolling_interval_sec proxy.config.log.rolling_offset_hr proxy.config.log.rolling_size_mb proxy.config.log.sampling_frequency proxy.config.log.space_used_frequency proxy.config.log.xml_config_file proxy.config.manager_binary proxy.config.net.connections_throttle proxy.config.net.listen_backlog proxy.config.net.sock_mss_in proxy.config.net.sock_option_flag_in proxy.config.net.sock_option_flag_out proxy.config.net.sock_recv_buffer_size_in proxy.config.net.sock_recv_buffer_size_out proxy.config.net.sock_send_buffer_size_in proxy.config.net.sock_send_buffer_size_out proxy.config.net.defer_accept proxy.config.output.logfile proxy.config.ping.npacks_to_trans proxy.config.ping.timeout_sec proxy.config.plugin.plugin_dir proxy.config.process_manager.enable_mgmt_port proxy.config.process_manager.mgmt_port proxy.config.process_manager.timeout proxy.config.product_company proxy.config.product_name proxy.config.product_vendor proxy.config.proxy.authenticate.basic.realm proxy.config.proxy_binary proxy.config.proxy_binary_opts proxy.config.proxy_name proxy.config.remap.num_remap_threads proxy.config.res_track_memory proxy.config.reverse_proxy.enabled proxy.config.reverse_proxy.oldasxbehavior proxy.config.snapshot_dir proxy.config.socks.accept_enabled proxy.config.socks.accept_port proxy.config.socks.connection_attempts proxy.config.socks.default_servers proxy.config.socks.http_port proxy.config.socks.per_server_connection_attempts proxy.config.socks.server_connect_timeout proxy.config.socks.server_fail_threshold proxy.config.socks.server_retry_time proxy.config.socks.server_retry_timeout proxy.config.socks.socks_config_file proxy.config.socks.socks_needed proxy.config.socks.socks_timeout proxy.config.socks.socks_version proxy.config.srv_enabled proxy.config.ssl.CA.cert.filename proxy.config.ssl.CA.cert.path proxy.config.ssl.client.CA.cert.filename proxy.config.ssl.client.CA.cert.path proxy.config.ssl.client.cert.filename proxy.config.ssl.client.certification_level proxy.config.ssl.client.cert.path proxy.config.ssl.client.private_key.filename proxy.config.ssl.client.private_key.path proxy.config.ssl.client.verify.server proxy.config.ssl.enabled proxy.config.ssl.number.threads proxy.config.ssl.server.cert_chain.filename proxy.config.ssl.server.cert.path proxy.config.ssl.server.cipher_suite proxy.config.ssl.server.honor_cipher_order proxy.config.ssl.server.dhparams_file proxy.config.ssl.SSLv2 proxy.config.ssl.SSLv3 proxy.config.ssl.TLSv1 proxy.config.ssl.compression proxy.config.ssl.server.multicert.filename proxy.config.ssl.server_port proxy.config.ssl.server.private_key.path proxy.config.stat_collector.interval proxy.config.stat_collector.port proxy.config.stats.config_file proxy.config.stats.snap_file proxy.config.stats.snap_frequency proxy.config.syslog_facility proxy.config.system.mmap_max proxy.config.system.file_max_pct proxy.config.thread.default.stacksize proxy.config.udp.free_cancelled_pkts_sec proxy.config.udp.periodic_cleanup proxy.config.udp.send_retries proxy.config.url_remap.filename proxy.config.url_remap.pristine_host_hdr proxy.config.url_remap.remap_required proxy.config.vmap.addr_file proxy.config.vmap.down_up_timeout proxy.config.vmap.enabled
LICENSE
Simple Apache Traffic Server client object, to communicate with the local manager.
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.