Logs and troubleshooting

This table provides definitions of the status and error codes that the IoT Edge Connect logs in the connection monitoring topics.

Each status and error code consist of a letter and a number. The letter tells you the category where the status code or error belongs. These are the available categories:

C
Configuration
J
JSON Web Token (JWT)
M
Mutual Authentication
A
Authentication
F
Broker servers
D
Connection drop
ConnectsThis table presents the definition of the status code that the system logs in the following connection monitoring topic $SYS/monitor/con/connects.
Status code Status description Additional data
00 Successful connection. -
ErrorsThis table presents the definition of the error codes that the system may log in the following connection monitoring topic $SYS/monitor/con/errors.
Error code Error description Additional data Troubleshooting
C1 You haven't configured an authentication method for this namespace. - Check your IoT Edge Connect configuration.
C3 You haven't configured your namespace for the specified hostname. - Check your IoT Edge Connect configuration.
J1 No JWT present during the connection. - Check the following connection options of your MQTT client:
  • A password needs to have a JWT as its value.
  • A username needs to have a value.
J2 No JWT in the MQTT CONNECT or Websocket’s header. Specific parse error Check the validity of the token.
J3 A JWT signature is invalid. - Check if a JWT was sent with a correct private key.
J4 An unsupported signing algorithm for a JWT. Algorithm received Check if RS256 signing algorithm was used to encrypt the JWT.
J5 A JWT has expired. Expiration time Check the JWT expiration date. It can't be set to the past date.
J6 The nbf claim in the JWT doesn’t allow this token to be processed. Start time Verify your JWT's nbf claim.
J7 You haven't passed any client ID claim in a JWT. - Check if the token has an ID claim.

Check if the client ID field isn't empty.

J8 You haven't passed any authorization group claim in a JWT. - Check if the token has an authorization group claim.

Check if the authorization group claim isn't empty.

M1 Client certificate didn't pass validation. Validation error -
M2 You haven't passed any client ID claim in the client certificate. - Check if the certificate has an ID claim.

Check if the Client ID claim isn't empty.

M3 You haven't passed any authorization group claim in the client certificate. - Check if correct authorization group was passed during the connection.

Check if the correct authorization group was passed in the certificate.

M4 Your mutual authentication behavior failed to include authorization groups. - Contact technical support.
M5 Your mutual authentication behavior failed to include client ID. - Contact technical support.
A1 Client ID in MQTT Connect settings is different from the one in the JWT set as a password for the MQTT connection. Client ID received in MQTT Connect Check if the correct client ID was passed during the connection.

Check if the correct client ID was passed.

Check the client ID in the JWT.

A3 The system can't validate the client ID you sent. Specific parse error Consult the parse error for more details.
A4 The system can't use the authorization groups you sent. Specific parse error Consult the parse error for more details.
DropsThis table presents the definition of the status codes that the system may log in the following connection monitoring topic $SYS/monitor/con/drops.
Status code Status description Additional data
D2 Publish to an unauthorized topic. Name of the topic
D5 Client time-out. The client hasn't sent a ping request within the set keep alive period. -