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-26 UTC."],[[["\u003cp\u003eThis documentation pertains to version 1.10 of the Apigee hybrid system, with information on other versions available via a link.\u003c/p\u003e\n"],["\u003cp\u003eMART logs, essential for troubleshooting, are accessible via the \u003ccode\u003ekubectl logs\u003c/code\u003e command on the Kubernetes administration machine.\u003c/p\u003e\n"],["\u003cp\u003eSeveral error codes related to routing and server configurations can occur within the MART logs, each with a specific meaning and potential resolution, as defined in the provided table.\u003c/p\u003e\n"],["\u003cp\u003eOne can view information about the logging process on Apigee Hybrid, by clicking on the link provided.\u003c/p\u003e\n"]]],[],null,["# MART logs\n\n| You are currently viewing version 1.10 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nTo troubleshoot MART issues in Apigee hybrid, look at the log files. MART logs are\nwritten to stdout/stderr and can be viewed using the [`kubectl`](https://kubernetes.io/docs/reference/kubectl/overview/) `logs` command.\n\nOn the Kubernetes administration machine, execute the following command: \n\n```scdoc\nkubectl logs pod_name -n namespace\n```\n\nSee also [Logging](/apigee/docs/hybrid/v1.10/logging) for details.\n\n### MART error codes\n\nThe following error codes can occur in the MART logs:"]]
