OS Manuals

/usr/bin/diagd

python3.14 version of emissary

From py3.14-ambassador 3.10.0-r30 (os), captured 2026-11-05 by running diagd --help (exit 0). permalink

/usr/lib/python3.14/site-packages/ambassador_diag/diagd.py:45: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81.
  from pkg_resources import Requirement, resource_filename
Usage: diagd [OPTIONS] [SNAPSHOT_PATH] [BOOTSTRAP_PATH] [ADS_PATH]

  Run the diagnostic daemon.

  Arguments:

    SNAPSHOT_PATH     Path to directory in which to save configuration
    snapshots and dynamic secrets

    BOOTSTRAP_PATH     Path to which to write bootstrap Envoy configuration

    ADS_PATH     Path to which to write ADS Envoy configuration

Options:
  --config-path PATH            Optional configuration path to scan for
                                Ambassador YAML files
  --k8s                         If True, assume config_path contains
                                Kubernetes resources (only relevant with
                                config_path)
  --ambex-pid INTEGER           Optional PID to signal with HUP after updating
                                Envoy configuration  [default: 0]
  --kick TEXT                   Optional command to run after updating Envoy
                                configuration
  --banner-endpoint TEXT        Optional endpoint of extra banner to include
                                [default: http://127.0.0.1:8500/banner]
  --metrics-endpoint TEXT       Optional endpoint of extra prometheus metrics
                                to include  [default:
                                http://127.0.0.1:8500/metrics]
  --no-checks                   If True, don't do Envoy-cluster health
                                checking
  --no-envoy                    If True, don't interact with Envoy at all
  --reload                      If True, run Flask in debug mode for live
                                reloading
  --debug                       If True, do debug logging
  --dev-magic                   If True, override a bunch of things for
                                Datawire dev-loop stuff
  --verbose                     If True, do really verbose debug logging
  --workers INTEGER             Number of workers; default is based on the
                                number of CPUs present
  --host TEXT                   Interface on which to listen
  --port INTEGER                Port on which to listen  [default: -1]
  --notices PATH                Optional file to read for local notices
  --validation-retries INTEGER  Number of times to retry Envoy configuration
                                validation after a timeout  [default: 5]
  --allow-fs-commands           If true, allow CONFIG_FS to support
                                debug/testing commands
  --local-scout                 Don't talk to remote Scout at all; keep
                                everything purely local
  --report-action-keys          Report action keys when chiming
  --help                        Show this message and exit.
Options (21)
OptionDescriptionSource
--config-path PATHOptional configuration path to scan for Ambassador YAML fileshelp
--k8sIf True, assume config_path contains Kubernetes resources (only relevant with config_path)help
--ambex-pid INTEGEROptional PID to signal with HUP after updating Envoy configuration [default: 0]help
--kick TEXTOptional command to run after updating Envoy configurationhelp
--banner-endpoint TEXTOptional endpoint of extra banner to include [default: http://127.0.0.1:8500/banner]help
--metrics-endpoint TEXTOptional endpoint of extra prometheus metrics to include [default: http://127.0.0.1:8500/metrics]help
--no-checksIf True, don't do Envoy-cluster health checkinghelp
--no-envoyIf True, don't interact with Envoy at allhelp
--reloadIf True, run Flask in debug mode for live reloadinghelp
--debugIf True, do debug logginghelp
--dev-magicIf True, override a bunch of things for Datawire dev-loop stuffhelp
--verboseIf True, do really verbose debug logginghelp
--workers INTEGERNumber of workers;help
--host TEXTInterface on which to listenhelp
--port INTEGERPort on which to listen [default: -1]help
--notices PATHOptional file to read for local noticeshelp
--validation-retries INTEGERNumber of times to retry Envoy configuration validation after a timeout [default: 5]help
--allow-fs-commandsIf true, allow CONFIG_FS to support debug/testing commandshelp
--local-scoutDon't talk to remote Scout at all;help
--report-action-keysReport action keys when chiminghelp
--helpShow this message and exit.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.