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-04 UTC."],[[["This documentation covers version 1.8 of Apigee hybrid, which is end-of-life, and users should upgrade to a newer version."],["MART logs, useful for troubleshooting, can be viewed using the `kubectl logs` command on the Kubernetes administration machine."],["Several error codes can occur in the MART logs, including `ROUTING_SERVICE_NOT_ENABLED`, `HYBRID_MART_SERVER_ENDPOINT_NOT_FOUND`, `HYBRID_AUTHN_AUTHZ_TOKEN_ERROR`, `MART_ENDPOINT_REQUIRED`, and `HTTPS_MART_ENDPOINT_REQUIRED`, each indicating specific issues."],["The `ROUTING_SERVICE_NOT_ENABLED` error indicates that the `routing.service.enable` setting is set to false, while `HTTPS_MART_ENDPOINT_REQUIRED` indicates that `mart.routing.https.validation.enable` is true but `features.mart.server.endpoint` does not use HTTPS."]]],[]]
