You are browsing documentation for an outdated version. See the latest documentation here.
Dynamic Log Level Updates
You can change the log level of Kong Gateway dynamically, without restarting Kong Gateway, using the Admin API. This set of endpoints can be protected using RBAC and changes in log level are reflected in the audit log.
The log level change is propagated to all NGINX worker nodes, including the newly spawned workers.
Be careful when changing the log level of a node to
debug
in a production environment, because the disk could fill up quickly. As soon as the debug logging finishes, revert back to a higher level such asnotice
.
View current log level
To view the log level of an individual node, issue a GET
request passing the desired node
as a path parameter:
curl --request GET \
--url http://localhost:8001/debug/node/log-level/
If you have the appropriate permissions, this request returns information about your current log level:
{
"message": "log level: notice"
}
It is currently not possible to change the log level of the data plane or DB-less nodes.
Modify the log level for an individual Kong Gateway node
To change the log level of an individual node, issue a PUT
request passing the desired node
and log-level
as path parameters:
curl --request PUT \
--url http://localhost:8001/debug/node/log-level/notice
If you have the appropriate permissions and the request is successful, you receive a 200
response code and the following response body:
{
"message": "log level changed"
}
Change the log level of the Kong Gateway cluster
To change the log level of every node in your cluster, issue a PUT
request with the desired log-level
specified as a path parameter:
curl --request PUT \
--url http://localhost:59191/debug/cluster/log-level/notice
If you have the appropriate permissions and the request is successful, you receive a 200
response code and the following response body:
{
"message": "log level changed"
}
Manage new nodes in the cluster
To ensure that the log level of new nodes that are added to the cluster remain in sync the other nodes in the cluster, change the log_level
entry in kong.conf
to KONG_LOG_LEVEL
. This setting allows new nodes to join the cluster with the same log level as all existing nodes.
Change the log level of all control plane Kong Gateway nodes
To change the log level of the control plane nodes in your cluster, issue a PUT
request with the desired log-level
specified as a path parameter:
curl --request PUT \
--url http://localhost:59191/debug/cluster/control-planes-nodes/log-level/notice
If you have the appropriate permissions and the request is successful, you receive a 200
response code and the following response body:
{
"message": "log level changed"
}