Set Node Log Level of All Nodes

Change the log level of all nodes in a cluster.

See the NGINX docs for a list of accepted values.

It’s currently not possible to change the log level of DP and DB-less nodes.

Currently, when a user dynamically changes the log level for the entire cluster, if a new node joins a cluster the new node will run at the previous log level, not at the log level that was previously set dynamically for the entire cluster.

put

Path Parameters

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

log_levelstringrequired

Log levels are set in Kong’s configuration. Log levels increase in order of their severity

Allowed values:infonoticewarnerrorcrit

Example:warn

Response

200 application/json

OK

messagestring

A message containing information about the log level

Example:log level changed

put/runtime-groups/{runtimeGroupId}/core-entities/debug/cluster/log-level/{log_level}
 
200 application/json

Get a Node Log Level of A Node

Retrieve the current log level of a node.

See the NGINX documentation for the list of possible return values.

get

Query Parameters

offsetstring

Offset from which to return the next set of resources. Use the value of the ‘offset’ field from the response of a list operation as input here to paginate through all the resources

sizeinteger

Number of resources to be returned.

Default:100

>= 1<= 1000

tagsstring

A list of tags to filter the list of resources on. Multiple tags can be concatenated using ‘,’ to mean AND or using ‘/’ to mean OR.

Example:tag1,tag2

Path Parameters

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Response

200 application/json

OK

messagestring

A message containing the current log level of the node.

Example:log level: debug

get/runtime-groups/{runtimeGroupId}/core-entities/debug/node/log-level
 
200 application/json

Set log level of a single node

Change the log level of a node.

See the NGINX documentation for the list of possible return values.

put

Path Parameters

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

log_levelstringrequired

Log levels are set in Kong’s configuration. Log levels increase in order of their severity

Allowed values:infonoticewarnerrorcrit

Example:warn

Response

200 application/json

OK

messagestring

A message confirming the log level change

Example:log level changed

put/runtime-groups/{runtimeGroupId}/core-entities/debug/node/log-level/{log_level}
 
200 application/json

Targets

Target routes

List all Targets associated with an Upstream

List all Targets associated with a an Upstream

get

Query Parameters

sizeinteger

Number of resources to be returned.

Default:100

>= 1<= 1000

offsetstring

Offset from which to return the next set of resources. Use the value of the ‘offset’ field from the response of a list operation as input here to paginate through all the resources

tagsstring

A list of tags to filter the list of resources on. Multiple tags can be concatenated using ‘,’ to mean AND or using ‘/’ to mean OR.

Example:tag1,tag2

Path Parameters

upstream_idstringrequired

ID or name of the related Upstream

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Response

200 application/json

A successful response listing Targets

Target

A target is an ip address/hostname with a port that identifies an instance of a backend service. Every upstream can have many targets, and the targets can be dynamically added, modified, or deleted. Changes take effect on the fly. To disable a target, post a new one with weight=0; alternatively, use the DELETE convenience method to accomplish the same. The current target object definition is the one with the latest created_at.

created_atnumber

Unix epoch when the resource was created.

Example:1422386534

updated_atinteger

Unix epoch when the resource was last updated.

Example:1422386534

idstring

The unique identifier or the name of the upstream for which to update the target.

Example:173a6cee-90d1-40a7-89cf-0329eca780a6

tagsarray[string]

An optional set of strings associated with the Target for grouping and filtering.

targetstring

The target address (ip or hostname) and port. If the hostname resolves to an SRV record, the port value will be overridden by the value from the DNS record.

upstreamobject

The unique identifier or the name of the upstream for which to update the target.

* Additional properties are NOT allowed.
Show Child Parameters
weightinteger

The weight this target gets within the upstream loadbalancer (0-65535). If the hostname resolves to an SRV record, the weight value will be overridden by the value from the DNS record.

Default:100

Example:100

get/runtime-groups/{runtimeGroupId}/core-entities/upstreams/{upstream_id}/targets
 
200 application/json