Common settings

HTTP API

Known issue. If an unknown route is accessed (e.g., /this-does-not-exist), the HTTP reply will respond as if the / route were used and print an HTML page with links to all exposed APIs. This response will have a 200 (OK) HTTP Status Code.

The following APIs are exposed by most applications:

• /: (EXPERIMENTAL) - Method GET. Returns an HTML page containing links to exposed APIs.

• /config: (EXPERIMENTAL)

  • Method GET. Prints the TOML representation of the config the application is currently using.

• /info: (EXPERIMENTAL)

  • Method GET. Prints a plaintext representation of general information about the application. Amongst others, the information includes version, process ID, and user/group IDs.

• /log/level: (EXPERIMENTAL)

  • Method GET: Returns the current logging level, in JSON.

  • Method PUT: Sets the current logging level. Either JSON or URL encoded request body is supported.For example, to set the logging level to debug run:

    curl -X PUT "http://172.20.1.3:30442/log/level" -d level=debug
    curl -X PUT "http://172.20.1.3:30442/log/level" -H "Content-Type: application/json" -d '{"level":"debug"}'
    

    If the content type is set to application/x-www-form-urlencoded (curl default), the endpoint expects a URL encoded request body. In all other cases, a JSON encoded request body is expected.

• /metrics:

  • Method GET: Returns the Prometheus metrics exposed by the application.

• /debug/pprof:

  • Serves runtime profiling data in the format expected by the pprof visualization tool. See net/http/pprof for details on usage.