CLI

This guide covers the essential command-line options for configuring and running Qtap.

Basic Syntax

qtap [flags]

Essential Flags

Configuration

Flag	Description
--config=	Path to YAML configuration file or HTTP/HTTPS URL
--registration-token=	Token for cloud-connected mode

Logging Options

Flag	Default	Description
--log-level=	info	Set logging detail level (debug, info, warn, error)
--log-encoding=	console	Log format (console, json)

TLS Configuration

Flag	Default	Description
--tls-probes=	nodetls,openssl,gotls,javassl	TLS libraries to monitor (nodetls,openssl,gotls,javassl)

Tagging

Flag	Description
--tags=	Deployment tags for categorization (comma-separated key:value pairs)

Debugging

Flag	Description
--enable-dev-tools	Enable browser-based DevTools UI at http://localhost:10001/devtools

Other

Flag	Description
-v, --version	Display Qtap version
-h, --help	Display help information

Common Usage Examples

Running with a Local Configuration File

qtap --config=/path/to/qpoint.yaml

Running with a Remote Configuration File

qtap --config=https://config.example.com/qpoint.yaml

Running with Qplane

qtap --registration-token=YOUR_TOKEN

Adjusting Log Level for Troubleshooting

qtap --config=/path/to/qpoint.yaml --log-level=debug

Using JSON Log Format for Structured Logging

qtap --config=/path/to/qpoint.yaml --log-encoding=json

Monitoring Specific TLS Libraries

qtap --config=/path/to/qpoint.yaml --tls-probes=openssl,gotls,javassl

Cloud-Connected with Enhanced Debugging

qtap --registration-token=YOUR_TOKEN --log-level=debug --log-encoding=json

Adding Deployment Tags

qtap --registration-token=YOUR_TOKEN --tags="env:prod,region:us-east"

Enabling DevTools for Interactive Debugging

qtap --config=/path/to/qpoint.yaml --enable-dev-tools
# Access at http://localhost:10001/devtools

Demo Mode with DevTools

curl -s https://get.qpoint.io/demo | sudo sh -s -- --enable-dev-tools
# Qtap runs in /tmp with DevTools enabled

Remote Config with Debugging

qtap --config=https://config.example.com/qpoint.yaml --log-level=debug

Checking the Qtap Version

qtap --version

Configuration Sources

The --config flag supports multiple sources:

• Local files: /path/to/qpoint.yaml

• Remote URLs: https://config.example.com/qpoint.yaml

Remote configurations are automatically cached locally and support reload functionality via SIGHUP.

TLS Probes Available

Probe	Description
openssl	Monitor OpenSSL traffic
gotls	Monitor Go TLS traffic
nodetls	Monitor Node.js TLS traffic
javassl	Monitor Java SSL/TLS traffic

To monitor multiple libraries, combine them with commas (no spaces):

--tls-probes=openssl,gotls,javassl

DevTools Interactive Debugging

The --enable-dev-tools flag enables a browser-based interface for real-time HTTP/S traffic inspection. See the DevTools Guide for complete documentation including:

• Quick start with demo mode

• SSH tunnel setup for remote servers

• Use cases and troubleshooting workflows

• Screenshots and visual walkthrough