Troubleshoot Runtime Instances
Out of sync runtime instance
Occasionally, a Kong Gateway runtime instance might get out of sync
with the Konnect control plane. If this happens, you will
see the status Out of sync
on the Runtime Instances page, meaning the control
plane can’t communicate with the instance.
Troubleshoot the issue using the following methods:
-
Ensure the runtime instance is running. If it’s not running, start it; if it is running, restart it.
Check the sync status in the Runtime Manager.
-
Check the logs of the runtime that’s appearing as
Out of sync
. The default directory for Kong Gateway logs is/usr/local/kong/logs
.If you find any of the following errors:
- Runtime instance failed to connect to the control plane.
- Runtime instance failed to ping the control plane.
- Runtime instance failed to receive a ping response from the control plane.
You may have an issue on the host network where the instance resides. Diagnose and resolve the issue, then restart the instance and check the sync status in the Runtime Manager.
-
If the logs show a license issue, contact Kong Support.
If you are unable to resolve sync issues using the above methods, contact Kong Support.
Missing functionality
If a Konnect feature isn’t working on your runtime instance, the version may be out of date.
Verify that your instance versions are up to date:
-
Open
Runtime Manager, then open your runtime group.
-
Click + Add runtime instance and check the Kong Gateway version in the code block. This is the version that the Konnect control plane is running.
-
Return to the runtime instances page.
-
Check the runtime instance versions in the table. If you see an instance running an older version of Kong Gateway, your runtime instance may need upgrading.
If your version is up to date but the feature still isn’t working, contact Kong Support.
Version compatibility
We recommend running one major version (2.x or 3.x) of a runtime instance per runtime group, unless you are in the middle of version upgrades to the data plane.
If you mix major runtime instance versions, the control plane will support the least common subset of configurations across all the versions connected to the Konnect control plane. For example, if you are running 2.8.1.3 on one runtime instance and 3.0.0.0 on another, the control plane will only push configurations that can be used by the 2.8.1.3 runtime instance.
If you experience compatibility errors, upgrade your data planes to match the version of the highest-versioned runtime instance in your runtime group.
Possible compatibility errors:
Error code | Severity | Description | Resolution | References |
---|---|---|---|---|
D100 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D101 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D102 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D103 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D104 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D105 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D106 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D107 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D108 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D109 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D110 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D111 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D112 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D113 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D114 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D115 |
warning |
N/A |
N/A |
|
D116 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D118 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D119 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D120 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D121 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D122 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D123 |
error |
It seems you are using Konnect Developer Portal with Kong Gateway.
For the Developer Portal’s application registration feature to work correctly,
|
Please upgrade Kong Gateway to version |
Not applicable |
D124 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D125 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D126 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D127 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D128 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D129 |
error |
Konnect cloud’s Developer Portal’s application registration workflow requires features introduced in Kong Gateway 3.0. Some features of the Developer Portal are not working as intended. |
Please upgrade Kong Gateway to version |
|
D130 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D131 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D132 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D133 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D134 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D135 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D136 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D137 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D138 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D139 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D140 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D141 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D142 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D143 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D144 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D145 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D146 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D147 |
error |
The |
Please upgrade Kong Gateway to version |
|
D148 |
error |
As part of the |
Please upgrade Kong Gateway to version |
|
D149 |
error |
As part of the |
Please upgrade Kong Gateway to version |
|
D150 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D151 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D152 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D153 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D154 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D156 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D157 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D158 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D159 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D160 |
error |
For the |
Please remove these fields from the plugin configuration. |
|
D161 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D162 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D163 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D164 |
error |
For the |
Please remove these fields from the plugin configuration. |
|
D165 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D166 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
D167 |
error |
For the |
Unset the
|
|
D168 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
D169 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D170 |
error |
For the |
Please upgrade Kong Gateway to version |
|
D171 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P101 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P102 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P103 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P104 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P105 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P106 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P107 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P108 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P109 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P110 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P111 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P112 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P113 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P114 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P115 |
error |
Plugin |
Please upgrade Kong Gateway to version |
|
P116 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P117 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P118 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P119 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P120 |
error |
For the |
Please use |
|
P121 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P122 |
error |
For the |
Please update the configuration to use |
|
P123 |
error |
For the |
Please update the configuration to use |
|
P124 |
warning |
For the |
Please update the plugin configuration to use |
|
P125 |
warning |
For the |
Please update the plugin configuration to use |
|
P125 |
warning |
For the |
Please update the plugin configuration to use |
|
P126 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P127 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P128 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
P129 |
warning |
For the |
To define a regular expression based path for routing, please prefix the path with ~ character. |
|
P130 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P131 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P132 |
error |
For the |
Explicitly set the |
|
P133 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P134 |
error |
Tags that contain space characters ( |
Please upgrade Kong Gateway to version |
|
P135 |
error |
The |
Please upgrade Kong Gateway to version |
|
P136 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P137 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P138 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P139 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P140 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P141 |
error |
The |
Please upgrade Kong Gateway to version |
|
P142 |
error |
The |
Please upgrade Kong Gateway to version |
|
P144 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P145 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P146 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P147 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P148 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P149 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P150 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P151 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P152 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P153 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P154 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P155 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P156 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
P157 |
error |
For the |
Please remove these fields from the plugin configuration. |
|
P158 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
P159 |
error |
For the |
Please remove these fields from the plugin configuration. |
|
P160 |
warning |
For the |
Please upgrade Kong Gateway to version |
|
P161 |
error |
For the |
Please upgrade Kong Gateway to version |
|
P162 |
error |
For the |
Unset the |