When Benthos runs it kicks off an HTTP server that provides a few generally useful endpoints and is also where configured components such as the
http_server input and output can register their own endpoints if they don't require their own host/port.
The configuration for this server lives under the
http namespace, with the following default values:
http:address: 0.0.0.0:4195enabled: trueroot_path: /benthosdebug_endpoints: falsecert_file: ""key_file: ""cors:enabled: falseallowed_origins: 
enabled can be set to
false in order to disable the server.
root_path specifies a general prefix for all endpoints, this can help isolate the service endpoints when using a reverse proxy with other shared services. All endpoints will still be registered at the root as well as behind the prefix, e.g. with a
root_path set to
/foo the endpoint
/version will be accessible from both
By default Benthos will serve traffic over HTTP. In order to enforce TLS and serve traffic exclusively over HTTPS you must provide a
key_file path in your config, which point to a file containing a certificate and a matching private key for the server respectively.
If the certificate is signed by a certificate authority, the
cert_file should be the concatenation of the server's certificate, any intermediates, and the CA's certificate.
The following endpoints will be generally available when the HTTP server is enabled:
/versionprovides version info.
/pingcan be used as a liveness probe as it always returns a 200.
/readycan be used as a readiness probe as it serves a 200 only when both the input and output are connected, otherwise a 503 is returned.
/statsboth provide metrics when the metrics type is either
/endpointsprovides a JSON object containing a list of available endpoints, including those registered by configured components.
In order to serve Cross-Origin Resource Sharing headers, which instruct browsers to allow CORS requests, set the subfield
A list of allowed origins to connect from. The literal value
* can be specified as a wildcard. Note
cors.enabled must be set to
true for this list to take effect.
debug_endpoints when set to
true prompts Benthos to register a few extra endpoints that can be useful for debugging performance or behavioral problems:
/debug/config/jsonreturns the loaded config as JSON.
/debug/config/yamlreturns the loaded config as YAML.
/debug/pprof/blockresponds with a pprof-formatted block profile.
/debug/pprof/heapresponds with a pprof-formatted heap profile.
/debug/pprof/mutexresponds with a pprof-formatted mutex profile.
/debug/pprof/profileresponds with a pprof-formatted cpu profile.
/debug/pprof/symbollooks up the program counters listed in the request, responding with a table mapping program counters to function names.
/debug/pprof/traceresponds with the execution trace in binary form. Tracing lasts for duration specified in seconds GET parameter, or for 1 second if not specified.
/debug/stackreturns a snapshot of the current service stack trace.