To troubleshoot MART issues in Apigee hybrid, look at the log files. MART logs are
written to stdout/stderr and can be viewed using the kubectllogs command.
On the Kubernetes administration machine, execute the following command:
The following error codes can occur in the MART logs:
Error
Description
ROUTING_SERVICE_NOT_ENABLED
routing.RoutingServiceNotEnabled
Occurs when routing.service.enable is set to false
in this file in the MART pod:
/opt/apigee/edge-hybrid-mart-server/conf/routing-service.properties
HYBRID_MART_SERVER_ENDPOINT_NOT_FOUND
routing.HybridMARTServerEndpointNotFound
Occurs when the org does not have a value for the org property:
features.mart.server.endpoint
HYBRID_AUTHN_AUTHZ_TOKEN_ERROR
routing.HybridAuthNAuthZTokenError
Occurs when the AuthN-AuthZ service returns a non-200 response
code or an invalid token
MART_ENDPOINT_REQUIRED
organizations.MartEndpointRequired
Occurs when the org property features.mart.server.endpoint has
a null or empty value.
HTTPS_MART_ENDPOINT_REQUIRED
organizations.HttpsMartEndpointRequired
Occurs when the org property
features.mart.server.endpoint has a value starting with
"http://" when mart.routing.https.validation.enable is
set to true in this file in the MART pod:
/opt/apigee/edge-hybrid-mart-server/conf/routing-service.properties
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis documentation covers version 1.8 of Apigee hybrid, which is end-of-life, and users should upgrade to a newer version.\u003c/p\u003e\n"],["\u003cp\u003eMART logs, useful for troubleshooting, can be viewed using the \u003ccode\u003ekubectl logs\u003c/code\u003e command on the Kubernetes administration machine.\u003c/p\u003e\n"],["\u003cp\u003eSeveral error codes can occur in the MART logs, including \u003ccode\u003eROUTING_SERVICE_NOT_ENABLED\u003c/code\u003e, \u003ccode\u003eHYBRID_MART_SERVER_ENDPOINT_NOT_FOUND\u003c/code\u003e, \u003ccode\u003eHYBRID_AUTHN_AUTHZ_TOKEN_ERROR\u003c/code\u003e, \u003ccode\u003eMART_ENDPOINT_REQUIRED\u003c/code\u003e, and \u003ccode\u003eHTTPS_MART_ENDPOINT_REQUIRED\u003c/code\u003e, each indicating specific issues.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eROUTING_SERVICE_NOT_ENABLED\u003c/code\u003e error indicates that the \u003ccode\u003erouting.service.enable\u003c/code\u003e setting is set to false, while \u003ccode\u003eHTTPS_MART_ENDPOINT_REQUIRED\u003c/code\u003e indicates that \u003ccode\u003emart.routing.https.validation.enable\u003c/code\u003e is true but \u003ccode\u003efeatures.mart.server.endpoint\u003c/code\u003e does not use HTTPS.\u003c/p\u003e\n"]]],[],null,[]]
